Server troubleshooting

This section contains troubleshooting tips for the HCL Traveler server.

For information about gathering logs for HCL Traveler Support, see Gathering log files for support.

Install

Installer crashes.

Stop Domino.

Make sure all Domino processes are stopped (including the scontroller process), then retry the install.

Domino Version is not determined by the Installer. Do not proceed with the Traveler install if the Domino version is not correctly determined.

Stop Domino.

Make sure all Domino processes are stopped (including the scontroller process), then retry the install.

If the Domino version still can not be determined, use Silent install and installer.properties to override the Domino version. For more information, see the Silent install sections of the Installing the HCL Traveler server documentation.
Startup and configuration

The message displays when trying to start HCL Traveler: "Initialization error for library j9gc24(5): Failed to instantiate heap;".

This problem occurs when there is not enough system memory for HCL Traveler to startup. This is only a problem on 32-bit operating systems.

Verify that notes.ini does not contain the following parameter: MEM_EnablePreAlloc=1.

If the notes.ini does contain the above parameter and will still not start, contact HCL Support to help analyze the memory usage on the system.

The following message displays when trying to start HCL Traveler: 'Exception in thread "main" java.lang.UnsupportedClassVersionError: JVMCFRE003 bad major version; class=com/lotus/sync/admin/MainTask'. The problem occurs when installing Traveler on an unsupported Version of Domino. Traveler requires Domino 901 FP8. Install a supported version of Domino.

HCL Traveler server starts, but the HTTP Servlet does not.

Verify that the notes.ini file does not contain this parameter: HTTPDisableJVM=true.

This parameter disables all Java based servlets, including the HCL Traveler servlet.

Connection, Log-in, and server status

Verifying that the server is running

To verify that the server is running:

  • Run the show task tell command from the HCL Domino® Administrator client and look for the following:
    • HCL Traveler Running: 2 of 2 users active
    • HTTP server listen for connect request on TCP Port:80
  • Check the server console for the following:
    • HCL Traveler: Server started
  • On Windows, look for ntraveler.exe in the Microsoft Windows Task Manager for Traveler status, and nhttp.exe for HTTP status. On Linux or AIX, run the top command and look for the Traveler and HTTP status messages.
Devices can sync mail from the server and move or delete mail on the device, but the devices cannot send new messages. Traveler uses mail.box on the user's primary server to deposit mail to be picked up and delivered by the Router task. The primary server may not be the same Domino server as the Traveler server. The Traveler server must have ACL access to the mail.box, or mail##.box if the server is configured with more than one mail.box. However, even if the ACL allows this access, Traveler can report Error(246)=You are not authorized to perform that operation when trying to open mail.box if the network configuration is incorrect. In this case, use trace <servername> in the Domino console to check connectivity. If there is a connection problem, you probably need to check and fix your connection documents.
Users are unable to download encrypted mail To view notes encrypted content from a supported client (HCL Companion for iOS, HCL Verse for Android/iOS), the user is prompted for their Notes id password. If the user is repeatedly prompted for a password, this indicates a password failure. If a valid password is specified (user is not re-prompted for the password) but the unencrypted content is not displayed, this implies an issue on the Traveler server accessing the user's notes id file. If the notes id files are vaulted and the Domino vault server is in a different domain, ensure that the Traveler server is configured for cross-domain access (see Supporting multiple HCL Domino domains for more information). The Traveler server logs should contain more information on the failure to process the encrypted mail request (see Gathering log files for support).
Traveler task out of memory crash on Linux systems If the user process limit (ulimit) is too low, the Traveler server task may terminate with a java.lang.OutOfMemoryError: Thread creation failed error. The user process limit needs to allow for the HTTP thread requirements, Traveler thread requirements in addition to what other processes are running on the server. See Tuning performance of the server for more information on Traveler server thread usage. For additional troubleshooting information, refer to the knowledge article KB0091070: Traveler encounters java.lang.OutOfMemoryErrors due to thread creation failures on Linux.

Logging into the server

If you are unable to log into the HCL Traveler server, verify that:
  • Open LotusTraveler.nsf and check the security state of the user
  • ID is not locked out of HTTP server
  • Password is correct
  • Server name is correct
  • You have granted access to the HCL Traveler server in your mail database
  • Check Allow/Deny section of the server configuration document

HCL Traveler client reports error registering with the server

Verify that:
  • The user ID must only contain characters that are supported by the Domino® server. These include characters (A - Z), numbers (0 - 9), and the ampersand (&), dash (-), period (.), space ( ) , and underscore (_). See the HCL Domino® Administrator Help topic "Table of Domino® Naming Requirements" for more information.
  • You may need to enable the Domino® HTTP server to accept "More name variations with less security", rather than the default "Fewer name variations". HCL Traveler clients behave as Internet clients to the Domino® web server, and the name look up algorithms are controlled by the Domino® server security settings. To modify this setting:
    • From the Domino® Administrator, click Configuration, and open the server document
    • Click Security
    • In the Internet Access section, choose More name variations with less security
    • Save and close the document
  • For a HCL Traveler server installed on a Thai server, verify you have added the setting NTS_Java_Parms=-Duser.language=th.US to its notes.ini file. This setting changes the default Java calendar from Buddhist to Gregorian.

Overall system status

Use the LotusTraveler.nsf to gather detailed information about users and their devices that are using the HCL Traveler service.

