This section provides the procedure to upgrade Lotus Notes Traveler server from a previous version to 8.5.3 Upgrade Pack 1.
If you plan to convert your Lotus Notes Traveler environment to an HA configuration, Lotus Notes Traveler 8.5.3 Upgrade Pack 1 is required. You must first bring your Lotus Notes Traveler to the 8.5.3 Upgrade Pack 1 level then use the procedure described in 6.3 Moving from Lotus Notes Traveler 8.5.3 Upgrade Pack 1 stand-alone to a high availability environment
to convert the stand-alone Lotus Notes Traveler server to a high availability environment.
The general procedure of upgrading Lotus Notes Traveler to 8.5.3 Upgrade Pack 1 is as follows:
- Plan the upgrade and announce the upgrade schedule.
- Stop Lotus Domino and Lotus Notes Traveler.
- Backup the necessary files.
- Upgrade/migrate Lotus Domino.
- Upgrade/migrate Lotus Notes Traveler.
- Start Lotus Domino and Lotus Notes Traveler.
- Validate upgrade.
- (Optional) Modify parameters in notes.ini and settings in LotusTraveler.nsf.
Announcing the upgrade schedule
Before upgrading, you should announce the upgrade plan of Lotus Notes Traveler to users. The upgrade process implements a migration of the Lotus Notes Traveler's database to the new version. This database migration process generally will take 30-45 minutes to complete, but we have seen cases of it taking up to 90 minutes on larger deployments.
Users cannot access Lotus Notes Traveler during upgrade. If current Lotus Notes Traveler users, except for iOS device users, wish to use the new features in the clients on their devices, they will have to update their Lotus Notes Traveler application on mobile devices after upgrading the servers.
You should give users notice about the upgrade schedule and application upgrade procedure to avoid confusion caused by upgrading. After the upgrade when the devices first access the newly upgraded servers they will be prompted that there is a new version available for them to use. The user can choose to use this new version with the new features if they wish. The user can choose to check for an upgrade at a later time if they do not wish to upgrade at that time from the device.
Stopping Lotus Domino server
On the day of upgrading, first, run quit on the Domino console to shutdown Lotus Domino server.
Backing up files
Backup any files that are needed to restore your environment.
For Lotus Notes Traveler, backup the
/LotusTraveler.nsf and <Lotus Domino data>
Updating Lotus Domino
If your Lotus Domino version is lower than 8.5.3, you must migrate Lotus Domino server to 8.5.3.
If your Lotus Domino version is 8.5.3, skip this step and go to the Upgrade Lotus Notes Traveler section.
Complete these steps to migrate the Lotus Domino from Version 8.0.X or 8.5.X to 8.5.3.
- Remove the TRAVELER parameter from the ServerTasks list in notes.ini.
- Install Lotus Domino 8.5.3.
For the installation detail, see 3.0_Deploying_a_stand-alone_Notes_Traveler_environment.
- Start the Domino server and confirm that migration has succeeded.
During startup, you will be asked if you want to upgrade the design of the Domino directory. Consider which is acceptable for your environment and input Y(Yes) or N(No). If the Domino directory is customized, you might not want to upgrade it at this step.
- After validating the migration by checking there are not any errors, shutdown Lotus Domino.
Upgrading Lotus Notes Traveler
Complete these steps to upgrade Lotus Notes Traveler to 8.5.3 Upgrade Pack 1:
- Launch the installer:
- If installing from a DVD, insert the DVD into the DVD-ROM drive of the target system. If autorun is enabled for the system, the Common Launchpad starts automatically. If autorun is disabled, navigate to the DVD content and double-click launchpad.exe.
- If installing from an installation application, run the downloaded file, usually TravelerSetup.exe.
The following figure shows the the first screen.
- 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.
Ensure that Lotus Domino server is stopped and click Next.
Review and accept the license agreement.
(Linux only) Choose if partitions are used:
If you want to install multiple partitions, check the box. 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.
(Linux only) Domino credentials:
Enter the values for the Lotus Domino user name and group name. These are existing users and groups on the Linux server that are used to run the Domino server.
Domino upgrade notification:
The Domino Upgrade Pack 1 is required for the XPages web administration. If this is not done, then Lotus Notes Traveler 8.5.3 Upgrade Pack 1 will not run properly.
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.
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.
Starting Lotus Domino and Lotus Notes Traveler
When you start Lotus Domino, Lotus Notes Traveler is started automatically and its configuration will be updated.
The first time this is done, the database will be migrated to the 8.5.3 upgrade pack 1 level. This will take some time, so be patient and do not think that the process has hung and kill the process. You will know that this is complete when you see "Lotus Traveler: Server started"
If Lotus Notes Traveler does not start, run load traveler
on the Domino console. If you encounter the Java VM can't be created error as show in the following figure, run load http
on the Domino console.
If you loading HTTP failed as shown in the following figure, reinstall Lotus Domino 8.5.3 and Lotus Notes Traveler 8.5.3 Upgrade Pack 1.
You do not need to uninstall Lotus Domino and Lotus Notes Traveler before reinstallation.
If you see the message of "Lotus Traveler: SEVERE *systemException caught during Lotus Traveler configuration. Exception was NotesException: Role name [Administrator] not found",
you must give the Administrator
role to an user of LotusTraveler.nsf. From 8.5.3 Upgrade Pack 1, the LotusTraveler.nsf has Administrator role and at least one user must be assigned to this role to be the administrator. After updating, if no user has this role, the error message is given.
For details, see
Lotus Notes Traveler will not start after upgrade to version 8.5.3 Upgrade Pack 1
Validating the upgrade
After the server starts, access Lotus Notes Traveler from your desktop Web browser and mobile devices, and confirm that upgrading Lotus Notes Traveler is successful.
- Access the web-based administration page:
After upgrading, you can open LotusTraveler.nsf on the Lotus Domino Administrator client. You can also access it from a web browser.
Note: If you have configured Lotus Notes Traveler for an enterprise database (DB2 or SQL Server) the LotusTraveler.nsf is only available via the web browser.
Access http:///LotusTraveler.nsf and log in as an administrator of Lotus Notes Traveler.
- Access the user homepage:
You can access the user homepage from a web browser on both desktop client and mobile device.
Access http:///traveler and log in as a user.
When running the previous version Lotus Notes Traveler 8.3.5 Upgrade Pack 1, you can access the Notes Traveler using http:///servlet/traveler.
After upgrading, you can still use this old link. The server redirects automatically. This is done so that users do not have to reconfigure their devices after the upgrade to the new URL.
- Accessing Lotus Notes Traveler from mobile devices:
All devices excepted the iOS devices are required to upgrade the Lotus Notes Traveler application after the server is updated to version 8.3 5 Upgrade Pack1 to have the new features that were introduced in the 8.5.3 upgrade pack 1 version.
The following are the upgrading steps for the Android devices:
- For the users who access Lotus Notes Traveler server 8.5.3:
The users will receive notification to download and install the new version of Lotus Notes Traveler application Lotus Notes Traveler the first time when they try to synchronize their device the first time after the server is updated.
Download and install the application for Lotus Notes Traveler application for 8.3.5 Upgrade Pack 1 by completing the steps described in 5.3 Installation on an Android device.
- The user can also select to check for an upgrade from the "Lotus Traveler" application on their device at a later time.
- For the devices that access Lotus Notes Traveler 8.5.2:
These users must update the Lotus Installer.
For the installation procedure of other devices, see the following sections.
- When the device accesses the Lotus Notes Traveler the first time after the server is upgraded to Lotus Notes Traveler 8.5.3 Upgrade Pack 1, user will receive upgrade notification.
Tap the notification and select Install.
- Replace application:
Review what can be accessed by Lotus Installer and select Install.
- Open Lotus Installer:
When installation finish, tap Open.
- Start to update Lotus Traveler:
The new Lotus Installer notify you that you can update Lotus Traveler. Select Install.
- Uninstall the old application:
Before installing the new version, you have to uninstall the old application. Select OK.
- Finish uninstallation:
When uninstallation finishs, tap OK.
- Install the new Lotus Notes Traveler application:
After uninstallation, installation of the new Lotus Notes Traveler application starts.
- Install Lotus Notes Traveler application for 8.3.5 Upgrade Pack 1 by completing the steps described in 5.3 Installation on an Android device.
5.4 Installation on a Windows mobile device
5.5 Installation on a Symbian or Nokia device
Using Lotus Notes Traveler from mobile devices:
After upgrading the server, you can use Lotus Notes Traveler immediately. Resynchronization between the server and devices does not occur. Check that each component runs correctly.
There are new notes.ini parameters and security settings for Lotus Notes Traveler 8.5.3 Upgrade Pack 1.
You can manage the security settings in LotusTraveler.nsf
(either by the conventional access through the Domino Administrator interface or the new web interface).
If necessary, change the settings and test these before you release the Lotus Notes Traveler system to users.