Preparing your data and performing a health check before you upgrade BMC Atrium Core
To prepare data for upgrade from any version of BMC Atrium Core
If you have jobs that are defined against deprecated classes, the jobs do not successfully upgrade and errors might occur. To overcome these errors, delete all rules that have been defined for deprecated classes. For details about the changes to BMC Atrium common data model (CDM), see Summary of changes to the Common Data Model
To perform a health check of BMC Atrium CMDB
Before you upgrade, you must verify that the class definitions in your data model are correct. Class definitions in your data model are verified when you perform a health check of BMC Atrium CMDB.
Follow these steps to manually verify the data model and perform a health check:
From the BMC Atrium CMDB Maintenance tool, run the health check. See Performing a health check. For more information about possible errors and resolving the errors, refer to kA214000000
Examine the arerror.log located at <InstallDirectory>\BMC Software\ARSystem\Arserver\Db and cmdbengdebug.log located at <InstallDirectory>\BMC Software\ARSystem\Arserver\Db files for any errors about starting the cmdbEngine.
Search for the string cmdbEngine to find errors. When the cmdbEngine is started, it validates the class definitions. The following example shows an error message that you might see in arerror.log:*Mon Dec 11 16:10:18 2006 390600 : The specified super class with given classId is not found. : Class ID: OB005056C00008PlV3RQU3oZAAHO8C, Super Class ID: OB005056C00008F1V3RQd#IYAAD90C (ARERR 120132)*- Perform the following steps to verify that all classes in your data model are active:
- In a browser, open the OBJSTR:Class form in search mode.
In the Advanced Search Bar at the bottom of the window, specify the following query:
'OSStatus' != "Active" OR 'Pending ID' != "0" OR 'System Status*' != "Active" OR 'Record Status' != "Active" OR 'Status' != "Active"If this query returns any rows, it means that those classes were either not correctly created or not correctly deleted.
- Check the classes listed in the result window to investigate the issue.
- Perform the following steps to verify that all attributes for the classes are Active.
- In a browser, open the OBJSTR:AttributeDefinition form in Search mode.
In the Advanced Search Bar at the bottom of the window, specify the following query:
'OSStatus' != "Active" OR 'Pending ID' != "0" OR 'Record Status' != "Active"If this query returns any rows, it means that those attributes were either not correctly created or not correctly deleted.
- (If upgrading from version 9.0 or later) To identify pending metadata:
Run cmdbdriver from the BMC Remedy AR System server .
For information, see cmdbdriver program in BMC Atrium Core documentation.Type the glc command to get the list of classes.
Accept default values for all prompts displayed for this command. A list of classes is displayed.
Only if upgrading a clone of your current production environment(staged upgrade) or upgrading in-place, ensure that the ARDBC.Notify plug-in is running.
ARDBC.Notify plug-in is a component installed with BPPM CMDB extensions.
The condition does not apply when upgrading against a database (DB-only upgrade).- Import the NOE:QueryTransaction form. If you are upgrading from BMC Atrium Core version 7.6.04 or 8.1 to version 18.08 perform the following steps:
- Ensure that you have imported the NOE:QueryTransaction form. The NOE:QueryTransaction is a custom form in version 8.1 and during the upgrade, the installer converts the form to a regular non-overlaid form.
- Choose the Best Practice mode.
Delete the Custom NOE:QueryTransaction form and import the attached NOE:QueryTransaction.xml file using the Base Development mode in dev studio (version 1808). You can import the entire NOE:QueryTransaction definition file with Overwrite option on.
See Knowledge article 000157623 for more information.
Configure the AtriumPluginSvr 9556 plugin. Sometimes during the upgrade process, the AtriumPluginSvr 9556 plugin fails to upgrade. This is caused by bad log4j_configsvr.xml in 8.1. Perform the following steps.
- Create the file using the attached sample files, pluginsvr_config.xml and log4j_pluginsvr.xml.
- Edit the file and replace the drive letter C: with the drive letter of your computer. Change the hostname in the pluginId to match the server on which the plugin is running.
See Knowledge article 000157623 for more information.
- When you upgrade BMC Atrium Core, overlays in CMDB forms can cause major issues. You must remove overlays from the CMDB forms before you perform the upgrade.
Where to go from here
Next task | |
---|---|
Up to process | If you have finished upgrading the platform, return to the appropriate upgrade process: |
Related Topics