Launching the BMC Atrium Core Maintenance Tool
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. When you open the tool, the following tabs are displayed:
- Health Check
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.
To launch the BMC Atrium Core Maintenance Tool
- Access the system where BMC Atrium Core is installed.
- Navigate to the directory where BMC Atrium Core is installed.
This is the directory identified by the environment variable ATRIUMCORE_HOME.
- Change directories to the atriumcore directory.
- Run the Maintenance Tool:
- On Windows, go to your installation directory and double-click AtriumCoreMaintenanceTool.cmd.
- On UNIX, go to your installation directory and run
Each time that you run the BMC Atrium Core installer or uninstaller, a log file is created and a tab in the BMC Atrium Core Maintenance Tool is created. The tab's name reflects the date and time the installer or uninstaller is run.
In each log, errors are highlighted in red, and warnings are highlighted in yellow.
To run the BMC Atrium Core Maintenance Tool in silent mode
You can run the BMC Atrium Core Maintenance Tool silently by entering the
-silent parameter at the command line. You can use the
-silent option to run the log zipper, encryption, or DSO mappings.
- Open a command window and then navigate to the directory where the BMC Atrium Core Maintenance Tool is installed.
If this is a new installation, the Maintenance Tool resides in the installation directory under <bmcAtriumCoreInstallationDirectory>\atriumcore_home\atriumcore.
- Run the installer with the
On Windows, enter:
AtriumCoreMaintenanceTool.cmd -i silent <tabName> <commandName>
On UNIX, enter:
AtriumCoreMaintenanceTool.sh -i silent <tabName> <commandName>
For example, to run the log zipper for BMC Atrium Core, enter:
AtriumCoreMaintenanceTool.cmd -i silent -logs -zip_logs
By default, the output is zipped and then stored in the Users profile folder. For example:
To specify a different output file name or location, add the
-output_file=<output_file_option>parameter. For example:
AtriumCoreMaintenanceTool.cmd -i silent -logs -zip_logs -output_file=C;\AtriumCore7700.zip
To display help, enter
To encrypt a password for silent installation
The BMC Atrium Core Maintenance Tool allows you to create an encrypted password. You might be required to enter this encrypted password when running a silent installation.
- Open the BMC Atrium Core Maintenance Tool.
- Click the Encrypt tab.
- Enter your password in the Password field and the Confirm Password field.
- Click Encrypt.
- Copy and paste the encrypted password into the Options.txt file for your silent installer.
For example, if you want to encrypt the
ProductNamepassword, and the output is
DES\:b76c59dbc2e1433c7a9c2,enter the following string:
# -J BMC_AR_PASSWORD=DES\:b76c59dbc2e1433c7a9c2
# -J BMC_AR_CONFIRM_PASSWORD=DES\:b76c59dbc2e1433c7a9c2
To troubleshoot issues with running 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.