Home
Administering IBM Traveler
Information on planning, installing, configuring, and administering IBM Traveler.
Installing the IBM Traveler server
The following topics describe options for installing and uninstalling the server:
Installing IBM® Traveler on IBM® i
Several steps are required to install IBM® Traveler server on IBM i operating systems.
Troubleshooting the installation of IBM® Traveler on IBM® i
You may run into unique problems while installing IBM Traveler on IBM i systems.

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.

Troubleshooting the installation of IBM® Traveler on IBM® i

You may run into unique problems while installing IBM Traveler on IBM i systems.

PROBLEM:

After installing Traveler 9.0.1.15 on IBM i system with an HA configuration, the first startup of the IBM Traveler server will fail during the DB schema upgrade to version 20160812 with the following console message:

Traveler: Upgrading IBM Traveler Database schema from version 20160726 to version 20160812
Traveler: SEVERE  *system Unknown Database exception thrown at startup, attempting startup anyways. Exception Thrown: com.lotus.sync.db.PersistenceException: java.sql.SQLException: [SQL0952] ocessing of the SQL statement ended.  Reason code 10. (SQLState: 57014 ErrorCode: -95 
Traveler: SEVERE  *system  Exception Thrown: com.lotus.sync.db.PersistenceException: java.sql.SQLException: [SQL0952] Processing of the SQL statement ended.  Reason code 10. (SQLState: 57014 ErrorCode: -95 
Traveler: Server stopping for PID 3,381 ...
Traveler: Server stopped.

CAUSE:

The DB2 on IBM i server is returning a warning (inquiry message) because of possible data loss, requesting that the client Cancel or Ignore the requested operation. Because this request over JDBC requires an interactive response (typing 'I' to ignore), the server returns an Error Code: -952 with SQLState: 57014 and Reason code 10.

Note: In this case, Traveler is performing an "Add NOT NULL constraint" operation for some tables using the ALERT TABLE SQL statement.

RESOLUTION:

On DB2 for IBM i, change the message description default value to 'I' by running the following CL command:

CHGMSGD MSGID(CPA32B2) MSGF(QSYS/QCPFMSG) DFT('I')

Then restart the Traveler server.

Note: After the server completes the schema upgrade, you can change the message description default value back by running the following CL command:

CHGMSGD MSGID(CPA32B2) MSGF(QSYS/QCPFMSG) DFT('C')

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.