Collecting IBM Optim container logs

Edit online

Collect IBM® Optim container logs and configuration files from your Linux® environment to troubleshoot IBM Optim Archive deployment and UI issues.

Before you begin

Before you begin, ensure that you have the following access and information:

  • Console access to the Linux environment where IBM Optim Archive is deployed.
  • User credentials for the account that deployed IBM Optim Archive.
  • Sufficient disk space to create compressed log archives.

About this task

When troubleshooting IBM Optim deployment issues, you need to collect container logs, configuration files, and system information. This information helps identify problems with container status, permissions, and network connectivity.

Procedure

  1. From the console, log in to the Linux environment where IBM Optim Archive is deployed.
  2. Change to the directory of the user account that deployed IBM Optim Archive.
  3. List all containers and save the output to a file. 
    podman ps -a > containers.txt

    This command captures the status of all containers, which helps verify that all containers are running correctly.

  4. Identify the IBM Optim log directory path. 
    cat .env | grep OPTIM_LOG_DIR

    The output displays the path to the IBM Optim log directory, which you need for the next step.

  5. Create a compressed archive of the log files. 
    tar -czvf optim-logs.tar.gz /path/to/optim-log-directory

    Replace /path/to/optim-log-directory with the actual path from the previous step.

  6. List SSL certificate files and permissions, and save the output to a file. 
    ls -ltr ssl > ssl.txt

    This command verifies that certificates and directories have the correct permissions.

  7. From the machine where you access the IBM Optim UI, verify network connectivity to the Optim host.
    1. Verify that you can reach the IBM Optim host machine. 
      ping optim-host

      Replace optim-host with the hostname or IP address of your IBM Optim server.

    2. Verify that port 7780 is accessible.

      Use a network testing tool to confirm that port 7780 is reachable on the IBM Optim host. The specific command depends on your operating system and available tools.

Results

You have collected the following diagnostic files:

  • containers.txt - Container status information
  • optim-logs.tar.gz - Compressed log files
  • ssl.txt - SSL certificate and permission information

You have also verified network connectivity to the IBM Optim host and port 7780.

What to do next

Provide the collected files to IBM Support for analysis. Include information about any connectivity issues discovered during network verification.