4.3.1 Lotus Domino configurationAdded by Whei-Jen Chen on January 3, 2013 | Version 1 (Original)
The Domino server for Lotus Notes Traveler should be set up as you would your mail servers. Note that Domino Enterprise version is required for Lotus Notes Traveler HA. Although you should follow your normal setup procedures, there are a few items you should be aware of on the setup.
Considerations for the Domino installation:
Considerations for the Domino installation on Linux
- Ensure the installed version of Domino is the most recent version that matches the version of Lotus Notes Traveler you intend to install. For example, if you are planning to install Lotus Notes Traveler 8.5.3 Upgrade Pack 1, the installed version of Domino should be 8.5.3 as well. Domino will automatically be updated to 22.214.171.124 when the Upgrade Pack 1 for Lotus Notes Traveler is installed. As a further caveat, always check to see if there are any fix packs that should be installed. That can be found at Fix Central. If the most recent version of Domino is a higher version than what is installed on you Administration server, you will need to consider upgrading the installed version on your Administration server, or upgrade to the same template for the Public Address book as what will be used on the Lotus Notes Traveler server, or take steps to not allow the proliferation of the address book on the Traveler server to other servers in your domain.
- The Domino server that hosts Lotus Notes Traveler must have access to the users mail servers with Manager and delete privileges to mail files. When a user deletes an email on their mobile device, the deletion is carried out by the Lotus Notes Traveler server. This access may granted by adding the Lotus Notes Traveler server to the LocalDomainServers group in many cases, but check your environment on the best method.
- Each user must have an HTTP password in their person document, or directory assistance must be configured so that the user ID and password can be validated.
- Each user should have an Internet address specified in their person document. In general, mobile devices work better with Internet addresses than with Domino style addresses.
- for example - Internet address: firstname.lastname@example.org
- Each user must have an entry in the Lotus Notes Travelers address book, names.nsf, or directory assistance must be configured so the users can be found.
- If you are using Internet Site documents and plan to sync Apple devices, ensure that the Options command is enabled on the Configuration tab of the Internet Site document. This is required to register and sync Apple devices.
- Set 'More name variations with lower security' in the Internet authentication parameter on the Security tab of the server document. This action resolves many login issues.
- Lotus Notes Traveler requires the following notes.ini parameters during startup. Ensure they have the correct values, or Lotus Notes Traveler may fail to start.
- Each Lotus Domino server that is hosting the Lotus Notes Traveler service must have the HTTP web server component installed. Note the HTTP task should not be in the notes.ini ServerTasks line. Traveler will start this task automatically when it has launched.
- Note that Lotus Notes Traveler does not support Roaming Users or Roaming Profiles. All of the user's data must exist in the mail file on the mail server.
- The Lotus Notes Traveler installation must be done as the root user for proper access; otherwise, the server may not be able to start after installation due to incorrect file permissions. The Lotus Notes Traveler utility (travelerUtil) when setting up the HA environment must also be run as the root user. Running the installer as a user other than root user may cause the install application to hang and not complete successfully.
- If you login to a Linux system as a non-root user and SU to root, you may see an error trying to launch the Lotus Notes Traveler installer in UI mode, similar to java.lang.noclassdeffounderror sun awt x11graphicsenvironment. This depends on the system configuration, but you can work around by either logging in to the system using the root user or by simply running the installer in silent mode (for more information, see Installing in silent mode on Linux operating systems in the Domino wiki).
- Ensure the Domino user's password is not expired or it may cause the Lotus Notes Traveler installation application to hang because the OS will prompt the installer to change the password.
In this scenario we set up a new Traveler pool, consisting of two new Lotus Notes Traveler servers. Creating the new Domino Servers is the first step in setting up the Lotus Notes Traveler pool. When setting up the Traveler servers, ensure to follow your corporate standards when setting up Domino servers. The configuration tasks include:
- Registering the Domino Server to create the server.id
Setting up the Domino Server to ensure the values are correct for the Traveler server
We illustrate the Domino Server configuration on a Windows system.
Registering a new Domino Server
From the the Domino administration client tool bar menu, click the Configuration
tab, select Registration -> Server
Enter the information for the new server that you are registering with the Domino environment.
Setting up the new Domino server
Follow the steps below to setup the Domino server:
- Start the server setup by launching the Lotus Domino Server. On Windows system, click the Lotus Domino Server icon. On a Linux system, open a command prompt to the notesdata directory and run /opt/ibm/lotus/bin/server from the command line. When starting Domino Server for the first time, Domino server launches the configuration steps automatically.
- Select Set up an additional server to add this new Domino Server to the existing Domino domain.
- If you have an Administrator ID registered, select The server ID file is stored in the Domino Directory and provide a password. Optionally, if you did not use a password for the server.id created, you must copy the ID file to the server or network drive and select Browse to locate the ID.
- Enter the server name.
Enter the same server name that you have registered with the Domino administration client. This field is automatically filled in for you after you have selected the ID in the previous step.
- Select the internet services.
The Lotus Notes Traveler requires the HTTP services, so select Web Browser (HTTP Servers).
- Verify the network settings and click on Next.
- Enter the server name and, optionally, the network address for the Administration or Hub server from which the Lotus Notes Traveler server will receive updates.
- Select Set up as a primary Domino Directory to set the directory type to be used for this Domino server. Also select Create a replica of the Directory Assistance database to create a replica if one is in use in your environment and is to be used on the Lotus Notes Traveler sever.
- Secure the server by selecting Prohibit Anonymous access to all databases and templates. Select Add LocalDomainAdmins group to all databases and templates to include LocalDomainAdmins to all access control lists (ACL).
- Verify the installation option selected. If you are satisfied with all of the selections, Click Setup to start the Domino Server setup.
- It will take several minutes to compete the Setup. Progress can be monitored as shown below. When complete click Done.
- This completes the configuration. Reboot the operating system to ensure the Domino server launches automatically.