Sun Java System Messaging Server

This User Interface Reference will describe the tabs, buttons, and screens in the Administration Console. Topics covered in this chapter include:

General Messaging Services

This section describes the Administration Console interface elements that allow you to execute and perform general configuration of the services supported by Messaging Server. See Managing Servers with iPlanet Console for information on using Console to manage Messaging Server and other servers.

Tasks Tab

The Tasks tab allows you to quickly perform several typical Messaging Server administration tasks. The Tasks tab provides direct access to common tasks that may be less directly accessible through the Configuration tab.

Start/Stop services. Click this button to display a window (see General Tab) that allows you to start or stop any of the Messaging Server services.

View IMAP service logs. Click this button to display a form (see Log Files Content Tab) from which you can select, view, and search the contents of an IMAP log file.

View POP service logs. Click this button to display a form (see Log Files Content Tab) from which you can select, view, and search the contents of a POP log file.

View HTTP service logs. Click this button to display a form (see Log Files Content Tab) from which you can select, view, and search the contents of an HTTP log file.

View administration logs. Click this button to display a form (see Log Files Content Tab) from which you can select, view, and search the contents of a Messaging Server administration log file.

View default logs. Click this button to display a form (see Log Files Content Tab) from which you can select, view, and search the contents of a log file created by a Messaging Server service or utility other than one listed above.

Certificate Setup Wizard. Click this button to start the wizard that will take you thought the process of setting up encryption security (SSL) for this server.

Configuration Tab

The Configuration tab allows you to get to and configure services, as well as the message store and log files, of Messaging Server. You can perform many administration tasks from the Configuration tab.

In the left pane of the Configuration form, you can select and open any of the icons (Services, Message Store, or Log Files) to gain further access to Messaging Server components.

The right pane contains three tabs. For descriptions of these tabs, see the following sections:

Information Tab

Miscellaneous Tab

Information Tab

The Information tab allow you to view basic, read-only configuration information about Messaging Server.

For more information, see also “Viewing Basic Server Information” in the “Configuring General Messaging Capabilities” chapter of Sun Java System Messaging Server Administration Guide.

Server name. The name given to this instance of Messaging Server when it was installed.

Server root. The directory that holds all of this server’s files, plus the files of its Administration Server, plus the files of any other Sun Java System servers in the same server group (that is, administered by that Administration Server). A host typically has only one server root, but more than one is possible, especially if different version numbers of the same server are installed on a single host.

Install directory. The directory, within the server root directory, that holds all of the Messaging Server executable program files.There can be only one Messaging Server installation directory within the server root.

Instance directory. The directory, within the server root directory, that holds the files that define this instance of Messaging Server plus the files created and maintained by this instance. There may be multiple Messaging Server instance directories within the server root.

Miscellaneous Tab

The Miscellaneous tab allows you to specify a new user greeting form and specify a site language.

For more information, see the following sections in the in the “Configuring General Messaging Capabilities” chapter of Sun Java System Messaging Server Administration Guide:

Configuring Languages for Auto-Reply Messages

Configuring a Greeting Message

Site language. From the drop-down list, select the default preferred language for your site.

New user greeting form. In this field, enter the text of the greeting that is to be sent to each new user. Format the greeting as an email message, with a header (containing at least a subject line), then a blank line, then the message body. You can create different messages in different languages; from the drop-down list above the field, specify the language of each greeting message that you create. The appropriate message is then sent to each new user whose locale corresponds to one of the languages you select.

Standard Buttons

Save. Click this button to save settings you have made in the Miscellaneous tab.

General Tab

The General tab allows you to start, stop or view the status of any services of the Messaging Server.

For more information, see also “Starting and Stopping Services” in the “Configuring General Messaging Capabilities” chapter of Sun Java System Messaging Server Administration Guide.

Process Control. This field lists all accessible Messaging Server services (in the Service column) and their fundamental status (in the ON/OFF column).

Service. This column of the Process Control field lists all the Messaging Server services that you can start or stop. These are the available services:

If you select a service in the Process Control field, you can then apply the Start or Stop buttons to it.

ON/OFF. This column of the Process Control field notes, for each service listed in the Service column, whether the service is off or on, and (if on) when it was last started.

Start. Click this button to start a service that you have selected in the Service field.

Stop. Click this button to stop a service that you have selected in the Service field.

Service status. This field displays the status of the service currently selected in the Services column. (The field is blank for inactive services.)

Last connection time. The time at which the most recent connection was made to this service. This can tell you, for example, whether the server is having problems accepting connections.

Total number of connections. The number of connections that have been made to this service since it was last started. This can give you an overall, time-averaged picture of the level of this service’s activity.

Number of current connections. The number of currently active connections to this service. This can give you an idea of how heavily loaded the server currently is.

Number of failed connections. The number of connection requests that have been refused since the service last started. This can spotlight network problems or indicate an overloaded server.

Number of failed logins. The number of login requests that have been refused by the service since it last started. This can help spotlight attacks against the security of the server.

LDAP Tab

The LDAP tab allows you to view and configure connections to the LDAP directory used by your Messaging Server.

“Customizing Directory Lookups” in the “Configuring General Messaging Capabilities” chapter of Sun Java System Messaging Server Administration Guide.

Sun Java System Messaging Server Administration Guide (for setting configuration-directory parameters)

LDAP Connection for Server Configuration

Host name. A non-editable field that lists the host name of the LDAP directory server on which the configuration information for this Messaging Server is stored.

Port number. A non-editable field that lists the port number to be used for access to the LDAP directory server on which the configuration information for this Messaging Server is stored.

Base DN. A non-editable field that lists the search base, the distinguished name of the location in the LDAP directory at which to start searching for the configuration information for this Messaging Server.

Bind DN. A non-editable field that lists the bind distinguished name, the user name under which this Messaging Server accesses the LDAP directory server on which its configuration information is stored.

LDAP Connection for User Lookup

Use Messaging Server-specific directory settings. Check this box if you want to customize the LDAP connection for user lookup by changing any of the following fields: Host name, Port number, Bind DN, Base DN. Uncheck this box to return to using the default user directory for your server group.

Host name. In this field, specify the host name of the LDAP directory server on which this Messaging Server is to look up user and group information.

Port number. In this field, enter the port number used to access the LDAP directory server on which this Messaging Server is to look up user and group information.

Bind DN. In this field, enter the bind distinguished name, the user name under which this Messaging Server accesses the LDAP directory server to obtain user and group information.

Base DN. In this field, specify the search base, the distinguished name of the location in the LDAP directory at which to start searching for user and group information.

Change Bind password. Click this button to open a window (see Change Password Window) that allows you to change the password to be used to authenticate this Messaging Server to the LDAP directory for user lookups.

Standard Buttons

Save. Click this button to commit any settings you have made in the LDAP tab.

Change Password Window

The Change Password window allows you to change the password that Messaging Server uses to authenticate itself to the LDAP directory for user and group lookup.

For more information, see also “Customizing Directory Lookups” in in the “Configuring General Messaging Capabilities” chapter of Sun Java System Messaging Server Administration Guide.

Confirm password. In this field, re-enter the password. If what you enter is different from what you entered in the Password field, you are prompted to try again.

Standard Buttons

OK. Click this button to commit to the changed password and close the Password-Entry window.

Cancel. Click this button to cancel the password-changing operation and close the Password-Entry window, leaving the current password unchanged.

Managing Mail Users

This section describes the Console interface options that let you configure and manage the mail-related components of the user information stored in the LDAP user directory. See Managing Servers with iPlanet Console for general information on using Console to manage Messaging Server and other servers. See Directory Server Administrator’s Guide for information on LDAP, the user directory, and other user information stored in the directory.

User Settings Tab

The User Settings tab lets you define a user’s Messaging Server host machine and email addresses.

For more information, see also “Specifying User Email Addresses” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Messaging Server host name. In this field, enter the name of the Messaging Server that hosts this user’s mail services. The host name you enter must be a fully-qualified domain name (FQDN). If the server has multiple host names, this must be the FQDN known to the Messaging Server on that machine.

