Chapter 6   Administering the NetMail Service

This chapter describes how to administer the NetMail service.

This chapter contains these sections:

• Overview of the NetMail Service
• Administering the NetMail Service

Overview of the NetMail Service

---

NetMail service implements the NetMail (Java™) and NetMail Lite email clients. These clients work with standard IMAP and SMTP servers. NetMail allows users to access one or more mail servers to read, compose and delete emails, and create, access and delete folders.

In Sun™ ONE Portal Server 6.0, you define and manage the NetMail service through the iPlanet™ Directory Server Access Management Edition admin console. The NetMail service defines the service attributes and default values for the NetMail client for managing email messages and its configuration. You define and customize service attribute values for an organization and its users to control how the NetMail client behaves.

Administering the NetMail Service

---

This section provides the procedures to:

• Register the NetMail service
• Create the default Netmail service template
• Create a NetMail policy and assign it to users
• Modify NetMail service attributes




---

Note	When you create a new organization, you need to create and assign a NetMail policy for that organization. You do not need to do so for the sample portal as NetMail is already enabled by default.

---

To Register the NetMail Service

1. Log in to the iPlanet Directory Server Access Management Edition admin console as administrator.
2. Navigate to User Management by choosing View User Management.
3. Choose the organization for which you would like to register the NetMail service.
4. Choose Services from the Show menu.
5. Click Register in the navigation pane.

A list of available services displays in the data pane.

6. Click the check box for NetMail under Portal Server Configuration and click Register.

The NetMail service shows up in the Navigation pane as a registered service.

To Create the Default NetMail Service Template

After registering the NetMail service, you can provide the default NetMail values to all users in an organization by creating a template for the NetMail service.

1. Log in to the iPlanet Directory Server Access Management Edition admin console as administrator.
2. Navigate to User Management by choosing View User Management.
3. Choose the organization for which you would like to create the NetMail service template.
4. Choose Services from the Show menu.
5. Click the properties arrow next to NetMail in the navigation pane.
6. The following message appears in the data pane:

No template available for this service. Do you want to create it?

7. Click Create in the message box to create the template.

The NetMail attributes appear.

8. Make any changes to the NetMail attributes.

See Appendix D "NetMail Attributes," for information on the NetMail attributes.

9. Click Save to store the final values in the service template.

To Create and Assign a NetMail Policy to Users

After registering the NetMail service and creating a default service template, you enable all users in an organization to gain access to the NetMail service by creating a new policy and assigning it to users.

---

Note	When you create a new organization, you need to create and assign a NetMail policy for that organization. You do not need to do so for the sample portal or the default installed organization.

---

1. Log in to the iPlanet Directory Server Access Management Edition admin console as administrator.
2. Navigate to Policy Management by choosing View Policy Management.
3. Choose the organization for which you would like to create policy.
4. Choose Policies from the Show menu.

By default, Organizations is visible in the Show menu. All suborganizations configured, if any, will be visible below it. If creating the policy for a suborganization, choose the suborganization and then choose Policies from the Show menu.

5. Click New in the navigation pane.

Create Policy appears in the data pane.

6. Type the policy name and click NetMail from the Service menu.
7. Click Create to create the new policy.

The new policy appears in the navigation pane.

8. Click Add Rule and then Save the Policy.
9. To assign the policy to users, navigate to User Management by choosing View User Management.
10. Choose the appropriate organization.
11. Choose Policies from the Show menu.

If the organization already has policies assigned to it, they are displayed in the navigation pane. If the Assign Policies interface is not visible, click Assign and all unassigned policies will be displayed in the data pane.

12. Click the box next to the unassigned NetMail policy and click Assign to assign the policy to all users in the selected organization.

The NetMail policy appears in the navigation pane, and a message displays in the data pane that the policy has been assigned.

To Modify Netmail Service Attributes (Specific Organization)

You can customize the NetMail service by modifying the attributes for the service.

