Welcome
Administering HCL Traveler
Information on planning, installing, configuring, and administering HCL Traveler.
Planning for installation and configuration
There are many installation and configuration considerations you should review before installing the HCL Traveler server.
Capacity planning guidelines
This section provides guidance on capacity planning for various deployment configurations of the HCL Traveler server. It also touches on best practices for monitoring capacity.
Enterprise database configuration
A Traveler HA environment should be set up over a Traveler standalone environment. A Traveler HA environment offloads all the work to store, index, sort and retrieve relational data to an enterprise database management server (DBMS) like MySQL, DB2, or MS SQL Server. This greatly improves the performance and availability of the Traveler environment.

HCL Traveler 14.0 documentation
Welcome to the HCL Traveler 14.0 documentation. Here you can find information on how to install and configure a Traveler server and to use the clients supported by the server including HCL Verse mobile clients. This documentation applies to Traveler 14.0.
New server features
HCL Traveler 14.0 provides the following new server features and enhancements for administrators.
What's new in Verse on Android?
The following features are new in Verse 14.0.x on Android:
What's new in Verse for iOS?
The following features are new in Verse 14.0.x for iOS:
Administering HCL Traveler
Information on planning, installing, configuring, and administering HCL Traveler.
- Planning for installation and configuration
  There are many installation and configuration considerations you should review before installing the HCL Traveler server.
  - Choosing a deployment configuration
    The HCL Traveler server can be deployed using several different configurations.
  - Planning HCL Traveler on Docker
    HCL Traveler on Docker is a full-function Domino on Docker server with Traveler preinstalled and configured to start whenever the Domino server starts. The Docker container runs Red Hat Linux, so Domino and Traveler are Linux also. As with any other Linux-based Domino, the HCL Domino Administrator Client must be run remotely on a Windows server connected to the the Docker image over the network.
  - Planning HCL Traveler on IBM® i
    There are several IBM® i operating system considerations to be aware of when planning the HCL Traveler server installation on IBM i.
  - Clustering and failover
    The key to any production environment is the enablement of redundancy to account for planned or unplanned outages.
  - Planning for device security
    This section provides information about each HCL Traveler security option and how they can be applied by device type. You can use this information to plan your security configuration for HCL Traveler on your devices.
  - Planning for user authentication
    HCL Traveler requires every HTTP request to be authenticated for the operations being done to be correctly associated with the proper user. Hence, anonymous access is not supported. This validation of identity, referred to as authentication, is typically handled by the HCL Domino HTTP task or a secure proxy such as HCL SafeLinx. This section provides information on the supported authentication types by client to help plan for the Traveler server's authentication configuration.
  - Planning for migration
    Migration covers a number of scenarios.
  - Language support
    This section lists and provides information on all supported languages for HCL Traveler.
  - Sync protocol support
    When data is synced between the server and device, it is done so utilizing a protocol which controls what the message content (the HTTP body) contains.
  - Capacity planning guidelines
    This section provides guidance on capacity planning for various deployment configurations of the HCL Traveler server. It also touches on best practices for monitoring capacity.
    - Physical vs. virtual hardware
      Most customers run at least some part of their Traveler environment on virtual hardware. Doing so is fully supported however to avoid pitfalls, use the following best practices.
    - Central processing units (CPUs)
      These days it doesn’t make sense to talk much about processing speed, as most CPUs are 2GHZ or better, which is more than sufficient for use with the Traveler product. Instead we discuss the number of CPUs allocated to the physical or virtual system.
    - Memory
      Similar to CPU, it’s no longer interesting to discuss memory speed as most memory is now capable of transfer rates of 2400MB per second or greater which is more than sufficient. Instead, it’s important to review the amount of available memory.
    - Disk configuration
      The number one recommendation for disk architecture to support an HCL Traveler deployment is to use solid state disks (SSDs) for the Traveler database volume. For a standalone environment, this is the volume used by the Traveler server. For HA environments, this is the volume used by the enterprise database server.
    - Enterprise database configuration
      A Traveler HA environment should be set up over a Traveler standalone environment. A Traveler HA environment offloads all the work to store, index, sort and retrieve relational data to an enterprise database management server (DBMS) like MySQL, DB2, or MS SQL Server. This greatly improves the performance and availability of the Traveler environment.
    - Network and geography
      Network is a broad term that encompasses any component that the Traveler server uses to communicate to service mobile devices.
    - Co-locating Traveler with other Domino applications
      In general, running other Domino applications on the Traveler server isn't recommended, including mail, Sametime, SMTP, POP, and so forth. Maximum performance of the Traveler environment is best achieved on dedicated hardware whether it be virtual or physical. That said, there are some scenarios where you may want to investigate running Traveler along with other Domino services.
    - Number of mobile devices
      When talking capacity, we always talk about the number of devices that will be connected to a particular Traveler environment rather than the number of users.
    - Type of mobile user
      Not all mobile device users are created equal and it is important to understand your user base to plan accordingly.
    - Theoretical device capacity
      Each environment is different, influenced by the user base, hardware, network, geography and other factors. Virtualization can also have an impact on server capacity. HCL recommends monitoring the environment on a regular basis to understand if your environment is below, above or has reached capacity.
    - Monitoring for capacity
      In general, the best metric to monitor for capacity is the Traveler server Availability Index (AI). The AI is a measure of the overall server capacity. The AI and overall health of the Traveler server can be checked with the tell traveler status command. For more information, see Tell_command.html.
  - Estimating the space needed for the HCL Traveler database
    You can estimate how much space is needed for the HCL Traveler database before it is installed.
- Installing the HCL Traveler server
  The following topics describe options for installing and uninstalling the server:
- Configuring HCL Traveler server
  The HCL Traveler configuration settings are part of the Domino® server document. The first time that the HCL 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 HCL Traveler
  The HCL 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 HCL Traveler server.
Using HCL Traveler and mobile clients
Information on configuring and using HCL Traveler with supported device clients.
Troubleshooting, known limitations, and restrictions
This section provides helpful troubleshooting tips, known limitations, and restrictions.
HCL Traveler Companion FAQs
HCL Traveler for Microsoft Outlook

Enterprise database configuration

A Traveler HA environment should be set up over a Traveler standalone environment. A Traveler HA environment offloads all the work to store, index, sort and retrieve relational data to an enterprise database management server (DBMS) like MySQL, DB2, or MS SQL Server. This greatly improves the performance and availability of the Traveler environment.

For small deployments, it’s acceptable to use an existing DBMS deployment that may be hosting other databases and/or other Traveler environments. For medium to large deployments, have an enterprise database environment that is dedicated to the Traveler environment being hosted. The main concern when setting up your enterprise database environment, other than the performance characteristics noted elsewhere, is to consider any overhead associated with HADR, mirroring, or any other HADR technology employed to improve data availability.

When enabling HADR in DB2 or mirroring in MS SQL Server, it is important to have a separate disk volume for the database transaction logs as the transaction log is heavily used to support the HA features of the enterprise database system. Geographic proximity of the primary and secondary servers is also important to reduce network latency. If distributing the primary and secondary DBMS servers is required for your organization, ensure that there is a dedicated high-speed network connection between the two sites to minimize any performance impact.

Best practice tip: when setting up any type of database HADR, separate the database volume and log volume on two physically separate solid state disk (SSD) arrays. Doing so ensures maximum performance for your DBMS solution.

Note: Be sure to take a look at the enterprise database version requirements detailed in this article.