Working with the Integration Maintenance Tool

Working with the Integration Maintenance Tool

This section provides instructions for using the BMC Client Management - BMC Atrium CMDB Integration Maintenance Tool.

The Maintenance Tool provides a common tool to access diagnostics and utilities. You can use the Maintenance Tool to review logs or configuration parameters. The Maintenance Tool also provides the Log Zipper utility that collects and archives log files and operating system information that BMC Customer Support might need to help you troubleshoot problems.

Executing the Maintenance Tool

1. From the installation directory of the product, open the <Installdir>/ bcmcmdbintegration folder.

   The default installation directory is as follows:

   • Windows: C:\Program Files\BMC Software\BCMCMDBIntegration
   • Linux: /opt/bmc/BCMCMDBIntegration
2. Execute the following file to open the Maintenance Tool:

Windows: BCMCMDBIntegrationMaintenanceTool.cmd

Linux: BCMCMDBIntegrationMaintenanceTool.sh The following tabs are displayed:

• Logs
• Configuration
• Health Check

• Encrypt

  Note:

  BMC Client Management - BMC Atrium CMDB Integration only uses the Logs tab. The other tabs are for other applications such as BMC Remedy Atrium. For more information, see the documentation for those products.

  

Viewing the installation logs

When you run the BMC Client Management - BMC Atrium CMDB Integration installer or uninstaller a log file is created in the BMC Client Management - BMC Atrium CMDB Integration Maintenance Tool. To view these logs proceed as follows:

1. Open the Maintenance Tool.
2. Click the Logs tab.

3. To view the installation log, click Install Log .

   This action is required when you want to see the messages generated during installation or search the installation logs to identify issues. Search for rows highlighted in red (errors) or yellow (warnings).

4. To view the installation log, click Uninstall Log .

   This action is required when you want to see the messages generated during uninstallation or search the uninstallation logs to identify issues. Search for rows highlighted in red (errors) or yellow (warnings).

   Click the column header to sort columns. To reverse sort a column, press the Shift key while clicking the column header.

5. To view the configuration log, click Configuration Log .
6. To open the folder that contains the log files, click Browse to Log .

Zipping logs for Customer Support

Installation issues and application issues can occur during installation or application use. You can use the Log Zipper, which is part of the BMC Client Management - BMC Atrium CMDB Integration Maintenance Tool, to zip all the log files that are necessary to debug issues. This action is required when you want to send the logs to Support for error investigation.

1. Open the Maintenance Tool.
2. Click the Logs tab.

3. To zip all log files for Support, click Zip Logs .

   This action is required when you want to send the log files to Support for error investigation.

4. To zip all registered product logs on the computer, click Zip All Logs .

   This action is required when you want to send the logs to Support for error investigation.

5. Send the BCMCMDBIntegrationLogs.zip output file from the temp directory to BMC Customer Support.