Home
Configuring
Use this information to configure your network, users, servers (including Web servers), directory services, security, messaging, widgets and live text, and server clusters.
Configuring users and servers
Topics in this section describe how to set up users and servers.
Configuring messaging
This section provides an overview of messaging and describes how to set up mail routing, how to set up and customize mail servers, and how to track mail.
The IMAP service
The Domino® server supports the Internet Mail Access Protocol (IMAP4rev1), defined in RFC 2060, for reading mail. The Domino IMAP service lets users with IMAP mail clients access mail files on a Domino server. The IMAP service differs from the POP3 service in that users are not required to download messages to a local computer to read and manipulate them. Users can work with messages over the network, while the messages remain on the server.
Setting up IMAP users
To set up IMAP users, you can create a full-text index of the mail file so the IMAP user can search for information in the file.
Preparing a mail file for IMAP access
To support access from IMAP clients, mail files must be specially modified to store IMAP folder and message attributes as database items. If you used the Domino® registration process to create a user, and set the user's mail system type to IMAP, Domino automatically performs the steps required to prepare the mail file for IMAP use. Otherwise, you must complete several tasks to prepare a mail file to support IMAP access.
Convert utility options
The convert utility provides several options for the Convert task useful for IMAP mail databases. The convert -d option can be used to convert non-mail databases.

Configuring
Use this information to configure your network, users, servers (including Web servers), directory services, security, messaging, widgets and live text, and server clusters.
- Configuring a network
  This section presents the planning concepts and setup procedures necessary for a successful HCL Domino® deployment over a network. It provides information on network protocols from a Domino perspective but does not attempt to provide general network information.
