Diagnostic commands

This section provides details on commands for getting diagnostic information about the HCL Traveler server.

DumpDoc

The DumpDoc command dumps copies a document from the specified database to a dump file in the HCL Traveler log directory under /dumps. The name of the file is in the format [User CN Name].[doc#].YYYYMMDD.HHMMSS.cor. The file is an nsf file but without the .nsf file name extension to avoid Domino accessing the file and making it unsafe to copy at the operating system level; a .cor file can be opened by applications that open .nsf files. The .cor file can then be uploaded to Support for investigating problems with a specific document.

DumpDoc <doc#> <user> - Dumps a document based on its GUID (UNID of document) or noteId from the user mail database. <user> can be any unique user identifier or MailServer!!Mailpath.

Dump user

The Dump command dumps the user metadata to a dump file in the HCL Traveler logs directory under /dumps. The name of the file is in the format [User CN Name]+YYYYMMDD.HHMMSS.log. These files are useful for users who are having problems with data not arriving at their devices or users who are missing documents. The metadata includes known device information as well as the mapping tables between the Domino® UNID of the documents that are synced with the device identifiers for the same document. There is no real data (for example, no document data, no body, and no subjects) dumped in the file. The following is an extract from a dump file showing the mappings for a document:

LGUID: 100000000000220531  BACKEND_GUID: 2D7CB833D1A637938525887C005F1CAE  TYPE: EMail     FOLDER: DABA975B9FB113EB852564B5001283EA  DOCLINK:Notes://acme/mail/Johndoe.nsf/DABA975B9FB113EB852564B5001283EA/2D7CB833D1A637938525887C005F1CAE                        
------------------------------------------------------------------------------------------
LGUID: 100000000000220531 ModTimeInGud: 1657560006 (07/11/2022 13:20:06) ModTimeInDevice: 1657560003 (07/11/2022 13:20:03) ModTimeInBe: 1657560003630 (07/11/2022 13:20:03) FolderGudRecordId: 100000000000162348 Cache1: 2 Cache2: 1 Cache3: 1657559978 (07/11/2022 13:19:38) Type: 100000000000000116 (EMail) Folder: 100000000000000122 Hashcode: -318095774
  100000000000166096: Android_F9999BBBBBAAAAAC timeSyncInDevice: 1657560006 (07/11/2022 13:20:06) timeSent: 1657560006 (07/11/2022 13:20:06) DeviceRecordId: null tsTaggedForSlowSync: 0 mChangeData: 1 mChangeMove: 0 mChangeRead: 0 mFolder:100000000000162348 mType:100000000000000116 [Filtered]
  100000000000164717: HCL_IOS_EAAAAAAAAAABBBBBBB99999999999888 timeSyncInDevice: 1657560006 (07/11/2022 13:20:06) timeSent: 1657560006 (07/11/2022 13:20:06) DeviceRecordId: 254E52B1-32BD-4C3E-9873-6D6B8C62A50E tsTaggedForSlowSync: 0 mChangeData: 0 mChangeMove: 0 mChangeRead: 0 mFolder:100000000000162348 mType:100000000000000116 [U2D]
  100000000000162344: SXXXXXXX9999999CCCCCCC7777 timeSyncInDevice: 1657560006 (07/11/2022 13:20:06) timeSent: 1657560006 (07/11/2022 13:20:06) DeviceRecordId: null tsTaggedForSlowSync: 0 mChangeData: 0 mChangeMove: 0 mChangeRead: 0 mFolder:100000000000162348 mType:100000000000000116 [Filtered]

Log collect

This command creates a zip file containing all existing log and HCL Traveler Java™ dump files. Additionally, all HCL Traveler configuration files, as well as any generated NSD files, are copied into the new directory. This command should be performed before contacting HCL Traveler Support. For more information, refer to Gathering log files for support.
Note: This command (for versions 8.5.3 and later) no longer deletes NTS*.log files

Support

The command tell traveler support <number> (where <number> is a properly formatted case number) performs a systemdump of all log files, collects them in one zipped file, automatically uploads (FTP) the output from the log collect to HCL Support under the designated case number.
Note: If you have already performed a systemdump and have a list of file logs to send to HCL support, add [log file list] to the command: 
tell traveler support <number> [log file list]
Where [log file list] is a list of your log files to upload. In this case, the command will not perform a systemdump of log files and collect them, rather it will only upload the files defined by [log file list] to HCL Support under the designated case number. For more than one file, you must separate them with a space and place the "\" character on either side of each filename.

SystemDump <options>

This is a non-disruptive command that provides a current snapshot of the HCL Traveler system. The current system information is dumped to a dump file in the HCL Traveler log directory under /dumps, along with a Java™ dump that is stored in the IBM_TECHNICAL_SUPPORT directory. Perform this command before contacting HCL Traveler Support.

For a full list of options, issue the tell traveler systemdump help command. The options indicate what categories of data are to be collected. When specified without any options, the command is issued with a default set of options. You can see the default set at the top of the resulting systemdump log. If a specific set of options is specified (comma separated), only the diagnostic data associated with those options is generated. By using a - or +, you can get a systemdump with the default options plus or minus the listed option. For example, to request that an NSD also be captured, issue the command: tell traveler systemdump +nsd.