Administering IBM Traveler
Information on planning, installing, configuring, and administering IBM Traveler.
- Planning for installation and configuration
  There are many installation and configuration considerations you should review before installing the IBM Traveler server.
- Installing the IBM Traveler server
  The following topics describe options for installing and uninstalling the server:
  - Before you install
    There are IBM® Domino®, Linux™ operating system, and Highly Available (HA) considerations to be aware of when planning the IBM Traveler server installation.
  - Installing the server on Windows™ operating systems
    Begin here to install the sever on Windows™.
  - Installing the server on Linux™ operating systems
    Begin here to install the server on Linux™.
  - Installing IBM® Traveler on IBM® i
    Several steps are required to install IBM® Traveler server on IBM i operating systems.
    - Updating Java on IBM i
      Before installing IBM Traveler, ensure that the IBM i server is running Java 8 SR6 8.0.
    - Preparing to install the IBM® Traveler server from a download image on IBM® i
      You can download an installation package for the IBM® Traveler Server for IBM i. If you are installing from physical media, skip this step.
    - IBM Traveler multi-version support considerations on IBM i
      With version 9.0.1, you can install multiple releases of IBM Traveler on one IBM i system with the primary language as English (2924). This means that different versions of IBM Traveler servers will work independently.
    - Pre-accepting the IBM® Traveler software agreements on IBM® i when installing from a CD
      If you are installing IBM® Traveler from a CD, it is highly recommended that you display and accept the IBM Traveler software agreements before starting the installation.
    - Running the IBM® Traveler server installation program on IBM® i
      Run the installation program on the machine where you plan to install an IBM® Traveler Server.
    - Verifying the IBM® i library list
      While a single version of IBM® Traveler supports multiple languages, the IBM Traveler language feature for the licensed program is packaged using the English language feature code. You should verify that QSYS2924 feature code is also included in your library list, if English is not the primary language of your system.
    - Adding IBM® Traveler to an IBM® i Domino® server
      There are several steps to setting up a IBM® Traveler server to run on IBM i.
    - Changing existing IBM® Traveler server settings
      You can change existing IBM® Traveler server settings on IBM i, such as the Host IP address or ports using the command CHGNTSDOM.
    - Updating existing IBM Traveler server on IBM i
      You can update existing IBM Traveler servers on IBM i using the new command UPDNTSDOM. This command can be used when multiple IBM Traveler releases are installed on one IBM i system.
    - Enabling IBM® Traveler using a 64-bit JVM on IBM®
      IBM Traveler uses 32 bit JVM by default. There are two methods to enable 64 bit JVM.
    - Troubleshooting the installation of IBM® Traveler on IBM® i
      You may run into unique problems while installing IBM Traveler on IBM i systems.
  - Installing using a customized JVM on Windows™ operating systems
    You might want to use a customized Java™ virtual machine (JVM) during the installation. For example, if your custom JVM has been enabled to work with a screen reader, such as JAWS for Windows™. Make sure that you use Java 1.6 or later.
  - Installing using a customized JVM on Linux™ operating systems
    You might want to use a customized Java™ virtual machine (JVM) during the installation. For example, if your custom JVM has been enabled to work with a screen reader, such as JAWS for Linux™. Make sure that you use Java 1.6 or later.
  - Installing in silent mode on Windows™ operating systems
    Follow these steps to perform an automated installation of the IBM Traveler server.
  - Installing in silent mode on Linux™ operating systems
    Follow these steps to perform an automated installation of the IBM Traveler server.
  - Installing multiple instances of IBM Traveler on Linux™
    You can install multiple instances of the IBM Traveler server on Linux™ operating systems.
  - Installing IBM Traveler for High Availability
    Every server that is to be deployed as part of a IBM Traveler High Availability pool is first deployed the same way you install a stand-alone server.
  - Uninstalling IBM Traveler on Windows and Linux
    To uninstall IBM Traveler from an IBM® Domino® server on Windows or Linux, use the IBM Traveler uninstallation program.
  - Uninstalling IBM® Traveler on IBM® i
    You can remove IBM® Traveler files from a Domino® server without deleting the IBM Traveler software from your system.
- Configuring IBM Traveler server
  The IBM Traveler configuration settings are part of the Domino® server document. The first time that the IBM Traveler server is started, it performs any necessary configurations. You might want to perform additional configurations beyond the basics. The following topics describe additional configuration options.
- Administering IBM Traveler
  The IBM Traveler server component functions as a Domino® server add-in task and responds to Domino server console commands. Topics in this section describe common administrative tasks for administering a IBM Traveler server.

Updating Java on IBM i

Before installing IBM Traveler, ensure that the IBM i server is running Java 8 SR6 8.0.

About this task

Starting with version 9.0.1.19, IBM Traveler requires JVM 8 32-bit as the default JVM for all supported versions of IBM i, to align with default JVM version changes for Domino 9.0.1 FP9.

Note: To use the 64-bit JVM, set JavaUse64BitJVM=1 in the NOTES.INI of the Traveler server.

For more information on using Java with IBM i, see the following articles:

Table 1 lists the default JVM versions for Traveler 9.0.1.19 with Domino 9.x on the supported versions of IBM i.

Table 1. Default JVMs for Traveler on IBM i
IBM i version	Traveler 9.0.1.19 for Domino 9.0	Traveler 9.0.1.19 for Domino 9.0.1
IBM i 6.1	Not supported	Not supported
IBM i 7.1	JVM 8 32-bit	JVM 8 32-bit
IBM i 7.2	Not supported	JVM 8 32-bit
IBM i 7.3	Not supported	JVM 8 32-bit

Note:

JVM 8 is not supported on IBM i 6.1.
Domino 9.0 does not support IBM i 7.2 and 7.3.
Domino 9.0.1 does not support IBM i 6.1.

Table 2 lists the required IBM i software for running Traveler on Domino.

Table 2. Required IBM i software
IBM i Software	i 7.1	i 7.2	i 7.3
IBM Developer Kit for Java J9	5761JV1 Option *BASE 5761JV1 Option 16 5761JV1 Option 17	5770JV1 Option *BASE 5770JV1 Option 16 5770JV1 Option 17	5770JV1 Option *BASE 5770JV1 Option 16 5770JV1 Option 17

Note:

For IBM i 7.1 (5761JV1) and 7.2 (5770JV1), Options 16 and 17 are additionally required.
5770JV1 Options 16 and 17 are available with IBM i 7.3 media.

For example, when starting Traveler, the following error messages will be displayed in the Domino console if the required Java Option is not installed on IBM i.

[08708:00002-00000031] 08/01/2017 00:12:47   IBM Traveler: Starting JVM with
Maximum Memory = 1024M based on Maximum Memory Size specified in the server document (1024M)                                                              
[08708:00002-00000031] 08/01/2017 00:12:47   Traveler: Cannot create Java VM, result=-1

Note: FP20 of Java 8.0 SR6 is not recommended.

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.