Primary email address. In this field, enter the primary email address for this user. The primary address is the publicized address, the one displayed by address-book applications. Each user can have only one primary address.

The address you enter in this field must be a correctly-formatted, valid SMTP address conforming to RFC 821 specifications. Case is not significant; all characters that you enter in this field are forced to lower case.

To implement host name hiding (the host name in the user’s address is shown in the outgoing mail header), do not specify the host name in the Primary email address field, but instead include the host name in an Alternate address.

Alternate Addresses. This field displays a list of this user’s alternate email addresses, or aliases to the primary email address. Click the Add or Delete buttons to modify the information in this field.

Ensure proper delivery of misaddressed mail, (for example, to correct a frequently misspelled address such as using “Smith” as an alias for “Smythe”)

Implement group host name hiding for outgoing message headers. To enable host name hiding, supply an alternate address that includes the host name, but do not specify the host name in the Primary email address field.

You can add as many alternate addresses to the list as you like, provided each is unique. Click the Add, Edit, or Delete buttons to modify the information in this field.

Add. Click this button to open a window (see Alternate Addresses Window (Users)) that lets you add an address to the Alternate address field.

Edit. Select an address listed in the Alternate Addresses field and then click this button to change it using the Alternate Addresses window. (The Edit button becomes available only when one or more addresses are listed in the Alternate Addresses field.)

Delete. Click this button, after selecting an address in the Alternate address field, to remove that address from the user’s list of alternate email addresses.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Alternate Addresses Window (Users)

The Alternate Addresses window lets you define or change an alternate email address for a user and add it to the Alternate Addresses field in the Mail Settings tab.

For more information, see also “Specifying User Email Addresses” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Alternate email address for this user. In this field, enter the address to be added to the user’s list of alternate email addresses.

Standard Buttons

Cancel. Click this button to close the window without submitting your entries.

Delivery Tab

The Delivery tab lets you configure the mail-delivery options available for a user. For more information, see also “Configuring Delivery Options” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

POP/IMAP Delivery

Enable POP/IMAP delivery. Check this box to enable delivery to this user’s regular POP3 or IMAP4 mailboxes. When the box is checked, the associated Properties button is active. Clear this checkbox to disable POP/IMAP delivery.

Properties. If the “Enable POP/IMAP delivery” box is checked, click this button to open a window that lets you define various settings for POP/IMAP delivery for this user.

Program Delivery

Program delivery. Check this box to enable program delivery for this user. Program delivery can redirect the user’s incoming mail to specified external commands, or applications. When this box is checked, the associated Properties button is active. Clear this checkbox to disable program delivery for this user.

Checking this box makes program delivery available to the user only if program delivery has been enabled on your server. For details, see “Setting Up Program Delivery” in the “Managing Mail Users and Mailing Lists” chapter of the Sun Java System Messaging Server Administration Guide.

Properties. If the Program delivery box is checked, click this button to go a window (see Program Delivery Window) that lets you define the commands to be executed by this user’s program delivery service.

UNIX Delivery

UNIX delivery. Check this box to enable standard UNIX mail delivery as a delivery option for this user. When UNIX delivery is activated for a user hosted by Messaging Server running on a UNIX host, incoming mail for the user is stored in the user’s designated UNIX mail file. Uncheck this box to disable UNIX delivery.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

POP/IMAP Delivery Window

The POP/IMAP Delivery window lets you configure delivery and access to an individual user’s POP or IMAP mailboxes.

For more information, see also “Specifying POP/IMAP Delivery” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Message store name. In this field, enter the name (nickname, not pathname) of the message store partition to which the user’s incoming mail should be delivered, if other than the current default primary partition. The name must represent an existing partition. For information on the message store and instructions for creating partition nicknames, see “Managing the Message Store” in Sun Java System Messaging Server Administration Guide.

Mail storage limit. Buttons in this area let you assign a disk quota, or allocated storage limit, specific to this user alone.

Use default. Click this button to set the user’s storage limit to whatever is specified as the default disk quota for all users. For instructions on setting the default disk quota for the message store, see “Configuring Message Store Quotas” in the “Managing the Message Store” chapter of the Sun Java System Messaging Server Administration Guide.

Unlimited. Click this button to specify unlimited storage allocation for the user.

Limit to. Click this button to specify a disk quota for this user. Enter a number in the field and select the appropriate unit (KB or MB).

No of Message limit. Buttons in this area let you assign limits to the number of messages stored on disk.

Use default. Click this button to set the user’s message limit to whatever is specified as the default for all users. For instructions on setting the default message limit for the message store, see “Configuring Message Store Quotas” in the “Managing the Message Store” chapter of the Sun Java System Messaging Server Administration Guide.

Unlimited. Click this button to specify an unlimited number of messages for the user.

Limit to. Click this button to specify a message limit for this user. Enter a number in the field.

Add. Click this button to open a window that lets you add an access domain to the Access domains field.

Delete. Click this button, after selecting an item in the Access domains field, to remove the item from this user’s list of access domains.

Standard Buttons

Cancel. Click this button to close the window without submitting your entries.

Program Delivery Window

The Program Delivery window lets you define the commands to be executed for Program Delivery services.

For more information, see the following sections in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide:

Specifying Program Delivery

Specifying POP/IMAP Delivery

Program delivery command(s). Enter the command to be executed for program delivery services for this user.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Forwarding Tab

For more information, see also “Specifying Forwarding Addresses” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Forwarding address. This field displays the list of addresses to which the user’s mail should be redirected when forwarding is enabled. Use the Add button to add an address to this field; use the Edit button to modify an address, or use the Delete button to remove an address.

Add. Click this button to open a window that lets you add a forwarding address to the list of forwarding addresses for this user.

Edit. Select a forwarding address and then click this button to open a window that lets you modify the address. (The Edit button becomes available only when one or more addresses are listed in the Alternate Addresses field.)

Delete. Click this button, after selecting an address in the Forwarding address field, to remove the selected item from the user’s list of forwarding addresses.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Forwarding Address Window

The Forwarding Address window lets you add or edit a mail forwarding address in the Forwarding address list in the Forwarding tab.

For additional information, see “Specifying Forwarding Addresses” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Forwarding address. In this field, enter the forwarding address you want to add to the user’s list of mail-forwarding addresses.

Standard Buttons


Note	Do not specify forwarding addresses for two users on the same server to point to each other when both accounts have no other delivery type enabled as this configuration may cause mail delivery problems.

Cancel. Click this button to close the window without submitting your entries.

Auto-Reply Tab

The Auto-Reply tab lets you enable or disable several kinds of automatic mail reply for a user, and to specify the contents of the response message.

For additional information, see “Configuring Auto-Reply Settings” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Auto-Reply Mode

Echo. Select this option to enable echo mode. In echo mode, an automatic reply is sent for each received message, with the received message appended as a MIME attachment. If you select this mode, you can enter a reply message in the Reply text field.

Vacation. Select this option to enable vacation mode. In vacation mode, the first message received by this user from a given sender generates an automatic response; subsequent messages from that sender do not generate a response.

Check the Vacation start/end date box and click the Edit buttons to specify the dates and times of when to start and stop sending the auto-reply.

Enter a reply message in the Reply text field.

Vacation start/end date. This checkbox is available if you select Vacation mode. If you check this box, Start and End buttons become available that let you pick dates and times from a calendar.

Autoreply timeout. Specify a number in hours or days. Subsequent messages from that sender do not generate a response until the automatic reply time-out is reached.

Response to Internal Senders. Use this field to specify a reply message to be automatically returned to internal senders of messages to this user.

First specify the language from the language drop-down list, then compose the message in the text field. You can create more than one message; each language can have its own message.

Response to External Senders. Use this field to specify a reply message to be automatically returned to external senders of messages to this user.

