Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Administering eMail Server

Logging on to the Administration Tool and OOMGR

Using the Administration Tool Graphical User Interface

Starting the Administration Tool GUI

Navigating in the Administration Tool GUI

Using the Administration Tool Command-Line Interface

Starting the Administration Tool Command-Line Interface

Guidelines for Using the Administration Tool Command-Line Interface

Example Tasks Using the Administration Tool Command-Line Interface

Administration Tasks Not Available in the Administration Tool

Using OOMGR

Starting OOMGR

OOMGR Command Guidelines

Basic OOMGR Commands

Creating an OOMGR Script File

Running a Script File

Managing Text-Based Configuration Files

Managing Administrative Privileges

Contacting Oracle Support Services

2 Configuration Checklist

Pre-Configuration Tasks (Required)

Single-Node Installation

Three-Tier Installation with Separate Protocol Servers (Optional)

Member Node Installation (Optional)

3 ESPrefs Self Service Utility

Logging into the Self Service Utility Pages.

Using the Preferences Page

Using the Rules Setting Page

Using the Distribution List Page

4 Managing Nodes

Manually Initializing a Node

Steps for Manually Initializing a Node

Renaming a Node

Steps for Renaming a Node

Deleting a Node

Prerequisites to Deleting a Node

Steps for Deleting a Node

Moving the SCN

Steps for Moving the SCN

Moving a DCN

Prerequisites to Moving a DCN

Steps for Moving a DCN

Displaying Local Node Information

Steps for Displaying Local Node Information

Changing a Node's Time Zone Value (GMT Offset)

Steps for Changing a Node's Time Zone Value (GMT Offset)

GMT Deviations

Changing a Node's Default Quota

Steps for Changing a Node's Default Quota

Changing a Node's Debug Value

Steps for Changing a Node's Debug Value

Changing a Node's State

Steps for Changing a Node's State

5 Managing Domains

Creating a Domain or Subdomain

Prerequisites to Creating a Subdomain

Steps for Creating a Subdomain

Parameters for Creating a Subdomain

Guidelines for Creating a Subdomain

Changing Automatic Node Initialization

Steps for Changing Automatic Node Initialization

Subscribing a Node to a Domain

Steps for Subscribing a Node to a Domain

Unsubscribing a Node from a Domain

Prerequisites to Unsubscribing a Node from a Domain

Deleting a Domain

Prerequisites to Deleting a Domain

Steps for Deleting a Domain

Guidelines for Deleting a Domain

Merging Two Domains

Prerequisites to Merging Two Domains

Steps for Merging Two Domains

Guidelines for Merging Two Domains

6 Managing Communities

Creating a Community

Steps for Creating a Community

Parameters for Creating a Community

Guidelines for Creating a Community

Subscribing a Node to a Community

Steps for Subscribing a Node to a Community

Guidelines for Subscribing a Node to a Community

Creating a Message Delivery Route for a Community

Steps for Creating a Message Delivery Route for a Community

Parameters for Creating a Message Delivery Route for a Community

Guidelines for Creating a Message Delivery Route for a Community

Displaying Message Delivery Route Information

Steps for Displaying Message Delivery Route Information

Renaming a Community

Steps for Renaming a Community

Unsubscribing a Node from a Community

Prerequisites to Unsubscribing a Node from a Community

Steps for Unsubscribing a Node from a Community

Guidelines for Unsubscribing a Node from a Community

Deleting a Community

Prerequisites to Deleting a Community

Steps for Deleting a Community

Merging Two Communities

Steps for Merging Two Communities

Guidelines for Merging Two Communities

Assigning Cost to a Node

Guidelines for Assigning Cost to a Node

7 Managing the SMTP Gateway and Sendmail

Creating an SMTP Gateway

Steps for Creating an SMTP Gateway

Creating the SMTP Gateway Configuration File

Prerequisites to Creating the SMTP Gateway Configuration File

Steps for Creating the SMTP Gateway Configuration File

Registering the SMTP Gateway with Sendmail

Prerequisites to Registering the SMTP Gateway with Sendmail