You can use the tell traveler status command to make a number of checks in the HCL Traveler server to determine if it is operating normally.

In a High Availability pool, use tell traveler hadr show to view status on all servers in the pool. This information is also available from the Web-based administration interface under the Servers view.

The tell traveler hadr show command will also show the status of a standalone server.

Invalid user ID or password problems

Depending on how your network is set up, when your authentication service goes down or cannot be accessed by the HCL Traveler server or an intermediate proxy, the mobile device client may display an error to the mobile user that their ID or password is invalid. This situation should resolve itself as soon as the authentication service is restored.

Devices are not receiving updates from the HCL Traveler server, or many sync attempts are failing with a 503 return code.

From the Domino® console, issue a Tell Traveler Status command. Note if there are messages like:
Tell traveler status
The number of active HTTP connections is 233 percent of the number of available HTTP threads (1,200).
The peak number of HTTP connections is 233 percent of the number of available HTTP threads (1,200).
There have been 37,445 device sync failures because the server is too busy and returned status code 503.
There have been 24,779 device sync failures for reasons other than the server is too busy.

The overall status of HCL Traveler is Red.

One possible cause for a high number of sync failures with a 503 return code is that there are too few HTTP threads. See Tuning performance of the server for more information before raising the number of HTTP threads. Having too many HTTP threads can result in insufficient memory for the Domino® server to run properly.

Directory

Verifying directory access

Run the command tell traveler show <user> and look for the following:
  • User name resolves as expected
  • If not, make sure that the security setting Server Document > Security > Internet Access > Internet Authentication allows the format of <user>, For example, if you want to use the shortname for <user>, you must set this to More name variations with less security.
Statistic and Log information

HCL Traveler Server user statistics

Run the command tell traveler stat show for the following information:
  • Number of users known to the system, including online, offline, and mail file statistics
  • Number of devices know to the system, including online, offline, and connection statistics
  • Number of prime syncs, including time and success rate statistics
  • Number of device syncs, including time and success rate statistics

Troubleshooting a user on the server

Not all of these options will always be available. The administrator may have disabled some of them.

Commands may be executed at the Traveler servlet, available at http://<hostname>/traveler.

Selecting Manage the Notes ID brings you to the ID management screen.

Select Execute Commands to go to the command screen.

The servlet can be used to verify that the Traveler task is able to access a user mail file, the status of unread mark replication, and other useful information. Select Show , or the user <username> command at the Domino® console.

The information displayed by the SHOW command may include any of the following informational messages:
  • HCL Traveler does not have delete rights to the database <database name>.
  • HCL Traveler could not open the database <mail database> . Verify that the server <Traveler server name> and the database grant access to server <Domino server name> and that there is a network connection available between these servers.
  • Internal error encountered attempting to validate access to database <mail database name>.
  • The Domino® server <Domino server name> for <mail database name> does not support <canonical name> for HCL Traveler. See logs for more details.
  • The HCL Domino® server, <Domino server name>, that hosts the <mail database name> mail file is an earlier version so some functions are not fully implemented.
  • Database <mail database name> is <bytes> bytes in size and <percent> percent used, which is over the quota of <quota> bytes.
  • The database <mail database name> on <canonical name> is not configured to replicate read and unread marks. As a result, unread marks do not replicate with the device.

Select Manage Security to open the user managed security options. With user managed security, users can now remotely wipe or lock their own devices, without the help of an administrator. They can also "clear" their own actions. For example, they can cancel the wipe request or unlock the device.

Select Report a Problem to generate a problem report. This action captures information about your user session and creates a diagnostics report that is stored on the Traveler server. HCL Technical Support may ask your server administrator for these logs if you ever need to report a problem to HCL.

High Availability

Server-to-server communication problems

If it seems that one or more of HCL Traveler servers in an HA pool cannot communicate with each other, run the command tell traveler hadr show and check for the following:
tell traveler hadr show


Domino Name     ID    Hostname            IP:Port         Alive  Reachable...
ha-srv1/domain  2050  hasrv1.company.com  10.1.1.5:50125  true   false
ha-srv2/domain  2150  hasrv2.company.com  10.1.1.8:50125  true   true  
Note: The output has been truncated for readability.
Occasionally after being restarted, one of the HCL Traveler servers in the pool may not have received messages from another server. When this happens, the hadr show command displays that server as unreachable. In the example, the command was run on the console on ha-srv2. The first step to troubleshoot this problem is to run the command tell traveler hadr ping ha-srv1 from the console on ha-srv2. The output should look like the following:

tell traveler hadr ping ha-srv1

Successfully sent 'ping' to server ha-srv1/domain. 
Ping response received from server ha-srv1/domain. 
All ping responses have been received. 
If the ping command shows successful results similar to the example output, rerun the command tell traveler hadr show. Both servers should be reachable now. If the ping command is unable to reach the other server, there may be a network connectivity problem between the two servers. Try the following steps:
  • Try running the command tell traveler hadr ping ha-srv2 from the console on ha-srv1.
  • Verify the servers are on the same TCP/IP subnet.
  • Verify that ping commands from an OS command prompt work between the servers.
  • Verify that the Traveler servers are using the correct network interface. If any of the servers have multiple network interfaces, Traveler may have automatically selected the wrong interface when it was started. The notes.ini property named NTS_HOST_IP_ADDR can be used to specify the correct IP address to use.