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
AtriumCoreMaintenanceTool.cmdutility 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.
- Click the Validate Extensions XML File tab to validate the extensions.
- 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.
On some Windows systems, log files are not generated if the %TMP% and %TEMP% variables do not point to the same location.
- Verify that the
driverscripts files are in UNIX format, without ^M characters, otherwise you might encounter errors, such as
CMDBdriver did not produce a CMDBdriver.out file.
- Examine the .out files to determine the output of the
Driveris a command line client for the AR System C API and
cmdbdriveris 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.
- Check the installation log files for the following warnings and errors:
Warnings — The
cmdbExtLoadermight 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.
- From a browser, query the SHARE:Application_Properties form to determine whether the required components and versions are installed on the server.
- If the .out file is not generated, perform the following steps:
- Start the
For more information about using the
cmdbdriver, see cmdbdriver program.
If you encounter errors when running the executables, use the
initcommands to log on to the
cmdbdriverprogram and to initialize it.
- Run the
excommand to execute the script.
- At the File name of input file prompt, specify the OSD file for
cmdbdriveror the ARD file for
These script files are located under the extensions directory. The script file for the
cmdbdriverprogram is named as OSD.txt and for the
driverprogram is named as ARD.txt.
- Start the