First specify the language from the language drop-down list, then compose the message in the text field. You can create more than one message; each language can have its own message.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Date-Time Window

Use the Date-Time window to set a date and time that tells Messaging Server when to start or stop sending an automatic mail reply for a user. The Date-Time window provides four areas: month, year, day of the month (in calendar format), and time (select the hour, minute, and second independently to change them).

Standard Buttons

Cancel. Click this button to close the window without submitting your entries.

Authorized Services Tab

The Authorized Services tab lets you enable the mail services for which this user can access mail.

For additional information, see “Configuring Authorized Services” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Service. Lists the service—IMAP, POP, SMTP, HTTP, or All—for which this rule applies.

Applies to. Specify the client domains for which you wish to grant access to the service.

Add. Click this button to open a window that lets you create an authorized services rule.

Edit. Click this button to open a window that lets you edit an authorized services rule.

Add Rule for Authorized Services Window

The Add Rule for Authorized Services window lets you create a rule for authorized services. This window has the following elements:

Service drop-down list. From this list, choose the service—IMAP, POP, SMTP, HTTP, All—you wish to specify a rule for.

Managing Mailing Lists

This section describes the Console interface options that let you configure and manage the mail-related components of the groups defined in the LDAP user directory. See Managing Servers with iPlanet Console for information on using Console to manage Messaging Server and other servers. See Directory Server Administrator’s Guide for information on LDAP, the user directory, and other group information stored in the directory.

Settings Tab

The Mail Settings tab lets you specify basic information, such as the email addresses for the mailing-list portion of a group.

“Specifying Mailing List Settings” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide

“User and Group Administration,” of Managing Servers with iPlanet Console (for using the Search Users and Groups window)

Primary email address. In this field, enter the primary email address for this mailing list. The primary address is the publicized address, the one displayed by address-book applications. Each mailing list can have only one primary address. This information is required.

The address you enter in this field must be a correctly-formatted, valid SMTP address conforming to RFC 821 specifications.

To implement host name hiding (the host name in the group’s address is shown in the outgoing mail header), do not specify the host name in the Primary email address field, but instead include the host name in an Alternate address.

Alternative email addresses. This field displays a list of alternate email addresses for this mailing list. You can use this feature, for example, to:

Ensure proper delivery of misaddressed mail (to correct for common misspellings, for example)

You can add as many alternate addresses to the list as you like, provided each is unique. Click the Add, Edit, or Delete button to modify the information in this field. For more information, see “Managing Mailing Lists” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Add. Click this button to open a window (see Add/Edit List Owner Window) that lets you add an address to the Alternate email addresses field.

Edit. After selecting an address in the Alternative email addresses field, click this button to open a window (see Add/Edit List Owner Window) that lets you edit that alternate address.

Delete. After selecting an address in the Alternative email addresses field, click this button to remove the selected address from the field.

Errors to: (Enter email address). In this field, enter the email address of the person, possibly a list owner or system administrator, to whom error messages should be sent when mail sent to the list bounces. The address you enter in this field must be a correctly-formatted, valid SMTP address conforming to RFC 821 specifications.

Messaging Server hostname. In this field, enter the name of the Messaging Server that handles mail for this mailing list. The host name you enter must be a fully-qualified domain name (FQDN). If the server has multiple host names, this must be the FQDN known to the Messaging Server on that machine.

Leave this field blank if you want to allow any Messaging Server host to handle mail for the mailing list.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Alternate Addresses Window (Groups)

The Alternate Addresses window lets you add an address to, or edit an address in, the Alternate email addresses field in the Mail Settings tab.

For more information, see also “Specifying Mailing List Settings” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Enter alternative email address for the mailing list. Enter the address that you want to add, or edit the displayed address.

Standard Buttons

Cancel. Click this button to close the window without submitting your entry.

Owners Tab

The Mail Owners tab lets you specify the owners of the mailing-list. Typically, the list owner (or owners) created the mailing list, and has administrative privileges for adding or removing users, modifying configuration settings, or deleting the list.

“Specifying Mailing List Settings” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide

“User and Group Administration,” of Managing Servers with iPlanet Console (for using the Search Users and Groups window)

Mail list owners. This field contains the distinguished names (DNs) of the owners of this mailing list. Click the Add, Edit, Delete, or Search button to modify the information in this field.

Add. Click this button to open a window (see Add/Edit List Owner Window) that lets you add the distinguished name (DN) of an owner to the Mail list owners field.

Edit. After selecting an item in the Mail list owners field, click this button to open a window (see Add/Edit List Owner Window) that lets you edit that owner’s DN.

Delete. After selecting a DN in the Mail list owners field, click this button to remove the selected owner from the field.

Search. Click this button to open the Search Users and Groups window, which lets you search the user directory for an owner that you can add to the Mail list owners field. (User and Group searching is described in Managing Servers with iPlanet Console.)

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Add/Edit List Owner Window

The Add/Edit List Owner window lets you add or edit the distinguished name (DN) of a mailing list owner in the Mail list owners field in the Mail General form.

For more information, see also “Specifying Mailing List Settings” in the “Managing Mail Users and Mailing Lists” in Sun Java System Messaging Server Administration Guide.

Enter list owner’s DN. Enter the DN that you want to add, or edit the displayed DN. Note that you can use the Search button in the Mail General form to get the DN of an owner by searching the user directory.

Standard Buttons

Cancel. Click this button to close the window without submitting your entry.

Descriptions Tab

The Descriptions tab lets you specify optional comments about the mailing-list for informational use only. Messaging Server does not use or require any of the information supplied on this tab.

Descriptive comments. In this field, enter any comments or descriptive notes pertaining to the mailing list.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Email-only Members Tab

The Mail Email-only tab lets you view and modify the (email-only) membership of this mailing list. You can specify dynamic criteria for list membership, and you can also specify individual members by email address.



Note	Mailing-list members defined here (email-only members) are different from members of the mailing list that are specified in the members tab of the Groups interface. Group members entered through the Groups interface (that is, through the Members tab rather than the Mail account’s Email-only Members tab) are mailing-list members as well, but in addition have whatever other privileges the group (apart from its mailing list) may define.

For more information, see also “Specifying List Members” in the “Managing Mail Users and Mailing Lists” chapter of the Sun Java System Messaging Server Administration Guide.

Dynamic criteria for email-only membership. This field displays the dynamic criteria, if any, that are used to define mailing-list membership. Dynamic criteria consist of LDAP search URLs, and could include specific user attributes such as organizational unit (for example, all employees in the Marketing organization) or Messaging Server host (for example, all users of the server siroepost1). All users in the user directory matching any criteria defined here are considered members of this mailing list. Applying dynamic membership criteria saves you the effort of specifying each member explicitly when creating a mailing list.

Click the Add, Edit, Delete, or Test buttons to modify or validate the information in this field:

Add. Click this button to open a window (see Add/Edit Dynamic Criteria Window) that lets you add a dynamic membership criterion (in the form of an LDAP URL) to the “Dynamic criteria for email-only membership” field.

Edit. After selecting criteria (LDAP URL) in the “Dynamic criteria for email-only membership” field, click this button to open a window (see Add/Edit Dynamic Criteria Window) that lets you edit the URL.

Delete. After selecting criteria (LDAP URL) in the “Dynamic criteria for email-only membership” field, click this button to remove the criterion from the field.

Test. After selecting criteria (LDAP URL) in the “Dynamic criteria for email-only membership” field, click this button to ensure the format of the criterion is valid and to see the list of members it creates based on the current user database.

Members with email-only membership. This field lists the email address of individual mailing-list members. You can specify members explicitly by placing their addresses in this field, instead of (or in addition to) defining membership with dynamic criteria. Group members that are not email-only members do not need to be listed in this field. Click the Add, Edit, or Delete buttons to modify the information in this field


Note	Because only an email address is required, you can use this field to add members to the mailing list that do not appear in the LDAP user directory.

Add. Click this button to open a window (see Add/Edit Email-Only Member Window) that lets you add a user to the “Members with email-only membership” field.

