This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

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.
  • Encrypt password: From the Encryption tab, you can generate an encrypted password to use when running a silent installation. This is applicable for Atrium Core version and earlier. For details, see  Encrypting passwords using the BMC Atrium Core Maintenance Tool
    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...


     Run encrypt
      -encrypt -encrypt [options]
    [Required] Option: -password=<password>
    Password to encrypt
    [Required] Option: -confirm_password=<confirm_password>
    Confirm password to encrypt

    For example:

    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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Related Information

  • BMC Remedy AR System Maintenance tool
  • BMC Remedy IT Service Management Maintenance tool
  • BMC Service Request Management Maintenance tool
  • BMC Service Level Management Maintenance tool
Was this page helpful? Yes No Submitting... Thank you