1. Log in to the iPlanet Directory Server Access Management Edition admin console as administrator.
2. Navigate to User Management by choosing View User Management.
3. Choose the organization.
4. Choose Services from the Show menu.
5. Click the properties arrow next to NetMail in the navigation pane.

A list of Netmail service attributes appears in the data pane.

6. Modify the service attribute values and then click Save to save the changes.

The changes affect only users in the selected organization.

See Appendix D "NetMail Attributes," for more information.

To Modify Netmail Service Attributes (All Organizations)

Occasionally, you need to modify the global NetMail service attribute values that affect all organizations that want to register for the Netmail service in the future.

1. Log in to the iPlanet Directory Server Access Management Edition admin console as administrator.
2. Navigate to Service Management by choosing View Service Management.
3. Click the properties arrow next to NetMail in the navigation pane.

A list of NetMail service attributes appears in the data pane.

4. Modify the service attribute values then click Save to save the changes.

The changes affect all organizations that register the NetMail service in the future.

To Configure NetMail Lite to Open a New Window

In the default configuration, if users click on the NetMail Lite link on the Desktop when they have NetMail Lite running and are composing a message, their current NetMail Lite window is replaced with a new instance of NetMail Lite and they lose the text in the message. To avoid this issue, you can configure NetMail Lite to open in a new window each time a user clicks on NetMail Lite link on the Desktop.

1. Click the properties arrow next to NetMail in the navigation pane.

A list of global NetMail service attributes appears in the data pane.

2. Log in to the iPlanet Directory Server Access Management Edition admin console as administrator.
3. Navigate to User Management by choosing View User Management.
4. Choose the organization.
5. Click the properties arrow next to Desktop in the navigation pane.

A list of Desktop service attributes appears in the data pane.

6. Click Channel and Container Management link in the data pane
7. Click the Edit link of App channel under Channels.
8. Click the Edit link of targets property.
9. Replace the NetMail Lite property with the following:

NetMail Lite| ^javascript:var nmServerURL = document.URL; nmDestURL =nmServerURL.split('dt')[0];nmAdjustedURL = nmDestURL +'NetMailServlet?nsid=newHTMLSession'; openAppURL(nmAdjustedURL,'_blank');return false;

10. Click Save.
11. Verify the change.

Log in as a test user within the organization. Access NetMail Lite and start composing a messag. Click the NetMail Lite link. A new window containing NetMail Lite should open.

Using the Remote Address Book (LDAP)

To enable the remote address book feature for NetMail, you configure the LDAP server list attribute in the NetMail service.

---

Note

The address book search capability enables users to search for names based on user specified text compared using the following criteria if supported by the search engine: containing, equal to, beginning with, ending with, and sounding like. The personal address book only supports searching by contain. If you add an LDAP address book, you will see these other options enabled.

---

1. Log in to the iPlanet Directory Server Access Management Edition admin console as administrator.
2. Navigate to User Management by choosing View User Management.
3. Choose the organization.
4. Choose Services from the Show menu.
5. Click the properties arrow next to NetMail in the navigation pane.

A list of NetMail service attributes appears in the data pane.

6. Modify the LDAP Server Details to Use in Address Book Search value. Each entry is a comma separated list of name="value" pairs where the valid names are:

• name—The name that is shown in the Address page of NetMail (default: none)
• server—The fully qualified domain name of the LDAP server (default: none)
• base—The distinguished name (DN) that is used to start the search (default: "")
• searchin—A comma separated list of attributes to look in (default: "cn,gn,sn")
• result—The attribute that contains the email address (default: "mail")
• filter—An additional LDAP filter to use for the search (default: ""). The syntax of the filter uses LDAP filter syntax.
• referral—Value defining whether to follow LDAP referrals. The default is "follow"; use "" to define not to follow referrals.

For example, to search the Sesta LDAP directory, use the following entry:

name="Sesta LDAP",server="ldap-server.sesta.com",base="dc=sesta,dc=com"

7. Click Save.