BMC Atrium Core Maintenance Tool
This section covers the following topics:
Many BMC products use the Common Install Framework, which is an installation program. Products using the Common Install Framework install the Maintenance Tool.
The Maintenance Tool provides a common tool to access diagnostics and utilities that are useful when troubleshooting BMC Atrium Core related issues. The Maintenance Tool provides a common tool to access diagnostics and utilities. You can use the Maintenance Tool to collect diagnostic information, open and view log files, or search logs to identify issues. The BMC Atrium Core Maintenance Tool also gives you access to installation and uninstallation logs.
Launching BMC Atrium Core Maintenance Tool
BMC Atrium Core Maintenance Tool can be launched in a normal manner as well as in silent mode. For details, see Running the BMC Atrium Core Maintenance Tool.
- If this is a new installation, the BMC Atrium Core Maintenance Tool resides in the installation directory under<BMCAtriumCoreInstallationDirectory>\atriumcore_home\atriumcore.
- If this is an upgrade, the BMC Atrium Core Maintenance Tool might reside in a folder named for your server. For example, a Microsoft Windows installation directory path might be C:\Program Files\BMC Software\AtriumCore\w23ee-doc-vm01\atriumcore.
Maintenance Tool Activities
The BMC Atrium Core Maintenance Tool utility has distinguished tabs, each designated, for you to perform certain set of activities. You can perform the following activities using the Maintenance Tool:
- View and collect log information: From the Logs tab, you can view the logs related to installation, uninstallation, and configurations. You can also use the Log Zipper utility to collect the entire log and diagnostic information in a single zip file. For details, see Collecting diagnostics using Log Zipper.
- Enables product specific logs or configuration: From the Configuration tab, you can configure the logging settings for normalization and reconciliation. You can also manage and validate extensions from this tab.
- Perform health check: From the Health Check tab, you can run a post installation health check on your files. For details, see Performing health check.
Encryption tab, you can generate an encrypted password to use when running a silent installation. This is applicable for Atrium Core version 9.1.03.001 and earlier. For details, see . Encrypt password: From the
From version 9.1.04 onwards, you can silently generate the encryption password through BMC Atrium Core Maintenance tool using command line utility. For more information,For more information,click here to expand...
-encrypt -encrypt [options]
[Required] Option: -password=<password>
Password to encrypt
[Required] Option: -confirm_password=<confirm_password>
Confirm password to encrypt
C:\Program Files\BMC Software\AtriumCore\atriumcore>AtriumCoreMaintenanceTool.cmd -encrypt -encrypt -password=arsystem -confirm_password=arsystem
- Deploy DSO mapping: From the DSO Mapping tab, you can deploy DSO mappings. Follow the steps are specified in the DSO deployment wizard.
Troubleshooting issues using BMC Atrium Core Maintenance Tool
If an issue occurs while running Maintenance Tool, investigate it by performing the following.
- Allow a minute for the Maintenance Tool to start.
The Maintenance Tool opens a command prompt window briefly and loads the components. The user interface might take a minute to display.
- If accessing the server remotely, verify the display environment is configured properly.
Maintenance Tool is a graphical display, so the display environment must be configured on UNIX.
When accessing a Windows system remotely using Terminal Services, the Maintenance Tool takes longer to display.
- Verify you access the server with a user with correct permissions.
The Maintenance Tool leverages the environment configured during installation, including environment variables and permissions to files and the JVM environment for the Maintenance Tool. Accessing the OS as the user who performed the installation is a good method to ensure the proper environment is available.
- Run the Maintenance Tool from the command line, which does not require a graphical user interface.
See To run Log Zipper from the command line.