Steps for Registering the SMTP Gateway with Sendmail

Creating Aliases to Redirect Incoming Mail to the SMTP Gateway

Creating Gateway Rewriting Rules

Steps for Creating Gateway Rewriting Rules

Parameters for Creating Gateway Rewriting Rules

Guidelines for Creating Gateway Rewriting Rules

Configuring the Gateway for Multibyte Support

Specifying the Language to Support

Variables for Configuring the Gateway for Multibyte Support

Specifying the Character Set and Encoding Types

Supported Languages and Character Sets

Configuring Multiple SMTP Gateways

Removing (Deregistering) an SMTP/MIME Gateway

Steps for Removing (Deregistering) an SMTP/MIME Gateway

Storing Messages Encrypted with S/MIME

Rejecting Incoming Spam Messages

Steps for Rejecting Incoming Spam Messages

Preventing Use of the Server as a Mail Relay

Steps for Preventing Use of the Server as a Mail Relay

Configuring Sendmail for to Check for Viruses

8 Managing MIME Attachment Types

Creating an Attachment Type

Steps for Creating an Attachment Type

Parameters for Creating an Attachment Type

Creating a MIME Attachment Map

Prerequisites to Creating a MIME Attachment Map

Steps for Creating a MIME Attachment Map

Default MIME Attachment Type Mappings

Updating a MIME Attachment Map

Steps for Updating a MIME Attachment Map

Mapping MIME Attachment Types Using Converters

9 Managing Processes

Displaying the Guardian Process Status

Steps for Displaying the Guardian Process Status

Starting the Guardian Process

Prerequisites to Starting the Guardian Process

Steps for Starting the Guardian Process

Registering a New Process

Steps for Registering a New Process

Starting a Registered Process

Prerequisites to Starting a Registered Process

Steps for Staring a Registered Process

Displaying Process Status Information

Steps for Displaying Process Status Information

Displaying Database Shadow Processes

Steps for Displaying Database Shadow Processes

Parameters for Displaying Database Shadow Processes

Removing Database Shadow Processes

Steps for Removing Database Shadow Processes

Refreshing a Process

Prerequisites to Refreshing a Process

Steps for Refreshing a Process

Removing a Registered Process

Steps for Removing a Registered Process

Shutting Down a Registered Process

Prerequisites to Shutting Down a Registered Process

Steps for Shuttung Down a Registered Process

Shutting Down the Guardian Process

Prerequisites to Shutting Down the Guardian Process

Steps for Shutting Down a Guardian Process

Displaying Process Parameters

Steps for Displaying Process Parameters

Modifying a Default Process Parameter

Steps for Modifying a Default Process Parameter

Setting a Parameter for a Registered Process

Steps for Setting a Parameter for a Registered Process

Reverting a Registered Parameter to the Default Value

Steps for Reverting a Registered Parameter to the Default Value

Modifying Process Properties

Steps for Modifying Process Properties

Creating a Time Slice in a Process Default Schedule

Steps for Changing a Time Slice in a Process Default Schedule

Guidelines for Creating a Time Slice in a Process Default Schedule

Modifying a Time Slice in a Process Default Schedule

Steps for Modifying a Time Slice in a Process Default Schedule

Guidelines for Modifying a Time Slice in a Process Default Schedule

Example of Modifying a Time Slice in a Process Default Schedule

Removing a Time Slice from a Process Default Schedule

Steps for Removing a Time Slice from a Process Default Schedule

Guidelines for Removing a Time Slice from a Process Default Schedule

Overriding a Default Time Slice for a Process Instance Schedule

Steps for Overriding a Default Time Slice for a Process Instance Schedule

Guidelines for Overriding a Default Time Slice for a Process Instance Schedule

Modifying a Time Slice for a Process Instance Schedule

Steps for Modifying a Time Slice for a Process Instance Schedule

Guidelines for Modifying a Time Slice for a Process Instance Schedule

Example of Modifying a Time Slice for a Process Instance Schedule

Reverting a Process Instance Time Slice to the Default Value

Steps for Reverting a Process Instance Time Slice to the Default Value

