Page tree

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.