Edit. After selecting an item in the “Members with email-only membership” field, click this button to open a window (see Add/Edit Email-Only Member Window) that lets you edit that member’s address.

Delete. After selecting an item in the “Members with email-only membership” field, click this button to remove the selected member from the list.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Add/Edit Dynamic Criteria Window

The Add/Edit Dynamic Criteria window lets you specify an LDAP Search URL that can be used as a filter for dynamically defining email-only mailing-list membership.

“Defining Dynamic Membership Criteria” in the “Managing Mail Users and Mailing Lists” chapter of the Sun Java System Messaging Server Administration Guide.

“User and Group Administration,” of Managing Servers with iPlanet Console (for using the Construct LDAP URL window)

Enter an LDAP search URL. In this field, enter the LDAP filter you want to add to the “Dynamic criteria for email-only membership” field of the Mail List Members form (or edit the existing filter that appears here). The result of your entry or edit must be a single, complete filter.

Construct. Click this button to open the Construct LDAP URL window, which provides a template you can use to construct your search filter. (The LDAP URL window is described in Managing Servers with iPlanet Console.)

Standard Buttons

Cancel. Click this button to close the window without submitting your entry.

Dynamic Criteria Test Result Window

The Dynamic Criteria Test Result window shows the email-only membership mailing list that will be generated as a result of using an LDAP Search URL to create it dynamically. This window displays when you supply criteria in the “Dynamic criteria for email-only membership” field and click the Test button on the Email-only Members tab.

“Defining Dynamic Membership Criteria” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

“User and Group Administration,” of Managing Servers with iPlanet Console (for using the Construct LDAP URL window)



Note	This window is for display purposes only and requires no user input. When you have finished examining the results, click Cancel to close this window and return to the Email-only Members tab.

Add/Edit Email-Only Member Window

The Add/Edit Email-Only Member window lets you add a user to the “Members with email only membership” field in the Mail List Members tab.

For more information, see also “Specifying List Members” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Enter User’s Email Address. In this field, enter the email address of the user you want to add to the “Members with email only membership” field in the Mail List Members form (or edit the existing address that appears here). The address you enter in this field must be a correctly-formatted, valid SMTP address conforming to RFC 821 specifications.

Standard Buttons

Cancel. Click this button to close the window without submitting your entry.

Restrictions Tab

The Restrictions tab lets you implement policies that govern who is allowed to send messages to this mailing list and how large the messages can be.

“Defining Message-Posting Restrictions” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Chapter 4, “User and Group Administration,” of Managing Servers with iPlanet Console (for using the Search Users and Groups window)



Note	The Message Restrictions form contains a large number of options. If the lower portion of the form is obscured when you first access it, use the scroll bar on the right side to view the remainder of the form.

Allowed Senders

Select one of the following three choices to specify who is allowed to post messages to the mailing list. (The default is “Anyone.”)

Anyone in the mailing list. Click this button to restrict message-posters to mailing-list members only. (Group members that aren’t email-only members will also be allowed to post.)

Anyone in the following list. Click this button to allow only those users that appear in the input field to be able to post messages to the mailing list.

The field contains either the email address or the distinguished name (DN) of each user permitted to send messages to the list. If you select the “Anyone in the following list” option, you must supply at least one entry in this field.

Click the Add, Edit, Delete, or Search buttons to modify the content of this field.


Note	If you want all list members plus other individuals to be allowed to post messages, put the DN or email address of the mailing list itself into this field, plus whatever other individuals you want to have posting permission.

Add. Click this button to open a window (see Add/Edit Allowed Sender Window) that lets you add a new user to the Allowed Senders field.

Edit. After selecting an item in the Allowed Senders field, click this button to open a window (see Add/Edit Allowed Sender Window) that lets you edit that sender’s DN or email address.

Delete. After selecting an item the Allowed Senders field, click this button to remove the sender from the field.

Search. Click this button to open the Search Users and Groups window, which lets you search the user directory for a user that you can add to the Allowed Senders field. (User and Group searching is described in Managing Servers with iPlanet Console.)

Sender Domains

Allowed sender domains. This fields displays the list of domains from which messages will be accepted for posting to this mailing list. If none is specified, there is no sender-domain restriction.

Add. Click this button to open a window (see Add/Edit Allowed Sender Domain Window) that lets you add a domain to the Allowed Sender Domains field.

Edit. After selecting an item in the Allowed Sender Domains field, click this button to open a window (see Add/Edit Allowed Sender Domain Window) that lets you edit the domain specification.

Delete. After selecting an item in the Allowed Sender Domains field, click this button to remove the selected member from the field.

Maximum Message Size

Maximum message size (in bytes). Enter the maximum permitted size (in bytes) for messages to be posted to this mailing list.

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Add/Edit Allowed Sender Window

You use the Add/Edit Allowed Sender window to add users to the Allowed Sender list in the Message Restrictions tab, or to edit the information about an existing allowed sender. An allowed sender is a user with permission to post messages to a particular mail group.

For more information, see also “Defining Message-Posting Restrictions” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Enter sender’s email address or DN. In this field, enter the email address or distinguished name of the user you want to add to the Allowed Sender list in the Message Restrictions form.

Standard Buttons


Note	You can enter the DN or email address of a group in this field. If you do so, all members of that group become allowed senders.

Cancel. Click this button to close the window without submitting your entry.

Add/Edit Allowed Sender Domain Window

You use the Add /Edit Allowed Sender Domain window to add a domain to the Allowed sender domains field of the Message Restrictions form, or to edit the specification of an existing allowed domain. An allowed domain is a domain from which incoming messages can be accepted for posting to this mailing list.

For more information, see also “Defining Message-Posting Restrictions” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Enter a domain name. In this field, enter (or edit) the name of the domain you want to allow posting from. The result of your entry is placed in the Allowed sender domains field of the Message Restrictions form.

Standard Buttons

Cancel. Click this button to close the window without submitting your entry.

Moderator Tab

The Moderators tab allows you to view, add, or delete moderators, or edit moderator information.

“Defining Moderators” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide

“User and Group Administration,” of Managing Servers with iPlanet Console (for using the Search Users and Groups window)

List moderators. This field displays the list of moderators for this group. A moderator is specified either by email address or by distinguished name (DN). Click the Add, Edit, Delete, or Search buttons to modify the content of this field:

Add. Click this button to open a window (see Add/Edit Moderator Window) that lets you add a new moderator for this mailing list to the “List moderators” field.

Edit. After selecting an item in the List moderators field, click this button to open a window (see Add/Edit Moderator Window) that lets you edit the moderator’s DN or email address.

Delete. After selecting an item in the “List moderators” field, click this button to remove the moderator from the field.

Search. Click this button to open the Search Users and Groups window, which lets you search the user directory for a user that you can add to the “List moderators” field. (User and Group searching is described in Managing Servers with iPlanet Console.)

Standard Buttons

OK. Click this button to submit your entries and close the Edit Entry window.

Cancel. Click this button to close the window without submitting your entries.

Add/Edit Moderator Window

You use the Add/Edit Moderator window to add a user to the List moderators field in the Message Reject Actions form.

For more information, see also “Defining Moderators” in the “Managing Mail Users and Mailing Lists” chapter of Sun Java System Messaging Server Administration Guide.

Enter moderator’s DN or email address. In this field, enter the email address or distinguished name of the user you want to add to the list of moderators for the mailing list (or edit the information for an existing moderator).

Standard Buttons

Cancel. Click this button to dismiss the window without submitting your entry.

POP, IMAP, and HTTP Configuration

This section describes the Administration Console interface elements that allow you to configure and execute the Messaging Server POP, IMAP, and HTTP services. See Managing Servers with iPlanet Console for information on using Administration Console to manage Messaging Server and other servers.

IMAP System Tab

The IMAP System tab allows you to set basic configuration parameters for the Messaging Server IMAP service.