Guidelines for Reverting a Process Instance Time Slice to the Default Value

10 Managing Protocol Server Processes

Configuring the Protocol Server Database Connections

Steps for Configuring the Protocol Server Database Connections

Variables for Configuring the Protocol Server Database Connections

Example of Configuring the Protocol Server Database Connections

Specifying Gateways for the Protocol Servers

Steps for Specifying Gateways for the Protocol Servers

Parameters for Specifying Gateways for the Protocol Servers

Configuring Protocol Servers for SSL

Steps for Configuring Protocol Servers for SSL

Obtaining an SSL Trusted Certificate

Steps for Obtaining an SSL Trusted Certificate

11 Process Parameter Reference

Common Process Parameters

Common Process Parameters

Schedule Parameters

Gateway Process Parameters

LDAP Server Process Parameters

Forward Synchronization

Forward Synchronization Parameters

Reverse Synchronization Parameters

Messaging Server Process Parameters

Collector Process Parameters

Guardian Process Parameters

Monitor Process Parameters

Postman Process Parameters

Replicator Process Parameters

Statistics Process Parameters

Protocol Server Process Parameters

IMAP4SRV Process Parameters (IMAP4-Specific)

IOLISTENER Process Parameters

POP3SRV Process Parameters (POP3-Specific)

SPS Process Parameters (Common to both IMAP4 and POP3)

12 Managing Shared Folders

Configuring the Shared Folder Hierarchy

Steps for Configuring the Shared Folder Hierarchy

Adding a Shared Folder

Prerequisites to Adding a Shared Folder

Steps for Adding a Shared Folder

Guidelines for Adding a Shared Folder

Replicating Shared Folders Manually

Steps for Replicating Shared Folders Manually

Displaying Shared Folder Access Privileges

Steps for Displaying Shared Folder Access Privileges

Granting Access Privileges

Steps for Granting Access Privileges

Guidelines for Granting Access Privileges

Revoking Access Privileges

Steps for Revoking Access Privileges

Guidelines for Revoking Access Privileges

Shared Folder Class Attributes

Shared Folder Access Privileges

13 Managing Directory Information

Displaying a Directory Entry

Steps for Displaying a Directory Entry

Creating an eMail Server User Account

Steps for Creating an eMail Server User Account

Guidelines for Creating an eMail Server User Account

Creating a User for a Foreign E-mail System

Steps for Creating a User for a Foreign E-mail System

Guidelines for Creating a User for a Foreign E-mail System

Creating a User Without E-mail

Steps for Creating a User Without E-mail

Guidelines for Creating a User Without E-mail

Setting a User's Password

Steps for Setting a User's Password

Guidelines for Setting a User's Password

Creating a Location

Steps for Creating a Location

Guidelines for Creating a Location

Creating a Room Entry

Steps for Creating a Room Entry

Guidelines for Creating a Room Entry

Creating an Organization Entry

Steps for Creating an Organization Entry

Guidelines for Creating an Organization Entry

Creating a Role Entry

Steps for Creating a Role Entry

Guidelines for Creating a Role Entry

Creating an Equipment Entry

Steps for Creating an Equipment Entry

Guidelines for Creating an Equipment Entry

Creating a Public Alias

Steps for Creating a Public Alias

Guidelines for Creating a Public Alias

Creating a Public Distribution List

Steps for Creating a Public Distribution List

Guidelines for Creating a Public Distribution List

Creating a Public Template

Prerequisites to Creating a Public Template

Steps for Creating a Public Template

Guidelines for Creating a Public Template

Displaying Access Privileges

Steps for Displaying Access Privileges

Granting Access Privileges

Steps for Granting Access Privileges

Parameters for Granting Access Privileges

Guidelines for Granting Access Privileges

Revoking Access Privileges

Steps for Revoking Access Privileges

Guidelines for Revoking Access Privileges

Deleting a Directory Entry

Steps for Deleting a Directory Entry

Migrating Directory Accounts to Another Node or Domain

Steps for Migrating Directory Accounts to Another Node or Domain