- Configuring users and servers
  Topics in this section describe how to set up users and servers.
  - Understanding the Server document
    The Server document is set up when you register a server. It contains many of the settings that define how your server operates.
  - Policies
    Use Domino® policy settings to control how users work with Notes®. A policy is a document that identifies a collection of individual policy settings. Policy settings documents define a set of defaults that apply to the users and groups to which the policy is assigned. You can change policy settings and they will be automatically applied to the assigned users and groups.
  - Defining default settings for Notes® user registration
    Before you register new Notes® users, you can specify default settings that apply to all users. Default settings simplify user registration and ensure user settings consistency. You can define many default settings, such as what mail server users have or what certifier ID to use for user registration. You can also specify a default workstation execution control list (ECL) to protect data from unauthorized workstation access.
  - Using groups
    Groups are lists of users, groups, and servers that have common traits. They are useful for mailing lists and access control lists. Using groups can simplify administration tasks.
  - Replicas
    You can make a database available to users in different locations, on different networks, or in different time zones, by creating replicas of the database.
  - Calendars and scheduling
    The calendar and scheduling features allow users to check the free time of other users, schedule meetings with them, and reserve resources, such as conference rooms and equipment.
  - Editing the notes.ini file
    The Domino and Notes notes.ini files contain the settings required for the server and client to operate correctly. If you modify or add settings in a notes.ini file, do so cautiously and never edit the file directly with a text editor.
  - Configuring directory services
    This section describes how to plan, set up, and use HCL Domino® directory services.
  - Configuring messaging
    This section provides an overview of messaging and describes how to set up mail routing, how to set up and customize mail servers, and how to track mail.
    - The Domino® mail router
      The Domino® mail router (the Router) is a special server task responsible for the delivery and transfer of the messages in MAIL.BOX. Delivery refers to moving messages from MAIL.BOX into a local mail file or database; while transfer refers to sending messages from MAIL.BOX across the network to another server.
    - The POP3 service
      POP3 (Post Office Protocol Version 3) is an Internet mail protocol that allows a user running a POP3 client -- for example, the Notes® POP3 client, Eudora Pro, or Microsoft™ Outlook Express® -- to retrieve mail from a server that runs the POP3 service. You can set up a Domino® server to run the POP3 service. The Domino server receives and stores mail for POP3 users, who can then connect to the server to retrieve their mail.
    - The IMAP service
      The Domino® server supports the Internet Mail Access Protocol (IMAP4rev1), defined in RFC 2060, for reading mail. The Domino IMAP service lets users with IMAP mail clients access mail files on a Domino server. The IMAP service differs from the POP3 service in that users are not required to download messages to a local computer to read and manipulate them. Users can work with messages over the network, while the messages remain on the server.
      - How Domino® modifies mail files to support IMAP
        IMAP clients use a standard Domino® mail file that must be specially enabled for IMAP. If you enable IMAP access for the mail file of a registered Notes® user, the user can access the file from either the Notes client or from an IMAP client.
      - Setting up the IMAP service
        The Domino® IMAP service can be run on any Domino server on which a TCP/IP port is configured.
      - Starting and stopping the IMAP task
        You can load the IMAP task manually or start it automatically when you start the Domino® server.
      - Customizing the IMAP service
        You customize the IMAP service by editing the Server document and Configuration Settings document.
      - Setting up IMAP users
        To set up IMAP users, you can create a full-text index of the mail file so the IMAP user can search for information in the file.
        Setting up the Person document for an IMAP user
        To access mail files on the Domino® server, an IMAP user must have a Person document in the Domino Directory. For users who already have Person document, edit settings in the existing document as necessary to provide IMAP support. If a user does not have an existing Person document, you must create a new one. You can create a Person document manually, or use the Domino registration process to create the Person document automatically. If you use the Domino registration process, select IMAP in the Mail system field of the Register Person dialog box.
        Creating a mail file for an IMAP user
        Each IMAP user must have a mail file on the HCL Domino® server. You can create the mail file automatically during user registration, or you can manually create a mail file. If the user is already a registered HCL Notes® user who has an existing Domino mail file and if you set up the user's Person document for IMAP access, the user can access the mail file from an IMAP client.
        Preparing a mail file for IMAP access
        To support access from IMAP clients, mail files must be specially modified to store IMAP folder and message attributes as database items. If you used the Domino® registration process to create a user, and set the user's mail system type to IMAP, Domino automatically performs the steps required to prepare the mail file for IMAP use. Otherwise, you must complete several tasks to prepare a mail file to support IMAP access.
        Running Compact to update the ODS version of a mail file
        To update the ODS version of a mail file, you can run copy-style compacting (compact -c) on it.
        Running Fixup to prepare a mail file for IMAP use
        After you run Compact on a user's mail file to ensure that it uses the correct file format, run the Fixup task on the mail file. Because the Fixup task requires exclusive access to the mail file database, you must shut down the server before running Fixup. You do not need to run Fixup on mail files that are based on a Domino® Release 5 or later mail template.
        Running the mail conversion utility to enable a mail file for IMAP
        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 the 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.
        Convert utility options
        The convert utility provides several options for the Convert task useful for IMAP mail databases. The convert -d option can be used to convert non-mail databases.
        Preserving folder references during upgrade of IMAP mail files
        In earlier releases of Domino®, the IMAP service used hidden folder reference views in the mail template to retrieve IMAP folder and message data. By contrast, in newer releases, the Domino IMAP service doesn't use folder references. Instead, it enables native storage of IMAP folder and message attributes in the mail file, thus eliminating the need for hidden views in the mail template.
        Using the conversion utility to add IMAP summary attributes to messages
        The IMAP service uses special IMAP summary attributes ($Content_Type, IMAP_BodyStruct, and IMAP_RFC822Size) in messages to facilitate the process of sending message headers in response to client requests. After you convert a mail file for IMAP use, for users who receive messages in MIME format, the Router automatically adds these items to new messages it delivers.
        Re-enabling a corrupted IMAP mail file with fixup
        If an IMAP-enabled mail file becomes corrupted, you can repair it by performing a set of tasks.
        Configuring IMAP client software
        After you set up an HCL Domino® server to run the IMAP service, users can access their mail files on the Domino server from any IMAP mail client. The IMAP service supports all IMAP-compliant clients -- for example, Microsoft™ Outlook and Outlook Express®, Qualcomm Eudora, Cyrusoft Mulberry, and PC-Pine.
    - Customizing mail
      After you set up basic mail routing, you can customize the HCL Domino® messaging system to improve performance and meet the specific needs of your organization.
  - Configuring iNotes®
    HCL iNotes® provides HCL Notes® users with browser-based access to Notes mail and to Notes calendar and scheduling features. Administrators specify mail policy and security policy settings as well as notes.ini file settings to complete the full implementation of HCL iNotes.
  - Configuring Web servers
    This section describes how to set up the HCL Domino® Web server, and the Domino Web Navigator.
  - Setting up a cluster
    Setting up a cluster includes the tasks of creating and verifying that it is working correctly, and then setting up user access, mail, replications, size quotas, directory assistance, roaming, web navigation, and use of a private LAN in the cluster.
  - Configuring Widgets and Live Text
    Widgets and Live Text enables end users to see and act on Live Text in supported documents, including HCL Notes® mail, using XML extensions (widgets) created specifically for their use.
  - Domain Search
    Notes® client and Web users can use Domain Search to search an entire Domino® domain for database documents, files, and attachments that match a search query.

Convert utility options

The convert utility provides several options for the Convert task useful for IMAP mail databases. The convert -d option can be used to convert non-mail databases.

Table 1. Convert utility options
Option	Use
-e	Enables mail files for IMAP use.
-h	To enable clients to download message headers more efficiently, the Convert task processes all messages in the mail file in the order in which they are listed in the mail file's All Documents view and adds the special IMAP attributes ($Content_Type, IMAP_BodyStruct, and IMAP_RFC822Size) to messages that don't have them. Because the Convert task is single-threaded, and this option requires the Convert task to process every message in the mail file, it is resource-intensive and can take a long time, especially for mail files where messages must also be converted from Notes® rich text to MIME format. This option may also cause a significant temporary increase in database size. Running compact -c on a mail file after using the -h option is recommended. You cannot use this option in combination with the -e switch.
-m	Enables or disables folder references needed for IMAP.
-o	Removes from messages the IMAP items used to provide more efficient header retrieval. You may use this option in combination with the -h option, but not with the -e option.
-e-	Disables IMAP access to mail files (note the minus symbol in the command).

How the conversion utility handles unread marks

In previous releases of Notes® and Domino®, mail files maintained separate sets of unread marks for IMAP clients and Notes® clients, with IMAP-enabled mail files relying on special template views to indicate that a message was read. With the introduction of native IMAP, a mail file enabled for IMAP displays a consistent set of unread marks to the IMAP and Notes® clients opening the file.