For more information, see the following sections in the “Configuring POP, IMAP, and HTTP Services” chapter of Sun Java System Messaging Server Administration Guide:

Configuring IMAP Services

General Configuration

Performance Parameters

Enable IMAP service at port. Check this box to enable the IMAP service; in the associated field, enter the number of the port this server will use for IMAP. (Default = 143.)

Use separate port for IMAP over SSL. Check this box to enable IMAP over SSL; in the associated field, enter the number of the port this server will use for IMAP over SSL. (Default = 993, the standard port number for IMAP over SSL.)

Allow password login. Check this box to allow users to log in to the IMAP service by supplying a user name and password. (Default = enabled.)

If this box is checked, you can specify password-encryption requirements in the following field. If this box is not checked, certificate-based login to IMAP is required.

Minimum cipher length for password encryption. From the drop-down list, select the minimum length of encryption cipher that the server will accept for transmission of IMAP passwords. (Default = 0.) A length of 0 means that no encryption is required; passwords can be sent in the clear.

IMAP service banner. (Optional) In this field, enter a replacement banner for the default IMAP banner that is sent to an IMAP clients when it first connects to the IMAP port. (The default banner identifies the server version and the time of connection.)

Connection Settings

Maximum network sessions. In this field, specify how many simultaneous IMAP sessions this server is permitted to maintain per process. (Default = 4000.)

Drop client if idle for. In this field, specify how long (in seconds, minutes, or hours) an IMAP connection to a client can remain idle before the server drops the connection. (Default = 30 minutes.)

Process Settings

Maximum number of threads per process. In this field, specify the maximum number of threads the IMAP service is permitted to execute at a time. (Default = 250.)

Number of processes. In this field, specify the maximum number of processes that the IMAP service can employ. (Default = 1.)

Standard Buttons

Save. Click this button to save settings you have made in the IMAP System tab.

POP System Tab

The POP System tab allows you to set basic configuration parameters for the Messaging Server POP service.

For more information, see the following sections in the “Configuring POP, IMAP, and HTTP Services” chapter of Sun Java System Messaging Server Administration Guide:

Configuring POP Services

General Configuration

Performance Parameters

Enable POP service at port. Check this box to enable the POP service; in the associated field, enter the number of the port this server will use for POP. (Default = 110.)

Enable POP service over SSL. Check this box to enable the POP over SSL service; in the associated field, enter the number of the port this server will use for POP over SSL. (Default=992)

POP service banner. (Optional) In this field, enter a replacement banner for the default POP banner that is sent to a POP client when it first connects. (The default banner identifies the server version and the time of connection.)

Connection Settings

Maximum network sessions. In this field, specify how many simultaneous POP sessions per process this server is permitted to maintain. (Default = 600.)

Drop client if idle for. In this field, specify how long (in seconds, minutes, or hours) a POP connection to a client can remain idle before the server drops the connection. (Default = 10 minutes.)

Process Settings

Maximum number of threads per process. In this field, specify the maximum number of threads the POP service is permitted to have executing at a time. (Default = 250.)

Number of processes. In this field, specify the maximum number of processes that the POP service can employ. (Default = 1.)

Standard Buttons

Save. Click this button to save settings you have made in the POP System tab.

HTTP System Tab

The HTTP System tab allows you to set basic configuration parameters for the Messaging Server HTTP service.

For more information, see the following sections in the “Configuring POP, IMAP, and HTTP Services” chapter of Sun Java System Messaging Server Administration Guide:

Configuring HTTP Services

General Configuration

Performance Parameters

Enable HTTP service at port. Check this box to enable the HTTP service; use the field to enter the number of the port this server uses for HTTP.
(Default = 80.)

Use separate port for HTTP over SSL. Check this box to enable HTTP over SSL; use the field to enter the number of the port this server will use for HTTP over SSL. (Default = 443, the standard port number for HTTP over SSL.)

Allow password login. Check this box to allow users to log in to the HTTP service by supplying a user name and password. (Default = enabled.)

If this box is checked, you can specify password-encryption requirements in the following field. If this box is not checked, certificate-based login to HTTP is required.

Minimum cipher length for password encryption. Use this field to select the minimum length of encryption cipher that the server will accept for transmission of HTTP passwords. A length of 0 means that no encryption is required; passwords can be sent in the clear. (Default = 0.)

Connection Settings

Maximum network connections per process. In this field, specify how many simultaneous HTTP sessions this server is permitted to maintain per process. (Default = 6000.)

Drop client connection if idle for. In this field, specify how long (in minutes or hours) an HTTP connection to a client can remain idle before the server drops the connection. (Default = 2 minutes.)

Log out client if idle for. In this field, specify how long (in minutes or hours) an HTTP session can remain idle before the server drops the session and logs out the client. (Default = 2 hours.)

Process Settings

Maximum number of threads per process. In this field, specify the maximum number of threads the HTTP service is permitted to execute at a time. (Default = 250.)

Number of processes. In this field, specify the maximum number of processes that the HTTP service can employ. (Default = 1.)

Message Settings

Attachment spool directory. In this field, specify the directory where HTTP attachments are stored.

Maximum attachment size. In this field, specify the maximum size allowed for HTTP attachments. From the drop-down list, specify Mbytes or Kbytes.

MTA Settings

Alternate MTA hostname. In this field, specify the host name for an alternate MTA.

Alternate MTA port. In this field, specify the port number for the alternate MTA.

Standard Buttons

Save. Click this button to save settings you have made in the HTTP System tab.

Message Store Configuration

This section describes the Messaging Server interface elements that allow you to configure the server’s message store services. You access these elements through Administration Console; see Managing Servers with iPlanet Console for information on using Administration Console to manage the Messaging Server and other Sun Java System servers.

Administrator Tab

The Administrator tab allows you to view the list of message store administrators and to add entries to this list. For more information, see also “Specifying Administrator Access to the Store” in the “Managing the Message Store” chapter of Sun Java System Messaging Server Administration Guide.

Administrator UID list. This field displays the list of administrators for this message store.

Add. Click this button to go to the Store Administrator Entry window. This window enables you to add administrators to the list.

Edit. Click this button to go to the Store Administrator Entry window. This window enables you to edit the selected entry in the Administrator UID list.

Reset. Click this button to return the list contents to the previously-saved version.

Store Administrator Entry Window

The Store Administrator Entry window allows you to add or edit an entry in the message store administrator list.

Administrator UID. In this field, enter the user ID of the Administrator you want to add to the message store administrator list. This must be a valid user ID known to the Directory Server.

OK. Click this button to submit your entry and dismiss the window and return to the Administrator form.

Cancel. Click this button to dismiss the window without submitting your entry information.

Quota Tab

The Quota tab allows you to define default user disk quotas for the message store. For more information, see also in the “Managing the Message Store” chapter of Sun Java System Messaging Server Administration Guide:

About Message Store Quotas

Configuring Message Store Partitions

Default user disk quota. This is the amount of storage to be allotted to a user if no disk quota is specified for that user. You can specify either:

Unlimited — Select this option if the default disk quota for users is to be unrestricted.

Size specification — Enter a number in this field to limit user disk quotas. From the associated drop-down list, choose MBytes or KBytes.

Quota warning threshold. In this field, type a number to specify the percentage of disk quota usage which, when exceeded by a user, generates a warning message by the server.

Message to send to the user when quota is exceeded. In this field, enter the contents of the warning message to be sent when a user’s disk quota is exceeded.

Over quota grace period. In this field, type a number to indicate how long the messaging server will hold messages in the queue for users who have exceeded their disk quota. From the associated drop-down list, choose days or hours.

Save. Click this button to submit and preserve the current disk quota specifications.

Reset. Click this button to return the specifications to the previously-saved version.

Partition Tab

The Partition tab allows you to view message store partition information, and to add, edit, and delete partition entries. For more information, see also “Configuring Message Store Partitions” in the “Managing the Message Store” chapter of Sun Java System Messaging Server Administration Guide.

