42.4 Configuring Domain Maintenance

You can configure the MTA to synchronize user information in the GroupWise Address Book with user information in eDirectory. You can also configure it to gather information about all messages that pass through the domain for tracking purposes.

42.4.1 Using eDirectory User Synchronization

As long as GroupWise administration is performed with the GroupWise Administrator snap-in to ConsoleOne running, user information is automatically synchronized between GroupWise and eDirectory. However, three situations can cause this automatic synchronization to be insufficient:

  • An administrator modifies user information in ConsoleOne without having the GroupWise Administrator snap-in running.

  • The user information was changed using Novell iManager.

  • The user information was changed using Novell eGuide and the GroupWise Identity Manager driver is not in use

In these situations, user information in eDirectory no longer matches corresponding user information in GroupWise. (User objects are the only GroupWise objects that can be modified without the GroupWise Administrator snap-in running. Modification of all other GroupWise objects requires the presence of the GroupWise Administrator snap-in.)

This section covers the following aspects of eDirectory user synchronization:

Enabling eDirectory User Synchronization

By default, eDirectory user synchronization is disabled. The MTA still performs all its other functions, but any changes made to user information in eDirectory without the GroupWise Administrator snap-in running do not appear in GroupWise until eDirectory user synchronization has been performed.

Although all MTAs can be enabled to perform eDirectory user synchronization, the minimum requirement is that at least one MTA be configured that way. If your GroupWise system spans multiple trees, at least one MTA in each tree must be configured to perform eDirectory user synchronization. The MTA server should have a local eDirectory replica for the MTA to access.

  1. In ConsoleOne, click Tools > GroupWise System Operations > eDirectory User Synchronization to display the eDirectory User Synchronization Configuration dialog box.

    eDirectory User Synchronization Configuration dialog box

    The eDirectory User Synchronization Configuration dialog box lists all domains in your GroupWise system, the MTA currently assigned to provide eDirectory user synchronization for each domain, and the current status of that agent’s ability to perform eDirectory user synchronization.

  2. Click Configure Agents.

    Configure Agents dialog box

  3. Select an MTA that you want to perform eDirectory user synchronization.

  4. If the eDirectory Access column for the MTA displays Yes, click Enable.

    or

    If the eDirectory Access column for the MTA displays No:

    1. Click Set Up eDirectory Access.

      Agent Access Control dialog box for a Linux or Windows MTA

    2. Fill in the following fields:

      Available LDAP Servers: Select the LDAP server that you want the MTA to log into in order to gain access to eDirectory, then click Set Preferred.

      LDAP User Name: Browse to and select the user that the MTA can use to log in as. The selected user must have rights to browse properties of User objects.

      Click Set Password, provide the password associated with the user selected above, then click Set Password.

      LDAP Group: Browse to and select the LDAP Group object for the server where the MTA runs. The LDAP Group object provides a table of attribute mappings between eDirectory and LDAP that the MTA needs in order to perform eDirectory user synchronization.

    3. Click OK to save the LDAP information.

      The eDirectory Access column for that MTA should now display Yes so that you can enable it.

  5. If your GroupWise system spans multiple trees, repeat Step 3 through Step 4 as needed to enable eDirectory user synchronization for at least one MTA in each tree.

  6. Click OK to return to the eDirectory User Synchronization Configuration dialog box.

    Each domain for which you have configured the MTA for eDirectory user synchronization should now display Enabled in the Status column.

    eDirectory User Synchronization Configuration dialog box

  7. If all domains are now enabled, click OK to return to main ConsoleOne window, then continue with Scheduling eDirectory User Synchronization.

    or

    If some domains are still disabled, continue with Assigning an eDirectory-Enabled MTA to Synchronize Other Domains.

Assigning an eDirectory-Enabled MTA to Synchronize Other Domains

After at least one MTA is performing eDirectory user synchronization, other MTAs not performing eDirectory user synchronization themselves can have an eDirectory-enabled MTA gather the eDirectory information for them.

