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.

Other common extension loader issues

If any script files for the extensions that you want to install is missing or if the extensions directory structure is incorrect when installing the extensions, you might encounter errors.

The following procedure provides instructions to troubleshoot extension loader issues. For more information about the cmdbExtLoader program, see Managing BMC Atrium CMDB extensions.

To troubleshoot extension loader issues

  1. Open the AtriumCoreMaintenanceTool.cmd utility and click the Generate Extensions XML File tab to generate the XML file for the extensions.
    The atriumcore_configuration_log.txt file, which is created when you generate the extensions, reports any missing file errors.
  2. Click the Validate Extensions XML File tab to validate the extensions.
  3. If the extensions installation fails, click Browse to Log on the Log tab and look for SEVERE error messages displayed in the log.
    The log file path can be retrieved from the atriumcore_configuration_log.txt file.

    Note

    On some Windows systems, log files are not generated if the %TMP% and %TEMP% variables do not point to the same location.

  4. Verify that the cmdbdriver and driver scripts files are in UNIX format, without ^M characters, otherwise you might encounter errors, such as CMDBdriver did not produce a CMDBdriver.out file.
  5. Examine the .out files to determine the output of the driver or cmdbdriver scripts.
    Driver is a command line client for the AR System C API and cmdbdriver is a command line client for the BMC Atrium CMDB C API. The .out files indicate whether a script was successfully executed. In case of errors, specific error areas, such as AR System errors or BMC Atrium Core errors and their reasons are provided.
  6. Check the installation log files for the following warnings and errors:

    Warnings — The cmdbExtLoader might encounter AR System warning messages when installing the extensions. Warnings mean that the extensions were installed with exceptions to the requested operation. To troubleshoot warnings:
    • Check the log files to verify that the operation was completed successfully.
    • If the operation was completed successfully, import the records into the SHARE:Application_Properties form.

      Errors — Check for the following types of errors in the log files:
    • Dependency failure — The prerequisites listed in the package.xml file are not met.
    • Extension already exists — The installer found an extension that was already registered in the SHARE:Application_Properties form.
    • Extension already failed — The installer found a failed extension from a previous installation.

  7. From a browser, query the SHARE:Application_Properties form to determine whether the required components and versions are installed on the server.
  8. If the .out file is not generated, perform the following steps:
    1. Start the driver or cmdbdriver program.
      For more information about using the cmdbdriver, see cmdbdriver program.

      Note

      If you encounter errors when running the executables, use the log and init commands to log on to the cmdbdriver program and to initialize it.

    2. Run the ex command to execute the script.
    3. At the File name of input file prompt, specify the OSD file for cmdbdriver or the ARD file for driver.
      These script files are located under the extensions directory. The script file for the cmdbdriver program is named as OSD.txt and for the driver program is named as ARD.txt.
Was this page helpful? Yes No Submitting... Thank you

Comments