Other common extension loader issues
You might encounter extension loader errors if:
- Any script files for the extensions that you want to install are missing
- The extensions directory structure is incorrect when installing the extensions.
The following procedure provides instructions for troubleshooting extension loader issues. For more information about the
cmdbExtLoader program, see
in the BMC Atrium Core online documentation.
To troubleshoot extension loader issues
- Open the
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 following scripts:
driver— A command line client for the AR System C API.
cmdbdriver— 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.
- 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.
- Warnings — The
- 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:
For more information about using the
cmdbdriver, see in the BMC Atrium Core online documentation.
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.
- In the input file prompt for the file name, 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 OSD.txt and for the driver program is named ARD.txt.