List of partitions. This area lists disk partition information for the message store. This includes the following fields:

Default. This field indicates whether this partition is the default partition for the message store. This is the partition assigned for a user if no partition is specified for that user in the LDAP entry.

Nickname. This field indicates the nickname for the partition. You can use the nickname when configuring user account information.

Path. This field indicates the full physical path for the partition.

Add. Click this button to go to the Store Partition Entry window. This window enables you to add a partition. See Store Partition Entry Window.

Edit. Click this button to go to the Store Partition Entry window. This window enables you to edit information about a partition.

Delete. Click this button to delete a partition you’ve highlighted in the partition list.

Reset. Click this button to return the partition list to the previously-saved version.

Store Partition Entry Window

The Store Partition Entry window allows you to add or edit a partition entry in the partition list on the Partition form. For more information, see also “Configuring Message Store Partitions” in the “Managing the Message Store” chapter of Sun Java System Messaging Server Administration Guide.

Partition path. This is the absolute pathname for the specified partition. The partition will be created at this location. The userID used to run the Server must have permission to write to this location, in order to create and manage the partition.

Make this the default partition. Click this box to configure this partition as the default.

OK. Click this button to submit this partition entry and dismiss the window.

Cancel. Click this button to dismiss the window without submitting the partition information.

Expire/PurgeTab

The Expire/Purge tab lists the automatic message removal policy. This tab also allows you to define, add, edit, delete, and schedule automatic message removal rules. For more information, see also “Setting Automatic Message Removal (Expire and Purge) ” in the “Managing the Message Store” chapter of Sun Java System Messaging Server Administration Guide.

Message store expire rules. This area lists the expire rules for the message store. The table includes the following fields:

Exclusive. This field indicates whether this rule is the exclusive rule for folders matching a specified pattern.

Name. This field is a name you can assign to the rule for convenience purposes. The name is not used by Messaging Server.

Target. This a pathname, filename, or partial string to be used as the criteria for determining rule targets.

Foldersize. This indicates folder size restrictions to be applied to the target folders. Size can be specified by message count or disk usage (in megabytes or kilobytes). When the folder size is exceeded, the oldest messages are removed until this size is no longer exceeded.

Count. This is the number of messages that will be retained in the target folder(s) before the oldest messages are deleted.

Age. This field indicates the message age constraint for target folders. Messages which have been retained in the target folder(s) longer than the specified number of days are removed.

MsgSize. This field indicates the message size constraint for target folders.

Grace Period. This field indicates how long over-sized messages will remain in the folder before being deleted.

Seen. This field indicates whether messages with the Seen flag set should be removed. If set to “and,” the message must be seen and another criteria must be met before the rule is fulfilled. If set to “or,” the message only need to be seen or another criteria must be met before the rule is fulfilled.

Deleted. This field indicates whether messages with the Deleted flag set should be removed. If set to “and,” the message must be deleted and another criteria must be met before the rule is fulfilled. If set to “or,” the message only need to be seen or another criteria must be met before the rule is fulfilled.

Header Constraint. Specifies a header field and string that will mark a message for removal.

Add. Click this button to go to the Aging Rule Entry window. This window enables you to define an aging rule for the message store.

Edit. Click this button to go to the Aging Rule Entry window. This window enables you to edit a defined aging rule.

Delete. Click this button to delete a rule you’ve selected in the rules list.

Save. Click this button to submit and preserve the current aging rules list.

Reset. Click this button to return the list contents to the previously-saved version.

Expire Rule Entry Window

The Expire Rule Entry window allows you to define or edit an expire rule entry, and to specify matching patterns for determining rule targets.

The Expire Rule Entry window has the elements listed below. To activate an element, check the element checkbox and select desired values for the attribute.

Name. Enter the name for the Expire Rule in this field. This is a name you can assign for convenience purposes; it is not used by the Messaging Server.

Apply to folders matching the following pattern. Enter a pathname, filename, or partial string to be used as the criteria for determining rule targets. Examples:


Folder Pattern	Scope
user/userid/.*	Apply rule to all messages in all folders of userid.
user/userid/Sent	Apply rule to messages of userid in folder Sent:
user/.*	Apply rule to entire message store.
user/.*/trash	Apply rule to the trash folder of all users.
user/.@siroe.com/.	Apply rule to folders in hosted domain siroe.com:
user/[^@]/.	Apply rule to folders in default domain.
user/partition_name/.*	Apply rule to specific parition.

Exclusive. Click this selection box to specify that this rule is to be the only rule applied to the target folders.

Message count. In this field, type the maximum number of messages which will be retained in a folder before the oldest messages are removed.

Folder size. In this field, type the maximum size for the target folder. From the associated drop-down list, choose MByte(s) or KByte(s). When the specified folder size is exceeded, the oldest messages are removed until this size is no longer exceeded.

Number of days. In this field, type the number of days allowed for retaining messages in a target folder. After the specified retention period has elapsed for a given message in a target folder, the message is removed.

Message size limit. In this field, type the maximum allowed size for messages stored in a target folder. From the associated drop-down list, choose MBytes or KBytes.

Grace period. In this field, type a number to indicate the number of days oversized messages are allowed to remain in the folder before being deleted.

Seen. Set this field to “and” or “or” to indicate whether messages with the Seen flag set should be removed. If set to “and,” the message must be seen and another criteria must be met before the rule is fulfilled. If set to “or,” the message only need to be seen or another criteria must be met before the rule is fulfilled.

Deleted. Set this field to “and” or “or” to indicate whether messages with the Deleted flag set should be removed. If set to “and,” the message must be deleted and another criteria must be met before the rule is fulfilled. If set to “or,” the message only need to be seen or another criteria must be met before the rule is fulfilled.

Header Constraint. Enter a header field and string that will mark a message for removal. Example: Rule1.Subject:=Get Rich Now!

For the header Expires and Expiry-Date, the system will remove the message if the date value specified with these header fields is older than than the Number of days value. If multiple expiration header fields are specified, the earliest expiration date will be used.

Security and Access Control

This section describes the Administration Console interface elements that allow you to configure security settings and access control for Messaging Server. See Managing Servers with iPlanet Console for information on using Console to manage Messaging Server and other servers.

Encryption Tab

The Encryption tab allows you to enable SSL and to select the encryption ciphers that your Messaging Server uses for communication with clients.

For more information, see also “Enabling SSL and Selecting Ciphers” in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide.

Enable SSL. Check this box to enable SSL on your server. All other SSL encryption options listed here become available to you only when you enable SSL by checking this box.

Cipher Family. When you enable SSL, you can choose the cipher families you want to use. Sun Java System servers currently supports two types of cipher families: RSA and FORTEZZA. The internal token supports only RSA. If you’re using a FORTEZZA card, you’ll see the FORTEZZA cipher family in this list. Select the cipher families you want to use.

Token. From the drop-down list, choose the token you want to use. If the key is stored in the local key database, choose internal (software). If the key is stored on an external device, such as a Smart Card, choose one of the device-based tokens.

Certificate. From the drop-down list, choose your server’s certificate. If you’re not sure about which certificate to use, view the Certificate Management dialog box for more information. To view the Certificate Management dialog box, from the Console menu, choose Certificate Management.

Cipher Preferences. Click this button to open a window that allows you to view or edit the cipher preferences you’ve enabled (see Cipher Preferences Window).

Standard Buttons

Save. Click this button to save any settings you have made in the Encryption tab.

Cipher Preferences Window

The Cipher Preferences window allows you to view or edit cipher preferences. For more information about these ciphers, see “About Ciphers” in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide.

SSL is enabled if one or more of these ciphers is checked and your server has an installed server certificate.


Note	Export versions of Sun Java System Messaging Server may not support all ciphers available on Domestic U.S. versions.

IMAP Access Tab

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Configuring Client Access to POP, IMAP, and HTTP Services

Creating Access Filters for Services

Allow Filters

