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.
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
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.
        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.

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.

About this task

To repair a corrupted IMAP mail file, perform these tasks:

Run Fixup.
Disable the mail file for IMAP use.
Re-enable mail file for IMAP use.

If you are unable to repair the mail file, contact Support for assistance.

To repair a corrupted IMAP mail file, the Fixup task requires exclusive access to the mail file database.

Procedure

Shut down the server.
From a command prompt, change to the Domino® program directory. For example, if you installed Domino® in the default location, enter: .
```
cd c:\HCL\domino
```
To run Fixup on a specific mail file in the MAIL directory, enter:
```
nFixup path\mail file
nFixup mail\user.nsf
```
Note: If transaction logging is on, run Fixup with the -j switch, for example:
```
nFixup -j mail\user.nsf
```

Disabling an IMAP mail file

About this task

If you need to disable IMAP-specific features in a mail file, run the mail conversion utility with the -e- option file. The following example removes the IMAP capability of the mail database USER.NSF in the \MAIL subdirectory of the Notes® data directory:

load convert -e- mail\user.nsf

Note: On UNIX™ systems, use a forward slash (/) as the hierarchy separator, rather than a backslash (\). For example, enter:

load convert -e- mail/user.nsf

What to do next

After disabling the mail file, you can re-enable it. For more information on enabling a mail file, see Running the mail conversion utility to enable a mail file for IMAP in the related information.