Downloading system logs

You can download problem-determination information, including system logs and trace file, pertaining to IBM Spectrum Protect backup-archive client and web user interface operations. By default, this feature is disabled, but it can be enabled by the system administrator.

Procedure

From the web user interface, select Download System Logs.

If you have permission to download problem-determination information, a message indicates that the download started, and that the logs are downloaded in the background.
If you do not have permission to download problem-determination information, a message indicates that downloading is not permitted and that the system administrator can change this permission. For more information about changing this permission, see the enable_download_logs option in the File restore options.
Note: Multiple requests to download system logs cannot be processed at the same time. A new system log collection cannot be started until the initial system log collection is completed.

Results

Depending on the size of the log files and trace file, it can take several minutes for the system logs to be downloaded.

The problem-determination information is collected into a compressed file. The file can be saved to a selected location, or saved to the default location as specified in the browser configuration.

The compressed file name has the following format:

TIV-logs-TSM_CAD-<NODE NAME>-YYYY-MM-DD_hh-mm-ss.zip

The compressed file contains the following problem-determination information:

ba/dsminfo.txt. This file contains IBM Spectrum Protect backup-archive client information from the command query systeminfo, and includes the following information dsmerror.log, dsmwebcl.log, and dsmsched.log.
ba/trace.txt. If tracing is enabled, this file contains IBM Spectrum Protect backup-archive client trace file information.
ba/dsminstr.log. This file contains IBM Spectrum Protect backup-archive client instrumentation information.
The liberty_logs folder contains all logs and trace files that are related to the Liberty Server and the file-restore API, including fr_api.log and messages.log.
frGUI/FRLog.config. This file contains file-restore API logging and tracing configuration information.
The tsmVmGUI folder contains the file-restore information files, and including api-jlog.properties, frConfig.props, traceConfig.properties, TsmApiLog.config, and tsmserver.props.
server.xml. This file contains configuration information that is related to the Liberty Server.