Home
IBM® Domino 10.0.1 Documentation
Welcome to the IBM® Domino 10.0.1 Administrator Help.
Configuring
Use this information to configure an IBM® Domino® network, users, servers (including Web servers), directory services, security, messaging, widgets and live text, and server clusters. Also use this information to set up IBM iNotes® on a server using Domino Off-Line Services (DOLS).
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.
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.

IBM® Domino 10.0.1 Documentation
Welcome to the IBM® Domino 10.0.1 Administrator Help.
- What's new in IBM® Domino® 10?
  Learn about all of the new features for administrators in IBM® Domino® 10.
- Overview
  Welcome to IBM® Domino® Administrator Help.
- Installing
  Use this documentation to install the IBM® Domino® server and subsequently deploy the IBM Notes® client.
- Planning
  Use this topic as an overview of planning task.
- Configuring
  Use this information to configure an IBM® Domino® network, users, servers (including Web servers), directory services, security, messaging, widgets and live text, and server clusters. Also use this information to set up IBM iNotes® on a server using Domino Off-Line Services (DOLS).
  - Configuring a network
    This section presents the planning concepts and setup procedures necessary for a successful IBM® 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.
  - Editing the NOTES.INI file
    You should rarely, if ever, need to modify a server's or client's NOTES.INI file. The NOTES.INI file contains many settings that Domino® and Notes® rely on to work properly. An accidental or incorrect change may cause Domino or Notes to run unpredictably. Therefore, you should edit the NOTES.INI file only if special circumstances occur or if IBM® Support Services recommends that you do so.
  - Configuring directory services
    This section describes how to plan, set up, and use IBM® 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 IBM® 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 IBM 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 IBM® 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 IBM® Domino® messaging system to improve performance and meet the specific needs of your organization.
  - Configuring iNotes®
    IBM® iNotes® (previously IBM Domino® Web Access) provides IBM 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 IBM iNotes.
  - Configuring Web servers
    This section describes how to set up the IBM® Domino® Web server, the Domino Web Navigator, and other Web servers such as IBM HTTP.
  - 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.
- Securing
  This section describes IBM® Domino® security features, including execution control lists, IDs, and SSL.
- Administering
  This documentation provides information about the administration tools for managing and monitoring IBM Domino® servers and databases.
- Tuning
  Use this information to improve IBM® Domino® server, Domino Web server, and messaging performance through the use of resource balancing and activity trends, Server.Load commands, advanced database properties, cluster statistics, and the Server Health Monitor.
- Troubleshooting
  This section describes how to find and solve problems with IBM® Domino® server and Administrator client.
- Glossary

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.

Procedure

Shut down the server.
From the Microsoft™ Windows™ command prompt, change to the Domino® program directory. For example, if you installed Domino® in the default location, enter:
```
cd c:\ibm\domino
```
To run Fixup on a specific mail file, enter:
```
nFixup path\mailfile
```
where path is the database path relative to the Domino® data directory and mailfile is the name of the mail file database. For example, to run Fixup on the mail file database USER.NSF in the DATA\MAIL folder, enter:
```
nFixup mail\user.nsf
```
Note: If transaction logging is enabled on the server, run Fixup with the -j switch, for example:
```
nFixup -j mail\user.nsf
```

What to do next

After you run Fixup, you can run the mail conversion utility to enable the mail file for IMAP.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.