Allow. This field displays Allow filters--access-control rules that permit access to the IMAP service. Any IMAP client that matches any of the Allow filters in this field is allowed IMAP access. You can edit the contents of this field by clicking the Add button, or by selecting a line in this field and then clicking Edit or Delete.

Add. Click this button to open a window (see IMAP Allow Filter Window) that allows you to add a new Allow filter to the Allow field.

Edit. Click this button to open a window (see IMAP Allow Filter Window) that allows you to edit the Allow filter that is currently highlighted in the Allow field.

Delete. Click this button to delete the Allow filter that is currently highlighted in the Allow field.

Deny Filters

Deny. This field displays Deny filters--access-control rules that deny access to the IMAP service. Any IMAP client that matches any of the Deny filters in this field is denied IMAP access. You can edit the contents of this field by clicking the Add button, or by selecting a line in this field and then clicking either Edit or Delete.

Add. Click this button to open a window (see IMAP Deny Filter Window) that allows you to add a new Deny filter to the Deny field.

Edit. Click this button to open a window (see IMAP Deny Filter Window) that allows you to edit the Deny filter that is currently highlighted in the Deny field.

Delete. Click this button to delete the Deny filter that is currently highlighted in the Deny field.

Standard Buttons

Save. Click this button to save any settings you have made in the IMAP Access tab.

IMAP Allow Filter Window

The IMAP Allow Filter window allows you to add or edit Allow filters, the rules by which clients are permitted to access the IMAP service.

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Creating Access Filters for Services

Filter Syntax

ALLOW filter. Use this field to enter a new IMAP Allow filter or edit the one currently being displayed. A typical Allow filter has the format:

where serviceSpec is generally the name of the service to be accessed (imap in this case), and clientSpec is typically a host name, domain name, or wildcard name or pattern. Clients that match the information in clientSpec are to be allowed access to the service specified in serviceSpec.

Standard Buttons

OK. Click this button to save the entry or the edits you have made in the ALLOW filter field.

Cancel. Click this button to cancel the entry or edit, leaving the set of IMAP Allow filters unchanged.

IMAP Deny Filter Window

The IMAP Deny Filter window allows you to add or edit Deny filters, the rules by which clients are explicitly excluded from access to the IMAP service.

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Creating Access Filters for Services

Filter Syntax

DENY filter. Use this field to enter a new IMAP Deny filter or edit the one currently being displayed. A typical Deny filter has the format:

where serviceSpec is generally the name of the service to be denied (imap in this case), and clientSpec is typically a host name, domain name, or wildcard name or pattern. Clients that match the information in clientSpec are to be prevented from accessing the service specified in serviceSpec.

Standard Buttons

OK. Click this button to save the entry or the edits you have made in the DENY filter field.

Cancel. Click this button to cancel the entry or edit, leaving the set of IMAP Deny filters unchanged.

POP Access Tab

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Configuring Client Access to POP, IMAP, and HTTP Services

Creating Access Filters for Services

Allow Filters

Allow. This field displays Allow filters--access-control rules that permit access to the POP service. Any POP client that matches any of the Allow filters in this field is allowed POP access. You can edit the contents of this field by clicking the Add button, or by selecting a line in this field and then clicking either Edit or Delete.

Add. Click this button to open a window (see POP Allow Filter Window) that allows you to add a new Allow filter to the Allow field.

Edit. Click this button to open a window (see POP Allow Filter Window) that allows you to edit the Allow filter that is currently highlighted in the Allow field.

Delete. Click this button to delete the Allow filter that is currently highlighted in the Allow field.

Deny Filters

Deny. This field displays Deny filters--access-control rules that deny access to the POP service. Any POP client that matches any of the Deny filters in this field is denied POP access. You can edit the contents of this field by clicking the Add button, or by selecting a line in this field and then clicking either Edit or Delete.

Add. Click this button to open a window (see POP Deny Filter Window) that allows you to add a new Deny filter to the Deny field.

Edit. Click this button to open a window (see POP Deny Filter Window) that allows you to edit the Deny filter that is currently highlighted in the Deny field.

Delete. Click this button to delete the Deny filter that is currently highlighted in the Deny field.

Standard Buttons

Save. Click this button to save any settings you have made in the POP Access tab.

POP Allow Filter Window

The POP Allow Filter window allows you to add or edit Allow filters, the rules by which clients are permitted to access the POP service.

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Creating Access Filters for Services

Filter Syntax

ALLOW filter. Use this field to enter a new POP Allow filter or edit the one currently being displayed. A typical Allow filter has the format:

where serviceSpec is generally the name of the service to be accessed (in this case, pop), and clientSpec is typically a host name, domain name, or wildcard name or pattern. Clients that match the information in clientSpec are to be allowed access to the service specified in serviceSpec.

Standard Buttons

OK. Click this button to save the entry or the edits you have made in the ALLOW filter field.

Cancel. Click this button to cancel the entry or edit, leaving the set of POP Allow filters unchanged.

POP Deny Filter Window

This window allows you to add or edit Deny filters, the rules by which clients are explicitly excluded from access to the POP service.

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Creating Access Filters for Services

Filter Syntax

DENY filter. Use this field to enter a new POP Deny filter or edit the one currently being displayed. A typical Deny filter has the format:

where serviceSpec is generally the name of the service to be denied (in this case, pop), and clientSpec is typically a host name, domain name, or wildcard name or pattern. Clients that match the information in clientSpec are to be prevented from accessing the service specified in serviceSpec.

Standard Buttons

OK. Click this button to save the entry or the edits you have made in the DENY filter field.

Cancel. Click this button to cancel the entry or edit, leaving the set of POP Deny filters unchanged.

HTTP Access Tab

For more information, see the following sections in in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Configuring Client Access to POP, IMAP, and HTTP Services

Creating Access Filters for Services

Allow Filters

Allow. This field displays Allow filters—access-control rules that permit access to the HTTP service. Any HTTP client that matches any of the Allow filters in this field is allowed HTTP access. You can edit the contents of this field by clicking the Add button, or by selecting a line in this field and then clicking Edit or Delete.

Add. Click this button to open a window (see HTTP Allow Filter Window) that allows you to add a new Allow filter to the Allow field.

Edit. Click this button to open a window (see HTTP Allow Filter Window) that allows you to edit the Allow filter that is currently highlighted in the Allow field.

Delete. Click this button to delete the Allow filter that is currently highlighted in the Allow field.

Deny Filters

Deny. This field displays Deny filters--access-control rules that deny access to the HTTP service. Any HTTP client that matches any of the Deny filters in this field is denied HTTP access. You can edit the contents of this field by clicking the Add button, or by selecting a line in this field and then clicking either Edit or Delete.

Add. Click this button to open a window (see HTTP Deny Filter Window) that allows you to add a new Deny filter to the Deny field.

Edit. Click this button to open a window (see HTTP Deny Filter Window) that allows you to edit the Deny filter that is currently highlighted in the Deny field.

Delete. Click this button to delete the Deny filter that is currently highlighted in the Deny field.

Standard Buttons

Save. Click this button to save any settings you have made in the HTTP Access tab.

HTTP Allow Filter Window

The HTTP Allow Filter window allows you to add or edit Allow filters, the rules by which clients are permitted to access the HTTP service.

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Creating Access Filters for Services

Filter Syntax

ALLOW filter. Use this field to enter a new HTTP Allow filter or edit the one currently being displayed. A typical Allow filter has the format:

where serviceSpec is generally the name of the service to be accessed (http in this case), and clientSpec is typically a host name, domain name, or wildcard name or pattern. Clients that match the information in clientSpec are to be allowed access to the service specified in serviceSpec.

Standard Buttons

OK. Click this button to save the entry or the edits you have made in the ALLOW filter field.

Cancel. Click this button to cancel the entry or edit, leaving the set of HTTP Allow filters unchanged.

HTTP Deny Filter Window

The HTTP Deny Filter window allows you to add or edit Deny filters, the rules by which clients are explicitly excluded from access to the HTTP service.

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Creating Access Filters for Services

