Home
Administering HCL Traveler
Information on planning, installing, configuring, and administering HCL Traveler.
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.
Starting and stopping the server
The HCL Traveler server and the HTTP server automatically start if you accept the default settings during installation. Use the commands in this topic to manually start or stop the HCL Traveler server.

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.
- 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.
  - Starting and stopping the server
    The HCL Traveler server and the HTTP server automatically start if you accept the default settings during installation. Use the commands in this topic to manually start or stop the HCL Traveler server.
  - Using the administration application
    The HCL Traveler administration database is contained in the LotusTraveler.nsf. This database contains the user interface that is used to view mobile user and device information, as well as set default device preference and security policies.
  - Assigning preferences and security settings to devices
    There are different ways to assign settings that determine how users work with the HCL Traveler server. You can use the built-in set of default device preferences and security settings that HCL Traveler provides, which is simpler. Or you can create a HCL Traveler policy settings document, which provides greater flexibility and control but is more complex to configure.
  - Device security
    There are a number of considerations to be aware of when securing different device types.
  - Working with attachment security settings
    You can control how HCL Traveler clients manage file attachments and images.
  - Remote wipe
    If a mobile device is lost or stolen, an administrator can issue a remote wipe command to remove all sensitive data from the device. You can remove the HCL Traveler application and data from the device and, depending on the device, restore the device to the factory default settings.
  - Console commands
    This topic provides a detailed description of the HCL Traveler console commands.
  - travelerUtil commands
    The travelerutil is a command line tool located in the <domino data>\traveler\util directory. Enter travelerUtil help while running the tool to display the full list of options.
  - Delegation support
    HCL Traveler can allow delegates to access mail files owned by other users.
  - Controlling access to HCL Traveler
    When a user leaves the company or a device is lost or stolen, you must remove or restrict access to the HCL Traveler server. This section covers methods for removing and restricting access.
  - Deleting a user from HCL Traveler
    An administrator can remove old or invalid users from the HCL Traveler administrator UI and database. This should only be done for users where access is already restricted using a HCL Traveler or Domino® server access list, or who are no longer listed in the Domino directory.
  - Creating links to start the HCL Verse mobile app
    Create links that a user can click to start the HCL Verse mobile app from a web page or email.
  - Enabling syncing of read or unread changes
    Unread replication is enabled for each user automatically by the HCL Traveler server so that unread marks sync correctly with the device. This section explains how to activate unread replication manually using the Domino® Administrator client.
  - Repeated crash protection
    When certain Notes® documents are corrupted or contain non-standard content, they can cause the HCL Traveler server to repeatedly crash as it tries to process these documents. A repeating crash prevention feature exists to help minimize HCL Traveler server outage in these instances.
  - Maintaining the HCL Traveler database
    Whether running standalone HCL Traveler servers with the internal database or a pool of servers with an enterprise database, the database requires periodic maintenance to maintain optimal performance.
  - Mail address handling
  - Enforcing data sync limits
    Administrators can enforce synchronization data limits for all users using a setting in the Default Settings document.
  - Log types
    HCL Traveler has many different logs with a variety of purposes.
  - HTTP request handling and 409 responses
    HCL Traveler handles HTTP requests in specific ways that may result in 409 responses.
  - Confirming external recipients on Android devices
    For HCL Verse for Android clients, you can choose to prompt the user to confirm the sending of mail to external recipients. This provides an extra step to help prevent the unintentional sending of mail outside of your organization.
  - Adaptive Initial Sync
    Adaptive Initial Sync (AIS) helps ensure server availability in certain server bring up or recovery situations.
  - FCM messaging for HCL Verse for Android clients
    HCL Traveler server can use Firebase Cloud Messaging (FCM) for real time push notifications to keep your Mail, Calendar, Contact and To Do data on your HCL Verse for Android clients up to date. Google has deprecated GCM and replaced it with FCM.
  - How synced data moves through the system
  - How HCL Traveler processes attachments
    There are several issues to be aware of in how HCL Traveler processes attachments.
  - How HCL Traveler processes SmartForward/SmartReply requests
    A SmartForward/SmartReply (SFSR) request is an email that is a forward or reply of a previously received email that does not include the body or attachments from the original email which is being forwarded or replied to. Instead, a SFSR contains just the forward/reply body text and any additional attachments, plus an identifier of the original email.

Starting and stopping the server

The HCL Traveler server and the HTTP server automatically start if you accept the default settings during installation. Use the commands in this topic to manually start or stop the HCL Traveler server.

To start the HCL Traveler server, enter this command on the Domino® Console:

load traveler

To stop the HCL Traveler server, enter one of these commands on the Domino® Console:

tell traveler shutdown

tell traveler quit

Note: The shutdown command waits for any pending syncs to complete and then quits. The quit command does not wait for any pending syncs to complete and quits in a much shorter amount of time. The default quit time for shutdown is 300 seconds, and 40 seconds for quit. You can override the default shutdown and quit time by setting the notes.ini parameters NTS_MAINTASK_SHUTDOWN_WAIT_TIME and NTS_MAINTASK_QUIT_WAIT_TIME. The values are in seconds.

To restart the HCL Traveler server, enter this command on the Domino® Console:

restart task traveler

Domino® HTTP server

HCL Traveler requires the Domino® HTTP server to be running. When the HCL Traveler server task starts, it will check to see if the Domino® HTTP server task is running and start the task automatically. This is the recommended operation for a server that is dedicated to running just HCL Traveler, since the HCL Traveler server task will delay the start of HTTP until it is ready to receive requests from mobile devices. If the HTTP server starts right away and mobile devices attempt to connect to the server before the rest of the server tasks begin, then you will see warning messages on the Domino® console indicating that the HCL Traveler task is not yet started and the mobile device request will be denied.

If this behavior is not desired, it can be disabled by setting NTS_AUTOSTART_HTTP=false in the notes.ini file.

Note: By default, HCL Traveler validates its configuration settings and automatically adjusts the configuration when it is started. If you do not want HCL Traveler to automatically configure the HTTP server at startup, add the parameter setting NTS_AUTO_CONFIG=false to the notes.ini file.