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.

Issues that might arise during the CDMChecker pre-upgrade check

During the pre-upgrade check, CDMChecker detects discrepancies in the Common Data Model (CDM). You cannot upgrade BMC Atrium Core if CDMChecker detects customization in your CDM that did not follow the standard guidelines.

Identifying issues with CDMChecker

During upgrade, CDMChecker identifies the following issues:

When

CDMChecker reports errors if

To troubleshot

To proceed with upgrade

Before an upgrade is initiated.
(Errors are displayed in the Pre-Checks for BMC Atrium Core panel)

#Classes are not in the Active state

Identify and delete classes that are not in Active state

To initiate the upgrade, in the installer, click Previous and then resume with the upgrade.

Before an upgrade is initiated.
(Errors are displayed in the Pre-Checks for BMC Atrium Core panel)

#Attributes are not in the Active state

Identify and delete attributes that are not in Active state

To initiate the upgrade, in the installer, click Previous and then resume with the upgrade.

Upgrade fails
(Errors are displayed in the Installation Summary panel.)

#Fields are missing from AR forms

Identify and delete missing fields from AR forms

After you fix the issue, uninstall the components that failed to upgrade. And then run the BMC Atrium Core installer again to initiate the upgrade.
Note: For BMC Atrium Web services, if upgrade fails, you need to do fresh install.

Troubleshooting classes and attributes that are not active

Typically, before an upgraded is initiated, CDMChecker identifies if certain classes or attributes are inactive. It identifies if the classes or attributes are in Change Pending or Delete Pending state. These errors are displayed in the Pre-Checks for BMC Atrium Core panel. You must troubleshoot these issues and then proceed with the upgrade.

Note

If a class or an attribute is in the Change Pending state, investigate the cause. For more information about resolving issues related to Change Pending state, see this comment on BMC Communities.
For more information about classes and attributes in pending state, see knowledge article KA289957 available at http://www.bmc.com/support/knowledge-base.You can view published articles from the knowledge base by logging in to the Knowledge Base with your Support credentials.

To identify and delete classes that are not in Active state

If some classes are in the Change Pending or Delete Pending state, CDMChecker pre-upgrade check fails. In this case, open the OBJSTR:Class form to determine such states of the classes and change them into active state or delete the state of those classes.

  1. Open the the OBJSTR:Class form in search mode.
  2. Select View > Advanced Search Bar.
  3. In the Advanced Search Bar, type the following query:
    'Pending ID' != "0" OR 'System Status*' != "Active" OR 'OSStatus' != "Active" OR 'Record Status' != "Active" OR 'Status' != "Active" OR 'Session Status' != "Just Created"
    In the query results, identify the rows in which classes are not built or deleted properly. 
  4. Delete all entries that have a Delete Pending state.

To Identify and delete attributes that are not in Active state

If some attributes are in the Change Pending or Delete Pending state, the CDMChecker pre-upgrade check fails (indicated by a disabled Next button) and the upgrade stops. In this case, query the OBJSTR:AttributeDefinition form to find out which attributes are in Delete Pending state and delete these attributes.

  1. Open the the OBJSTR:AttributeDefinition form in search mode.
  2. Select View > Advanced Search Bar.
  3. In the Advanced Search Bar, type the following query:
    'OSStatus' != "Active" OR 'Pending ID' != "0"
    If this query returns any row, then these rows should be investigated as attributes that are not built or deleted properly.
  4. Delete those attributes that are in the Delete Pending state.

Troubleshooting fields that are missing from AR forms

If some fields are not present on some AR forms, but are present in the Attribute Definition form, the CDMChecker pre-upgrade check fails and the upgrade stops. To troubleshoot, identify such fields and delete them from the Attribute Definition form.

To identify and delete missing fields from AR forms

  1. Open the missing-Fields.log file in a text editor. The missing-Fields.log file is available at the following location:
    <AtriumCore install directory>\BMC Software\AtriumCore\Logs
  2. Search for errors related to missing fields.
    For example, your error messages might look like this:
    Error during ARGetMultipleFields in FindMissingFields Status: Field does not exist on current form. Details: BMC.Core:BMC_BaseElement: <767767002>
    In class BMC.Core:BMC_BaseElement, for attribute upgrtest_Attb03 with attribute id OA-036109F846EB4A578066CE81CD9E66D3, could not find corresponding AR field with ID=767767002 on form BMC.Core:BMC_BaseElement.
    In this example, an attribute with a name as upgrtest_Attb03 is missing from the BMC.Core:BMC_BaseElement form.
  3. Delete all the attributes that are missing from the AR forms.
  4. Open the the OBJSTR:AttributeDefinition form in search mode.
  5. Search all the attributes that could not be found in AR forms.
    For example, if the missing_fields.log file recorded an attribute with a name as upgrtest_Attb03 to be missing from BMC.Core:BMC_BaseElement form, search for this attribute in the OBJSTR:AttributeDefinitions form.
  6. Delete the attributes that are missing from the AR forms.
    For example, delete the upgrtest_Attb03 attribute.
Was this page helpful? Yes No Submitting... Thank you

Comments