In this section, we walk through the installation procedures that are documented in the official Lotus Notes Traveler product wiki to install the Lotus Notes Traveler 8.5.3 Upgrade Pack 1 on a Linux server in our lab. You can find the official Lotus Notes Traveler product wiki here.
In our lab environment, the Domino server was set up according to the recommendations on the "Before you install" link on the above hyperlink. Any of the user specific setup is addressed in 5.0 User deployment
Bookmark and reference to the regularly updated FAQ page
for the most current and common issues being seen with the Lotus Notes Traveler software.
It is advisable to stay at the latest fix level of 22.214.171.124+. You can keep track of the current level of code by referencing the recommended maintenance page.
Installing Lotus Notes Traveler
Use these steps to install the Lotus Notes Traveler on a Linux system:
- Stop Domino:
Ensure that you stop the Domino server before installing Lotus Notes Traveler. To stop the Domino server, run quit on the Domino console. If you have just installed Domino for the use of Lotus Notes Traveler, start the Domino server once before you install Lotus Notes Traveler to enure that the Domino server is able to initialize successfully. Then ensure the Domino server is stopped before you install Lotus Notes Traveler.
- Launch the installer:
Stop Domino double check.
- If installing from a DVD, insert the DVD into the DVD-ROM drive of the target system. Navigate to the DVD content and run launchpad.sh.
- If installing from an installation application, extract the tar file to a temporary location then run TravelerSetup.
The following figure shows the initial panel after start the installer.
Ensure that Domino server is stopped before you continue.
Review and accept the license agreement.
Choose if partitions are used:
Select Install multiple partitions to install Lotus Notes Traveler on multiple Domino partitions. Leave cleared if the Domino server is not partitioned or if you want to install on only one Domino partition.
It is possible to have multiple Domino instances running on the same Linux server in different partitions on the same machine. We do not do this in our scenario.
Software install directories:
Specify the directories in which the Domino program files and data files are located. The installer prompts asking you to enter the directory for the notes.ini file if it is not present in the Domino program files directory.
Note: When installing on a partitioned Domino server, you can install Lotus Notes Traveler on one or more of the Domino partitions. The installation panel pre-fills with all partitions detected by the installer. Add or remove partitions from the panel as required. The same installation options are used for all partitions indicated. In addition, you can add or remove partitions at a later time by either using the installer again or running the uninstaller.
Enter the values for the Domino user name and group name. These are existing users and groups on the Linux server used to run the Domino server, which are set up before installing and running the Domino server.
User home page:
The user home page is a useful starting place for users. It provides status information, links to client software, and user management options. If the user home page is set as the default website for this server, you can view the home page by pointing any browser to http(s)://hostname. When the default website is set to the user homepage, a mapping is made that automatically forwards the request from http(s)://hostname to http(s)://hostname/traveler. If the user home page is not set as the default, you can view the home page by pointing the browser to http(s)://hostname/traveler. This setting takes effect the first time Lotus Notes Traveler is started and can be manually changed at a later time.
Select Set user home page as default website for this server.
Client connection URL:
This is the value that you will have the users use to connect to the server. If you chose to not set the home page as the default website for this server you have to notify users of URL specifying /traveler on the end of the URL. You also have to specify the protocol either HTTP or HTTPS. It is good practice for the connecting devices to always configure their device to use the URL http(s)://hostname/traveler even if the default homepage is set to the Lotus Notes Traveler user home page. If you have decided to use a different port than the default port of 80 or 443 for SSL, you will need to add that to the URL as well. For example http(s)://hostname:port_number/traveler
Configure the client connection URL by indicating whether clients connect directly to the Lotus Notes Traveler server or connect through a proxy. If the URL is not currently known, select Configure later. In our scenario, we select Clients connect to this server directly.
Setting external server URL:
Specify the external server URL in the field. The URL is validated. Note any warning dialogs and continue.
In our case, we decided not to use SSL, and went with a HTTP URL. Because of this, we were presented with a warning which we noted, and continued:
Domino upgrade notification:
The Domino Upgrade Pack 1 is required for the XPages web administration and other Lotus Notes Traveler functionality. If this is not done, then Lotus Notes Traveler Version 8.5.3 Upgrade Pack 1 will not run properly.
If Domino 8.5.3 Upgrade Pack 1 is not detected on this system, indicate whether you would like Lotus Notes Traveler to install the prerequisites. This option is checked by default.
When Domino 8.5.3 Upgrade Pack 1 is not installed, select this option and install it. This option is checked by default.
Review your selections. If any changes are required, select Previous to update the selections, otherwise, select Install to continue.
Finishing the installation:
The installation commences and you can see the progress.
Select Done when the installation is completed. If any errors or warnings are reported, review the installation log and contact IBM Support to resolve any problems.
Domino startup and installation validation
On the next start up of Domino, you see that the Lotus Notes Traveler server also starts when the server is started.
You can validate the install is working correctly by accessing the server in a browser from a laptop, a desktop machine, or a device.