Viewing a Log Zipper output file with Maintenance Tool

From the Maintenance Tool, you can view files from the Log Zipper output file (productLogs.zip). When you click Browse to Log in the Maintenance Tool, a window displays a file navigation tree. The productLogs.zip file usually contains a folder with three subfolders with the same names as in the originating system. For example, you might see:

  • Documents and Settings
  • Program Files
  • Windows

From these folders, you might want to view files such as:

  • ProductRegistry.xml — Contains the BMC Software products, versions, and features installed on the system. Identifying the products and versions involved is an initial step for investigating issues.
  • OperatingSystemData.xml — Contains information about the system that is relevant to the BMC Software products. Examining this file can direct your attention to system issues, such as insufficient resources or incompatible versions.
  • InstalledConfiguration.xml — Contains important environment information from the last successful installation. (A separate installing configuration XML file captures environment and user selections during a current installation attempt.)

Note

You can use an archive utility to unarchive the files into a temporary directory to view the files collected, but the Windows uncompress utility often gives misleading results, indicating the file is empty or is an invalid zip file.

To open a Log Zipper output file with the Maintenance Tool

  1. Start the Maintenance Tool utility.

    You can run the Maintenance Tool in a graphical user interface or from the command line.

    To run the Maintenance Tool in a graphical user interface

    • (Windows) From the location where you downloaded the installation files inside the utility folder, run the productMaintenanceTool.cmd file.
    • (Linux) From the location where you downloaded the installation files inside the utility directory, run the ./productMaintenanceTool.sh file.

    To run the Maintenance Tool from the command line

    • (Windows) From the location where you downloaded the installation files, open the utility folder, and run <product>MaintenanceTool.cmd with the -silent option.
    • (Linux) From the location where you downloaded the installation files, open the utility directory, and run ./<product>MaintenanceTool.sh with the -silent option.

    To learn about command-line options

    To learn about available command-line options, use the -help or -? option when you run the command.

    Examples:

    • TrueSightPServerMaintenanceTool.cmd -help
    • ./TrueSightPServerMaintenanceTool.sh -?

  2. On the Logs tab, click Browse to Log.
    A new window displays a navigation tree.
  3. In the navigation tree, navigate to the directory with the Log Zipper output file (usually called productLogs.zip).
  4. Double-click the file that you want to view to open it in the appropriate viewer.
Was this page helpful? Yes No Submitting... Thank you

Comments