This documentation applies to the 8.1 version of BMC Atrium Core, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

Collecting diagnostics using Log Zipper

Log Zipper is a feature of the Maintenance Tool which collects logs, configuration, and environment information to a zip file which are necessary for debugging. This simplifies the process of providing diagnostics to other administrators or to Customer Support for analysis.

Important

If you set IATEMPDIR environment variable to a directory other than the default temporary directory, use the Log Zipper to zip the log files that are saved to the directory to which IATEMPDIR is set.

Use the Log Zipper for failures related to installation as well as failures that can happen post-installation. Because the zipped log file name is based on date and time, you can overwrite the zip file if you run the logzipper command at intervals less than one minute apart. You can zip BMC Atrium CMDB installation logs as well as logs of other installed components.

Note

If you are running a Telnet session, you must open a new Telnet window to view logs or prepare log files for BMC Customer Support.

To run the Log Zipper

  1. In the BMC Atrium Core Maintenance Tool, click the Logs tab.
  2. Click Zip Logs.
    To prepare the log files from the command line, go to the directory where BMC Atrium Core Maintenance Tool is installed, run the following command to have the logs zipped and created in the TEMP directory:
    • Windows: AtriumCoreMaintenanceTool.cmd -console -logzipper
    • UNIX: ./AtriumCoreMaintenanceTool.sh -console -logzipper
      In the TEMP directory (Windows) or the /var/tmp servers folder (UNIX), a zip file is created with the date and time appended to the file name: AtriumCoreLogs_mmddyyyy_hhmmss.zip.
  3. Provide the AtriumCoreLogs_mmddyyyy_hhmmss.zip output file, located in your temp directory, to BMC Customer Support.

To run the All Log Zipper

  1. In the BMC Atrium Core Maintenance Tool, click the Logs tab.
  2. Click Zip All Logs.
    In the TEMP directory (Windows), the /var/tmp/ server folder (HP-UX and Solaris), and /tmp (Linux and AIX) servers folder, a zip file is created with the date and time appended to the file name: AllLogs-iBMC-3Y1F5BS.adprod.bmc.com.zip.
  3. Provide the AllLogs-iBMC-3Y1F5BS.adprod.bmc.com.zip output file, located in your temp directory, to BMC Customer Support.

To run Log Zipper from the command line

Run Log Zipper from the command line to collect diagnostics to a file without launching the Maintenance Tool. This procedure is useful when issues prevent launching or using the Maintenance Tool user interface.

The zip_all_logs command - when available - performs the same action as running Maintenance Tool and clicking Zip All Logs. This generates an archive file with the Log Zipper output file for each product installed on the system.

Run the Log Zipper from the command line as shown below:

Windows: %ATRIUMCORE_HOME%\atriumcore\AtriumCoreMaintenanceTool.cmd --silent --logs --zip_logs
Windows: %ATRIUMCORE_HOME%\atriumcore\AtriumCoreMaintenanceTool.cmd --silent --logs --zip_all_logs
UNIX: $ATRIUMCORE_HOME/atriumcore/AtriumCoreMaintenanceTool.sh --silent --logs -zip_logs
UNIX: $ATRIUMCORE_HOME/atriumcore/AtriumCoreMaintenanceTool.sh --silent --logs --zip_all_logs

To view installation and uninstallation log files

You can view the installation and uninstallation log files from the BMC Atrium Core Maintenance Tool.

  1. In the BMC Atrium Core Maintenance Tool, click the Logs tab.
  2. Click Install Log or Uninstall Log.
    A tab for each installation log or uninstallation log is displayed.
    To browse for a specific log file, click Browse to Log instead.
  3. Click the tab for the log you want to view.

To troubleshoot issues with zipping logs

  1. Verify there is sufficient space in the temp directory.
    Log Zipper will collect files and create the zip file in the user temporary directory.
  2. Remove older or unnecessary files from the product logs directory
    Many products configure Log Zipper to collect all files in a particular directory, which will increase the time to run and the size of the resulting file if there are many files in the directory.
  3. Open the Maintenance Tool configuration file and search for errors.
    In the Maintenance Tool, click Configuration Log to view the configuration log in the log viewer. Errors encountered by the Maintenance Tool are written in the configuration log.
  4. Choose Edit > Filter to filter on Details that contain Adding file.
  5. In the filtered log entries, check what was the last file or directory Log Zipper attempted to add to see if an error was encountered.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments