2
Provisioning

This chapter discusses how to administer Oracle Email domains and users.

This chapter contains the following topics:

• Managing Oracle Email
• Managing Domains
• Managing Users
• Managing Aliases

Managing Oracle Email

Note: You must have administrator privileges to perform e-mail management tasks. If you have administrator privileges, you will see the administration tab in the Oracle Webmail client.

To perform Oracle Email management tasks, you must navigate to the following URL:

http://machine_name:port/um/traffic_cop

Where:

• machine_name is the name of the machine on which Oracle Email is installed
• port is the Web Cache port number

Through the Oracle Webmail client, you can perform domain, user, list, alias, news, and policy management tasks by clicking on the appropriate tab.

Under the Overview tab, you can view what components are installed on the different middle tier hosts. To administer these components, click on the host links and you will be redirected to the Oracle Enterprise Manager.

Managing Domains

Domains identify e-mail addresses as being from a specific company. E-mail domains can have sub-domains that can be administered separately even if they are on the same system. The advantages to administering sub-domains on the same system separately are:

• Convenience in accommodating sub-domains with different maintenance schedules, which is typical for sub-domains in different geographic regions
• Ease of administering sub-domains with different default attributes, which is common for sub-domains belonging to different organizations

Using Oracle Webmail, you can perform domain management tasks, such as modifying default attributes for new users, managing domain settings, and creating domains.

Domain Attributes

Table 2-1 lists the different domain attributes:

Table 2-1 Domain Attributes

Attribute	Description	Acceptable Values	Default Value
Location in Public Namespace	Specifies the distinguished name of the LDAP container in Oracle Internet Directory, which contains all distribution lists in public namespace for client lookup	A valid distinguished name within the list server to which distribution lists are synchronized	None
Object Classes for Creation in Public Namespace	Contains the list of LDAP objectclasses used while creating the distribution lists in public namespace. The list of LDAP objectclasses must include the groupofnames or groupofuniquenames parameter		None
Naming Attribute for Creation in Public Namespace	Contains the naming attribute to be used while creating the distribution lists in public namespace		CN
Flashback Mail Recovery	Enables or disables flashback mail recovery for e-mail users. This attribute does not affect the flashback mail recovery capability for administrators using the PL/SQL interface	Enable or Disable	Disable

Creating Domains

Oracle Email domains are created through the Oracle Webmail client. The base domain is created automatically during the Oracle Collaboration Suite infrastructure installation. E-mail domain names can be different than the base domain. For example, you can create e-mail sub-domains of company.com named a.company.com, b.company.com, and c.company.com.

Perform the following steps to create additional domains:

1. Navigate to the Oracle Webmail client administration page.
2. Select Domain > Create Domain.
3. Select the name of the installation for which you want to create the new domain.
4. Select the parent domain from the drop down list.
5. Enter the new domain name in the corresponding field.
6. Click Submit to commit the changes or Cancel to return to the previous page.

Modifying Domain Settings

Note: Preferences modified for a domain apply only to entries created after the modifications. For example, if the default mail quota for the oracle.com domain is changed to 60MB, only users newly created in that domain have the new 60MB quota. Existing users in that domain retain their old mail quota.

Perform the following steps to modify domain settings:

1. Navigate to the Oracle Webmail client administration page.
2. Select Domain > Domain Settings.
3. Select the installation name from the drop down list.
4. Select the domain you want to modify.
5. Click Submit.
6. Modify the preferences you want to change.
7. Click Submit to commit the changes or Cancel to return to the previous page.

Managing Users

Using the Oracle Webmail client, you can perform user management tasks, such as adding, removing, and modifying e-mail users.

E-mail User Attributes

Table 2-2 lists the attributes for e-mail users:

Table 2-2 E-mail User Attributes

Attribute	Description
User ID	Specifies the user ID. This attribute is read-only and cannot be modified.
Mail Store	Specifies the database to be used as mail store for the user. This attribute is read-only and cannot be modified.
E-mail Quota	Specifies the e-mail quota of a mail user in bytes.
Additional Voice Quota	Specifies the additional quota for the voice mail user in bytes
User State	Defines the user as active or inactive. If User State is active, the user can receive and send e-mail; if inactive, the user cannot receive and send e-mail.
Forward E-mail Address	Stores the e-mail addresses for the auto forward feature.
Document Binary Search	Controls what is used for e-mail theme generation and e-mail formatting functions: only the text, or the complete contents of e-mail messages
Role	Defines the user as either a regular user, a system administrator, or a domain administrator.
Text Synchronization	Enables the user to have text search capability on message bodies.
Number of E-mail Display (Oracle Webmail)	Specifies the number of message headers displayed at one time on the Oracle Webmail client. For example, you can specify to display 20 messages at a time.
Mail User Index Type	Specifies if text indexing should be performed on only the e-mail text or both the e-mail and the attachment.
Domain Control ACI	Specifies whether the user is a system administrator, domain administrator, or regular user
Display All Headers (Oracle Webmail)	Specifies whether Oracle Webmail headers are displayed in detail.

