Log exporting

The IBM Deep Archive system allows users to export logs for audit and service reasons. The TapeCloud Manager CLI can be used to export the IBM Deep Archive software service logs, the TapeCloud manager audit logs, and the S3 cloud audit logs.

Create and download service and audit logs from a TapeCloud node

All logs that are needed for troubleshooting or analysis can be generated with the tcmgr log create command. A user with management access set to admin or viewer can run this command.
  1. Run tcmgr log create command.
    tcmgr log create

    The log create command creates a log package that contains the current system state of the IBM IBM Deep Archive © system. Collected logs include the command history for all CLI and S3 requests as well as service-related information that is required for IBM support to diagnose issues in the system.

    Example:

    $ tcmgr log create
Date/Time: May 14, 2024, 07:07:40 PM +09:00; IBM TapeCloud Version: 1.0.0.0-00001
> Collecting library manager logs (this may take a while)                    [ OK ]
> Gathering journalctl logs                                                  [ OK ]
> Gathering network configuration                                            [ OK ]
> Gathering configuration files and other logs                               [ OK ]
Log exported to /var/log/tapecloud/tclog_20240514-190740.tar.gz

    As shown in the example, logs are created in the /var/log/tapecloud directory of the S3 node in tclog_<node name>_<8-digit date>-<6-digit time>.tar.gz format.

  2. Extract the exported file to user’s local system by using the scp command from a remote system.
    Example:
    $ scp admin_user@tcnode:/var/log/tapecloud/tclog_20240514-190740.tar.gz /tmp/tclog_20240514-190740.tar.gz
tclog_20240514-190740.tar.gz 100% 64MB 11.4MB/s 00:05

$ ls /tmp/tclog_20240514-190740.tar.gz
/tmp/tclog_20240514-190740.tar.gz