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 WebMail client.

To perform management tasks for Oracle Email, you must navigate to the following URL, substituting your site's e-mail machine_name and port and retaining the rest:

http://machine_name:port/um/traffic_cop

Using WebMail, 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

A domain brands your e-mail addresses as being from your company. An e-mail domain can have sub-domains, which can be administered separately even on the same system, with the following advantages:

• 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 WebMail, you can perform domain management tasks, such as modifying default attributes for new users or new lists, managing domain settings, and creating domains.

Domain Attributes

The following describes 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

Domains created through WebMail are Oracle Email domains. 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 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 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 WebMail, you can perform user management tasks, such as adding, removing, and modifying e-mail users.

E-mail User Attributes

The following table describes the attributes for e-mail users:

Table 2-2 E-mail User Attributes

Attribute	Description
User ID	This parameter specifies the user ID. This attribute is read-only and cannot be modified.
Mail Store	This parameter specifies the database to be used as mail store for the user. This attribute is read-only and cannot be modified.
E-mail Quota	This parameter specifies the e-mail quota of a mail user in bytes.
Additional Voice Quota	This parameter specifies the additional quota for the voice mail user in bytes
User State	This parameter 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	This parameter stores the e-mail addresses for the auto forward feature.
Document Binary Search	This parameter 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	This parameter defines the user as either a regular user, a system administrator, or a domain administrator.
Text Synchronization	This parameter enables the user to have text search capability on message bodies.
Number of E-mail Display (WebMail)	This parameter specifies the number of message headers displayed at one time on the WebMail client. For example, you can specify to display 20 messages at a time.
Mail User Index Type	This parameter specifies if text indexing should be performed on only the e-mail text or both the e-mail and the attachment.
Domain Control ACI	This parameter specifies whether the user is a system administrator, domain administrator, or regular user
Display All Headers (WebMail)	This parameter specifies whether WebMail headers are displayed in detail.

Quota

There are two quota values that can be set for a user: user-quota and voice-quota. All e-mails and voice mails are delivered to the user as long as the user is under user-quota. When user-quota is reached, all e-mails are held in the system and are not delivered to the user. However, voice mail delivery continues as long as the user's total usage is under user-quota plus voice-quota value. For example, if the user-quota is 50MB and the voice-quota is 20MB, e-mail delivery stops after the user's usage is 50MB but the voice mail delivery continues until the user reaches 70MB.

When the user cleans up the account and the usage is under user-quota plus voice-quota value, voice mail delivery starts again. When the usage is under user-quota, e-mail delivery starts again. It is important to note that both e-mails and voice mails contribute to user-quota calculations. When the usage reaches the user-quota, it means that the sum of e-mails and voice mails is equal to 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.

In addition to stopped mail delivery, users cannot save new messages in the server folders when user-quota is reached. 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.

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 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 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 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 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

An alias is a shorter or more descriptive name you can use when sending a message to a long user ID or list name. The message still reaches that original ID or list; the alias is like a pointer, effectively redirecting the message to the intended receiver.

For example, if Jane Doe changes her name to Jane Roe, you can create an alias so that mail sent to her original account, [e-mail], is automatically redirected to her new account, [e-mail] . This alias prevents her losing messages sent to her old user ID while she notifies senders of her new one.

WebMail enables you to create, modify, and delete aliases.

Alias Attributes

The following describes the alias attributes:

Table 2-3

Attribute	Description	Acceptable Values	Default Value
Name	This parameter specifies the name by which the alias is referred.	user ID, list, or alias	None
Target	This parameter specifies the alias.	user ID, list, or alias	None
Description	This parameter 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 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 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 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.