Downloading system logs

You can download problem determination information, including system logs and trace file, pertaining to IBM Storage 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, click the administrator user name in the banner across the page.
In the menu that is opened, click 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 Web user interface optionsFile restore options.
Restriction: Multiple requests to download system logs cannot be processed at the same time. A new system log collection cannot be started until the current 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 following problem determination files can be included in the compressed file. In most cases, all the files exist, but in some cases, some files do not exist.

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