Quota

There are two quota values that can be set for users: user-quota and voice-quota. When usage reaches user-quota, it means that the sum of e-mails and voice mails is equal to the user-quota value. Voice-quota is an additional buffer provided to users so that voice mail delivery is not affected when users reach their quota.

All e-mails and voice mails are delivered to users as long as they are under user-quota. Once users reach their user-quota, e-mails are held in the system and not delivered. In addition to stopped mail delivery, users cannot save new messages in the server folders when they reach user-quota. For example, saving a copy of outgoing messages to the Sent folder is not allowed. The IMAP server informs the client that the user is over quota when trying to save new outgoing mail.

However, voice mail delivery continues as long as total usage is under the user-quota plus voice-quota value. For example, if user-quota is 50MB and voice-quota is 20MB, e-mail delivery stops after the usage is 50MB, but voice mail delivery continues until user-quota and voice-quota reach 70MB.

When users clean up their accounts and are under the user-quota and user-quota plus voice-quota values, e-mail and voice mail delivery resume.

Adding E-mail Users

Note: A base user must exist in Oracle Internet Directory before an e-mail account can be created. If the intended e-mail user has no entry in the directory, a message displays with a link directing you to the directory's Delegated Administration Service page. Create the user entry there, and then the e-mail account can be created.

Perform the following steps to add e-mail users:

1. Navigate to the Oracle Webmail client administration page.
2. Select User > E-mail User Management > Add User.
3. Select the domain from the drop down list.
4. Enter the new user's ID in the User ID field.
5. Enter the base user domain.
6. Select the mail store from the drop down list.
7. Enter the e-mail quota in bytes in the corresponding field.
8. Select the new user's role from the drop down list.
9. Click Add.

Modifying E-mail User Attributes

Perform the following steps to modify an existing user's attributes:

1. Navigate to the Oracle Webmail client administration page.
2. Select User > E-mail User Management > Modify User.
3. Enter the user ID in the Search Criteria field.
4. Select the user's domain from the drop down list.
5. Click Go.
6. Modify the parameters you want to change.
7. Click Modify.

Setting Default New User Attributes

Perform the following steps to set the default attributes of new users in a particular domain. All new e-mail users have these attributes, which can be changed later.

1. Navigate to the Oracle Webmail client administration page.
2. Select Domain > Default New User.
3. Select the installation from the drop down list.
4. Select the domain you want to modify.
5. Click Submit.
6. Modify the attributes.
7. Click Submit to commit the changes or Cancel to return to the previous page.

Removing E-mail Users

Note: When a mail user is removed, any shared folders and public shared folders owned by that user are also deleted

Perform the following steps to remove individual e-mail users:

1. Navigate to the Oracle Webmail client administration page.
2. Select User > E-mail User Management > Remove User.
3. Enter the search criteria for the user you want to delete.
4. Select the domain to which the user belongs.
5. Click Go.
6. Select the user you want to delete.
7. Click Remove.

Managing Aliases

Aliases are shorter or more descriptive names you can use when sending messages to long user IDs or list names. Aliases are pointers that redirect messages to the intended receiver.

For example, if Jane Doe changes her name to Jane Roe, an alias can be created so that messages sent to her original account, [e-mail], are automatically redirected to her new account, [e-mail]. This alias prevents her from losing messages sent to her old user ID.

Using the Oracle Webmail client, you can create, modify, and delete aliases.

Alias Attributes

Table 2-3 lists the alias attributes:

Table 2-3 Alias Attributes

Attribute	Description	Acceptable Values	Default Value
Name	Specifies the name by which the alias is referred.	user ID, list, or alias	None
Target	Specifies the alias.	user ID, list, or alias	None
Description	Specifies the description of the alias.	Text string	None

Creating a New Alias

Perform the following steps to create a new alias.

1. Navigate to the Oracle Webmail client administration page.
2. Select Alias > Alias Management > Create a new alias.
3. Select the domain from the drop down list.
4. Click Go.
5. Enter the alias name.
6. Enter the alias target. A target can be a user ID, list, or another alias.
7. Enter the description.
8. Click Create.

Editing Alias Properties

Perform the following steps to edit properties of an existing alias:

1. Navigate to the Oracle Webmail client administration page.
2. Select Alias > Alias Management > Edit alias properties.
3. Enter the search criteria.
4. Select the domain from the drop down list.
5. Click Go.
6. Select the alias you want to modify.
7. Click Modify.
8. Modify the attributes you want to change.
9. Click Modify.

Deleting Aliases

Perform the following steps to delete an alias:

1. Navigate to the Oracle Webmail client administration page.
2. Select Alias > Alias Management > Delete alias(es).
3. Enter the search criteria for the alias you want to edit.
4. Select the domain from the drop down list.
5. Click Go.
6. Select the alias you want to delete.
7. Click Delete.