Filter Syntax

DENY filter. Use this field to enter a new HTTP Deny filter or edit the one currently being displayed. A typical Deny filter has the format:

where serviceSpec is generally the name of the service to be denied (http in this case), and clientSpec is typically a host name, domain name, or wildcard name or pattern. Clients that match the information in clientSpec are to be prevented from accessing the service specified in serviceSpec.

Standard Buttons

OK. Click this button to save the entry or the edits you have made in the DENY filter field.

Cancel. Click this button to cancel the entry or edit, leaving the set of HTTP Deny filters unchanged.

HTTP Proxy Tab

The HTTP Proxy tab allows you to enable the proxy authentication mechanism and to create allow filters for proxy authentication. (Proxy authentication allows other services, such as a portal site, to authenticate users and pass the authentication credentials to the Messenger Express login service.)

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Configuring Client Access to POP, IMAP, and HTTP Services

Creating Access Filters for HTTP Proxy Authentication

Allow Filters

Allow. This field displays Allow filters--access-control rules that permit access to the HTTP service. Any HTTP client that matches any of the Allow filters in this field is allowed HTTP access. You can edit the contents of this field by clicking the Add button, or by selecting a line in this field and then clicking Edit or Delete.

Add. Click this button to open a window (see HTTP Proxy Allow Filter Window) that allows you to add a new Allow filter to the Allow field.

Edit. Click this button to open a window (see HTTP Proxy Allow Filter Window) that allows you to edit the Allow filter that is currently highlighted in the Allow field.

Delete. Click this button to delete the Allow filter that is currently highlighted in the Allow field.

HTTP Proxy Allow Filter Window

The HTTP Proxy Allow Filter window allows you to add or edit Allow filters for HTTP proxy authentication.

For more information, see the following sections in the “Configuring Security and Access Control” chapter of Sun Java System Messaging Server Administration Guide:

Creating Access Filters for HTTP Proxy Authentication

Creating Access Filters for Services

Filter Syntax

ALLOW filter. Use this field to enter a new HTTP Proxy Allow filter or edit the one currently being displayed. A typical Allow filter has the format:

Standard Buttons

OK. Click this button to save the entry or the edits you have made in the Proxy ALLOW filter field.

Cancel. Click this button to cancel the entry or edit, leaving the set of HTTP Proxy Allow filters unchanged.

Logging and Log Files

This section describes the Administration Console interface elements that allow you to set logging options and view logs. See Managing Servers With iPlanet Console for information on using Administration Console to manage Messaging Server and other servers.

Log Files Content Tab

The Content tab allows you to view and search the contents of a given service’s log files.

For more information, see “Searching and Viewing Logs” in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide.

Log file info. This table displays the following characteristics of the log file currently selected in the Log filename list: file type, file size, number of lines, date and time last modified.

Log filename. This list displays the names of all log files for this service. Select a log file in the list to display its characteristics or view its content. Log-file naming conventions are described in Filename Conventions for Message Store and Administration Logs. Note that the current log file (the one being written to) has no numerical suffixes in its name.

View selected log. Click this button to open the Log Viewer, a window that allows you to search and view selected contents of the log file currently selected in the Log filename list. For more information, see Encryption Tab.

Log Viewer Window

The Log Viewer window allows you to configure searches on the contents of any Messaging Server log file, and to display the results of those searches.

For more information, see the following sections in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide:

Searching and Viewing Logs

Log Characteristics

Filter

Specify time period. Click this radio button to enter a starting and ending date and time for searching. If the button is selected, only events that occurred between the times you specify are displayed. Click the Edit button to access the Date-Time Window to specify the times.

For the past n Day(s). Click this radio button to specify a number of days, rather than a starting and ending date and time, for filtering log events. If this radio button is selected, you can enter an integer number in the field, in which case all log events since that number of days before the present day will be displayed.

Facility. Use this menu to specify that only log events of a specific server facility, or functional area (such as General, LDAP, or Network), are to be displayed. (Logged facilities are described in Categories of Logged Events.) You can select a single facility or all facilities.

Levels of detail. From the drop-down list, choose the level of log events to be displayed. You can select all levels or a single level; if you select a single level, events at that and all higher (less verbose) levels are included in the display. For more information about levels of detail, see “Logging Levels” in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide.

Pattern. Use this field to enter a text pattern and specify that only log events that contain a match to that pattern are to be displayed. For more information about text patterns, see “Search Parameters” in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide.

Update. Click this button to apply the currently entered filter criteria to the specified log file. Events that match the criteria are displayed in the Log entry field.

Log Entry

Log entry. This field displays (in two panes) logged events from the current log file. (The file whose contents are displayed here has been selected through the Content tab for a specific logged service; see LDAP Tab.)

Only entries that match the filter criteria specified by the other fields in this window are displayed. Each logged event occupies one line in the upper pane of the field. Entries in the upper pane may be truncated by the right edge of the field. However, the full text of any entry selected in the upper pane is displayed in the lower pane, wrapped to the width of the window.

For more information on log-entry format, see “Log File Format” in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide.

Standard Buttons

Date-Time Window

The Date-Time window allows you to specify the start and end dates for logs. The Date-Time window provides four areas: month, year, day of the month (in calendar format), and time (select the hour, minute, and second independently to change them).

Log Files Option Tab

The Option tab allows you to set logging characteristics for each type of service that Messaging Server logs.

For more information, see the following sections in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide:

Log Characteristics

Logging Levels

Defining and Setting Logging Options

Levels of detail. From the drop-down list, select the level of detail (verbosity) you want for this service’s logging, in terms of what events are to be logged.

When you select a specific level, events for that level and for all less verbose levels are logged. The default level of logging is Notice.

Directory path for log files. In this field, enter the location at which log files for this service are to be kept. Default is instanceDirectory/log/service, where instanceDirectory is the directory in which the files for this instance of Messaging Server reside.

Log File Rotation Policy


Note	Log data can be voluminous. Choose a directory that has adequate disk storage space and in which your log files will not overwhelm other files.

File size for each log. In this field, specify the maximum size permitted for a log file of this type; from the associated drop-down list, choose Mbytes or Kbytes. When the file currently being written to exceeds that size, subsequent events are written into a new file, named according to the conventions that are described in Filename Conventions for Message Store and Administration Logs.

Create new log every. In this field, specify the maximum age permitted for the log file currently being written to; from the associated drop-down list, choose hours or days. When the current log file exceeds that age, subsequent events are written into a new file, named according to the conventions that are described in Filename Conventions for Message Store and Administration Logs.



Caution	If you do not want to lose log data, make sure you adjust your log-rotation parameters and backup schedule (see “Defining and Setting Logging Options” in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide) so that files are not deleted before they have been backed up.

Log File Expiration policy

Number of logs per directory. In this field, specify the maximum number of log files permitted in the directory specified in the “Directory path for log files” field. When this number of files is exceeded, the oldest log file in the directory is deleted.

When total log size exceeds. In this field, specify the maximum size permitted for the sum of all log files of this service; from the associated drop-down list, choose Kbytes or Mbytes. When this maximum is exceeded, the oldest log file in the directory is deleted.

When free disk space is less than. In this field, specify the minimum free disk space permitted on the storage volume to which the log files are written; from the associated drop-down list, choose Kbytes or Mbytes. If this minimum is surpassed, the oldest log file in the directory is deleted.

When a log is older than. In this field, specify the maximum age permitted for any log file; from the associated drop-down list, choose Hours or Days. When a file exceeds that age, it is deleted.



Caution	If you do not want to lose log data, make sure you adjust your log-expiration parameters and backup schedule (see “Defining and Setting Logging Options” in the “Logging and Log Analysis” chapter of Sun Java System Messaging Server Administration Guide) so that files are not deleted before they have been backed up.

Standard Buttons

Save. Click this button to commit any settings you have made in the Log Files Option tab.