14 Directory Class Attribute Reference

Equipment Class Attributes

Location Class Attributes

Organization Class Attributes

Person Class Attributes

Public Alias Class Attributes

Public Distribution List Class Attributes

Role Class Attributes

Room Class Attributes

15 Managing Replication

Checking Replicator Status

Steps for Checking Replicator Status

Troubleshooting for Checking Replicator Status

Understanding the Replicator Process Status

Manually Replicating Directory Data

Replicating by Manually Sending a Replicator Package to a Node

Replicating by Manually Transferring a File

Resetting Replicator Package Numbering

Steps for Resetting Replicator Package Numbering

16 Managing Queues

Displaying a List of Message Queues on a Node

Steps for Displaying a List of Message Queues on a Node

Displaying a List of Messages in a Queue

Prerequisites to Displaying a List of Messages in a Queue

Steps for Displaying a List of Messages in a Queue

Suspending a Message

Steps for Suspending a Message

Restarting a Suspended Message

Steps for Restarting a Suspended Message

Removing (Bouncing) a Message

Prerequisites to Removing (Bouncing) a Message

Steps for Removing (Bouncing) a Message

Emptying the Dead Message Queue

Rerouting a Queue

Prerequisites to Rerouting a Queue

Steps for Rerouting a Queue

Suspending a Queue

Prerequisites to Suspending a Queue

Steps for Suspending a Queue

Restarting a Suspended Queue

Steps for Restarting a Suspended Queue

17 Monitoring and Troubleshooting

Using Server Process Logs

Finding the Log Files

Setting the Log Level

Reading the Log Files

Using the OEM eMail Server Capacity Monitoring Pack

Using Monitoring Reports

Monitoring Messages in the ORAPOST Account

Running the Monitor Tests and Statistics Tasks

Steps for Running the Monitor Tests and Statistics Tasks

Activating the Monitor Tests

Prerequisites to Activating the Monitor Tests

Steps for Activating the Monitor Tests

Specifying the Tasks for the Statistics Process

Steps for Specifying the Tasks for the Statistics Process

Task Names of the Statistics Process

Deactivating a Monitor Test

Steps for Deactivating a Monitor Test

Checking All Tablespaces on a Node

Steps for Checking All Tablespaces on a Node

Checking Space Used by an Individual User

Steps for Checking Space Used by an Individual User

Monitoring Protocol Server Processes

Prerequisites to Monitoring Protocol Server Processes

Steps for Monitoring Protocol Server Processes

Parameters for Monitoring Protocol Server Processes

Understanding the Probe Results

Unlocking the User's INBOX

Steps for Unlocking the User's INBOX

18 Monitor Test Reference

Configuration Tests

Sample Reports Created by Configuration Tests

Database Space Tests

Sample Reports Created by Database Space Tests

Directory Service Tests

Sample Reports Created by Directory Service Tests

Message Flow Tests

Sample Reports Created by Message Flow Tests

Process Tests

Sample Reports Created by Process Tests

19 Error Codes and Messages

Messaging Server Messages

Public/Shared Folder Error Messages

IMAP Messages

POP3 Messages

SMTP/MIME Gateway Messages

SSL Messages

Collector Process Messages

Guardian Process Messages

Postman Error Messages

Monitor Process Messages

20 eMail Server Scripts

Scripts for Message-Billing Data Collection

Activating Billing Information for Messages Sent

Activating Billing Information for Messages Received

Viewing Billing Information for Messages Sent and Received

Parameters for Billing

System Wide Virus Removal Script

Bounce Back Messages Script (over recipient quota)

21 Administration Tool Command Line Reference

22 IOFCMGR Command Reference

23 MIME Text Encoding and Decoding

Configuring the Method for Encoding MIME Content

Encoding 8-bit Data

Defining Non-ASCII Character Sets

Encoding Non-ASCII Character Sets

External Programs for Content Transfer Encoding/Decoding

When an Encoder Fails

When a Decoder Fails

Configuring Messages That Are Not MIME-Compliant

Encoding Data in Outbound Messages

Decoding Data in Inbound Messages

Index