Preparing your data and performing a health check before you upgrade BMC Atrium Core
Perform the following tasks 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
Note
Job definitions are not upgraded automatically, but after your upgrade is complete, you can create new jobs in the BMC Atrium Core Console.
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.Note
On a UNIX computer, you may need to open the arcmdbd.sh file and set LD_LIBRARY_PATH to the path where the BMC Atrium CMDB files and directories are installed.
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.Note
If BMC Remedy AR System server fails to copy the
cmdb-9.1.00-SNAPSHOT.jar
file into BMC_AR_SYSTEM_HOME\deploy folder, the AtriumPluginSvr log reports the following error: "RPC failed with: ERROR (8203): The server's RPC version is not supported." Other log files also report errors that indicate thecmdb-9.1.00-SNAPSHOT.jar
file is missing from the deploy folder. For more information about the possible errors and resolving these errors, refer to kA214000000
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).Important
If you find that the ARDBC.Notify plug-in is not running, from the ar.conf or the ar.cfg file, set the following parameters to match your environment:
Plugin
,BMC-ARDBC-NOTIFY-Server-Port
,BMC-ARDBC-NOTIFY-Protocol-V1-Encrypt
,BMC-ARDBC-NOTIFY-Event-Cache
, andBMC-ARDBC-NOTIFY-Verify-Log
.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 | Proceed to Preparing the AR System server before you upgrade BMC Atrium Core and other BMC applications. |
---|---|
Up to process | If you have finished upgrading the platform, return to the appropriate upgrade process: |
Comments
This link doesn't open anything: Summary of changes to the Common Data Model
Hi Jose Leon,
I fixed the broken link. Please check.
Regards,
Sirisha
Yes it is working! Thank you.
Link at " Performing a health check" seems to be broken. I get to a page stating that I need a new app (ac1805) to open.
Hi Peter Ekendahl,
I fixed the broken link. Please check.
Regards,
Sirisha
Log in or register to comment.