In the eDirectory User Synchronization Configuration dialog box,

  1. Click a domain that still displays Disabled in the Status column.

    eDirectory Synchronization Configuration dialog box

  2. Select an MTA, then click Change Assignment.

    Select Synchronization Agent dialog box

  3. Select the MTA you want to perform eDirectory user synchronization for the selected domain, then click OK.

    The domain should now display Enabled in the Status column of the eDirectory User Synchronization Configuration dialog box.

  4. Repeat Step 1 through Step 3 until all domains in your GroupWise system are enabled for eDirectory user synchronization.

  5. Click OK to return to the main ConsoleOne window.

Scheduling eDirectory User Synchronization

By default, one eDirectory user synchronization event is scheduled at 1:00 a.m. daily for each MTA where eDirectory user synchronization is enabled.

You can edit the default event, or you can create one or more additional eDirectory user synchronization events to perform eDirectory user synchronization more frequently.

To schedule an eDirectory user synchronization event:

  1. In ConsoleOne, browse to and right-click the MTA object, then click Properties.

  2. Click GroupWise > Scheduled Events to display the Scheduled Events page.

    Scheduled Events property page

    The Scheduled Events page lists a pool of MTA events available to all MTAs in your GroupWise system if any events have already been created.

  3. Select the default event, then click Edit.

    or

    Click Create, then type a name for the event.

    Create Scheduled Event dialog box

    The name can include as many as 128 characters.

  4. Set Type to eDirectory User Synchronization.

  5. In the Trigger box, specify when you want the eDirectory user synchronization event to take place.

    You can have the synchronization event take place once a week, once a day, or at any other regular interval, at whatever time you choose.

  6. Specify the time of day when you want eDirectory user synchronization to take place.

  7. Click OK twice to close the scheduled event dialog boxes and save the eDirectory user synchronization event.

    ConsoleOne then notifies the MTA to restart so the eDirectory user synchronization event can be put into effect.

42.4.2 Enabling MTA Message Logging

Message logging is turned off by default, because it causes the MTA to use additional CPU and disk resources. However, gathering information about message traffic on your GroupWise system lets you perform many valuable tasks, including:

  • Tracking messages

  • Gathering statistics to help optimize your GroupWise system

  • Billing customers for messages delivered

  • Tracking messages from the MTA Web console and from GroupWise Monitor

When you enable MTA message logging, the MTA stores data about GroupWise message traffic as it processes messages. The stored data is then available for use by the MTA Web console Message Tracking feature and by the GroupWise Monitor Message Tracking Report option. In addition, third-party programs can produce customized billing, tracking, and statistical reports based on the information stored in the database.

To enable MTA message logging:

  1. In ConsoleOne, browse to and right-click the MTA object, then click Properties.

  2. Click GroupWise > Message Log Settings.

    Message Log Settings page

  3. In the Message Logging field, select a logging level to turn message logging on.

  4. In the Message Log Path field, specify the full path of the file where the MTA will record the logging information.

  5. Select the types of information you want to track:

    Correlate Delivery Status Reports: Select this option to maintain the relationship between user messages and their corresponding delivery status reports in the logged information.

    Collect Delivery Status Reports: Select this option to log delivery status reports as well as user messages.

    Collect Other Status Reports: Select this option to log user-requested information about messages sent, such as indicating that messages have been opened or deleted by the recipients.

    Track Administrative Messages: Select this option to log administrative messages such as database updates.

  6. In the Delete Reports After field, specify the number of days to retain reports on disk. Reports are automatically deleted after the specified time has passed.

  7. Click OK to save the MTA message log settings.

    ConsoleOne then notifies the MTA to restart so the new settings can be put into effect.

  8. For instructions about using the data that the MTA collects, see Tracking Messages and Section 71.3.7, Message Tracking Report.

Corresponding Startup Switches: You can also use the ‑‑messagelogsettings, ‑‑messagelogpath, ‑‑messagelogdays, and ‑‑messagelogmaxsize switches in the MTA startup file to configure MTA message logging.