MAIL


Running the mail conversion utility to enable a mail file for IMAP
Note If you used the IBM® Lotus® Domino® registration process to add a user account, and set the user's mail system type to IMAP, Domino automatically enables the mail file for IMAP use.

After you run Fixup on the mail file, run the mail conversion utility (the Convert task) to enable IMAP-specific features in the mail file. The conversion utility sets an option bit in the database indicating that this database is IMAP enabled. After you enable a mail file for which the format preference is set to MIME, the Router automatically adds special IMAP attributes to new messages delivered to the database. These attributes provide IMAP clients with summary information which enables them to download message headers more efficiently. To ensure the best performance, after the initial conversion completes run the conversion utility a second time, using the -h option to add these attributes to messages that were already in the mail file at the time of the initial conversion.

For users with multiple mail file replicas -- for example, users with mail files on clustered servers -- you must independently enable each replica for IMAP access. Because Domino does not replicate IMAP database items between databases, by default, when you create a new replica of an IMAP-enabled mail file, it is not enabled for IMAP use.

After the conversion utility enables a mail file for IMAP, the following information is added to the bottom of the Information tab of the mail file's Database Properties dialog box:


Deciding whether to convert mail files manually or automatically

By default, when a user connects to the IMAP service, the service checks whether the user's mail file is currently enabled for IMAP. If the mail file is not already enabled, the IMAP service automatically launches the conversion utility to format it for use with IMAP. To prevent conversions from occurring during login, change the default configuration by disabling automatic conversion.

Although the IMAP service can automatically convert mail files, consider manually converting them before users first log in to the IMAP server to ensure that mail files are properly converted. By performing conversions ahead of time, you can ensure that users are not confronted with conversion errors that they are unable to recover from. For example, because the conversion utility requires that a mail file be at least at ODS version 41, for mail files that use an earlier ODS version you must run Compact before converting the mail file; using automatic conversion would fail. Similarly, in databases where some type of internal corruption has occurred (for example, an invalid note, or corrupt meta data), you must run Fixup against the mail file before running the conversion utility.

Finally, you must run conversions manually to enable mail files in the other users' and public folders namespaces. Automatic mail file conversion can occur only for the personal mail file of the currently authenticated user.

Note The Convert task was created specifically for converting mail files to a new design. As such, it does some mail-specific things, like converting categories to folders. It is also a server task that can be run against many databases at once. Replace Design is a menu selection from the client, used to replace the design of any database. It simply replaces the current design elements with the ones from whatever template you select. It does not do any mail-specific actions, such as Convert.

To manually convert mail files for use with IMAP
You can run the mail conversion utility on a single mail file or on all mail files in a directory.

1. At the server console of the Domino server on which you want to enable mail files, shut down the Router by entering:


2. Load the mail conversion utility by entering the following command:
3. After you finish enabling mail files for IMAP on this server, load the Router by entering:
4. Configure IMAP client software.

Related topics