This documentation supports the 20.02 version of BMC CMDB.

To view an earlier version, select the version from the Product version menu.

Summary of changes to the Common Data Model



This topic lists the changes that were made to the Common Data Model.




Changes to the BMC CMDB 20.02 Common Data Model

UnstructuredData attribute added to the BaseElement class

The details of the attributes are as given in the following table:

ClassAttributeDescriptionData typeRequired?Hidden?
BMC_BaseElementUnstructuredData
This attribute is used within CMDB to add and store data about CIs that do not conform to Common Data Model definitions. A CI does not conform to Common Data Model definitions when the data source is not capable of transforming the data or when the format of the data needs to be stored or consumed in an alternate format like JSON. You can use this attribute with structured data to represent a CI.
CharacterNN

Changes to ComponentAliases attribute

In versions earlier than 20.02, the maximum length of the ComponentAliases attribute was 0. In this release, the maximum length of this attribute is changed to 512 for new installations only. If you upgrade to CMDB version 20.02, the maximum length still remains as 0.

While upgrading to BMC CMDB 20.02, to change the maximum length of the attribute to 512, you must run a utility that changes the input length of the ComponentAliases attribute from 0 to 512. For the changes to take effect, you must perform a resync from your source data, such as BMC Discovery, SCCM, Atrium Integrator, or any external databases or files.

Perform the following steps to run the utility

  1. Access the utility.
  2. Run the following script: 
    ${JAVA_HOME}/bin/java -jar $SDIR/cdmchanges-9.1.10-SNAPSHOT.jar $ENCRYPTED_RAS_PASSWORD $AR_SERVER_CONNECT_NAME $AR_SERVER_PORT



Changes to the BMC CMDB 19.11 Common Data Model

This section lists the changes to Common Data Model for version 19.11 of BMC CMDB.

ComponentAliases and InstanceName attributes are added to the BaseElement class

The details of the attributes are as given in the following table:

ClassAttributeDescriptionData typeRequired?Hidden?
BMC_BaseElementComponentAliases

Is used within CMDB to pass information to the TrueSight Operations Manager tool. BMC Discovery populates this attribute but other discovery sources can also populate this attribute.

Note: If the ComponentAliases attribute does not exist in an earlier version, and you upgrade from earlier versions of CMDB to version 19.11, the upgrade process adds the attribute along with the description. But, if this attribute already exists, and you upgrade to CMDB version 19.11, you must add the description of the attribute in the Description field of Class Manager manually.

CharacterNN
BMC_BaseElementInstanceName

Indicates a specific instance of a configuration item (CI).

For example, if you have a database with various listeners, each DB instance has an InstanceName attribute that indicates the specific DB instance. For a PostgreSQL server, the InstanceName attribute refers to the port number of the PostgreSQL instance.

You can use this attribute not only for database servers but also for any class where a specific instance exists. For example, you can use this attribute to indicate specific instances that run in a common server in BMC_VirtualSystemEnabler and BMC_SoftwareServer classes.

CharacterNN

Change in attribute IDs for some attributes

Attribute IDs for Floor, Rack, Shelf, Room, Pillar, CostApportionment, and CostFlow attributes have changed. If you have used any of these attribute IDs for performing any customization, or have referred to the ID in any client program, then you must update these IDs with new attribute IDs. 

The following table lists the attribute IDs in CMDB version 19.11:


ClassAttributeAttribute ID in CMDB 19.11
BMC_ElementLocationFloorOAGAA5V0GOT7HAP6E6UJP6E6UJATIX
BMC_ElementLocationRackOAGAA5V0GOT7HAP6E6UJP6E6UJATIW
BMC_ElementLocationShelfOAGAA5V0GOT7HAP6E6UJP6E6UJATIV
BMC_ElementLocationRoomOAGAA5V0GOT7HAP6E6UJP6E6UJATIY
BMC_BaseRelationshipCostApportionmentOAGAA5V0GOT7HAP6E4UTP6E4UTATIU
BMC_BaseRelationshipCostFlowOAGAA5V0GOT7HAP6E32XP6E32XATIT
BMC_BaseRelationshipPillarOAGAA5V0H39N2APS8VYZPS8VYZ5091


Changes to the BMC CMDB 19.08 Common Data Model

This section lists the changes to Common Data Model for version 19.08 of BMC CMDB.

isVirtual attribute is moved to BMC_BaseElement class

In earlier days, only systems could be virtualized, because of which the isVirtual tag was included within BMC_System, BMC_SystemComponent, and BMC_Collection classes. But nowadays, almost any device can be virtualized. A new isVirtual attribute is added to the BMC_BaseElement class to enable any device (CI) to be represented logically rather than as a physical entity. The existing attribute on all the three classes has been renamed to isVirtual_old. The data that is stored in isVirtual_old attribute is maintained as it is.

Note

Starting with version 19.08, the isVirtual attribute is available in the BMC CMDB but is not available in Remedy ITSM or SmartIT.

ClassAttributeDescriptionRequired?Hidden?Possible ValuesDefault Value
BMC_BaseElementisVirtual

Specifies whether the system is virtual or physical.

NNNo, YesNo


Adding the isVirtual attribute

For new installations

For new installations of BMC CMDB, the isVirtual attribute is available within the BMC_BaseElement class.

Upgrade scenarios

If you upgrade from earlier versions of CMDB to CMDB version 19.08, during upgrade, the existing attribute is renamed to isVirtual_old on all the three classes. Subsequently, the new attribute isVirtual is added to the BaseElement class. If this upgrade process fails while renaming the existing attribute and creating a new attribute, due to various reasons, for example, if the user has already renamed the attribute to a customized name, or has added another new attribute for isVirtual, the upgrade remains in a 'Pending' state and you must fix the issues manually.

For more information, see  Troubleshooting installer failure during upgrade .

For Field IDs

In CMDB version 19.08, this attribute is available in the BaseElement class with a new field ID, which is 530075026. If you have any client applications or reports that use the existing field ID (530054200) for this attribute, you must change it to the new field ID.

For ADDM data sources

If data is populated to the isVirtual attribute using ADDM, we recommend that you do a full sync from ADDM to populate the values in the new attribute. If you want any values from the old attribute to be populated into the new attribute, you must migrate the values by creating an AI job and use the job to perform the migration task.

For AI or UDM data sources

If data is discovered using an Atrium Integrator job or UDM, those jobs must be modified to populate the attribute and rerun. If the attribute is referred from BMC_System class or BMC_Collection class, then the mapping has to be updated such that instead of BMC_System, BMC_Collection classes, the class name should now refer to the BMC_BaseElement class.


For Precedence rules for reconciliation merge activities


Manually update precedence rules that use the IsVirtual_old attribute with the new isVirtual attribute.




For more information about creating precedence sets for reconciliation merge activities, see  Creating precedence sets and associations for reconciliation merge activities.


Added the Pillar attribute to Location Relationships

Datacenters and facilities management applications and floor plans often reference ‘Pillars’ for locations. The Pillar attribute enables the CMDB administrator to store the pillar location as part of the relationship between a CI and its location.

Note

Starting with version 19.08, the Pillar attribute is available in the BMC CMDB but is not available in Remedy ITSM or SmartIT.

ClassAttributeDescriptionTypeRequired?Hidden?Default Value
BMC_ElementLocationPillarPillar where the CI is locatedChar (255)NNNull

The following short video shows the steps to add location attributes to a relationship.

 https://youtu.be/zQRzqNKNIjc

Added the TagName and TagValue attributes to Tag class

TagName and TagValue are attributes defined specifically for cloud instances to store descriptors of cloud services.  Tagging is useful for tracking resources related to cloud services for aggregating or creating reports, or for taking bulk actions on these resources. Tagging enables you to define keys and values and associate them with resources. 

For example, Calbro Software has several departments, and within each department there are several cost centers. Calbro Software creates tags for each of these cost centers to track resource usage and costs associated with it. 

When BMC Discovery discovers these cloud services, it splits the descriptors into key-value pairs, and stores each key inside a tag class. The administrator can then create a relationship (RelatedTo) between the tag and the cloud service that is discovered with it. This relationship is not necessarily a Dependency type of relationship. 

Note

Starting with version 19.08, the TagName and TagValue attributes are available in the BMC CMDB but is not available in Remedy ITSM or SmartIT.


ClassAttributeDescriptionTypeRequired?Hidden?Default Value
BMC_TagTagName

Attribute to store name of a given tag .

Example: Calbro_HR.Costcenter

Char (255)NNNull
BMC_TagTagValue

Attribute to store the value of a tag.

Example : Calbro_HR.Costcenter="102"

Char (255)NNNull


Created a new generic RelatedTo relationship

The BMC CMDB common data model contains several relationship types with their own required attributes, cardinality rules, and other elements. With the introduction of TagName and TagValue attributes for CIs that are related to cloud instances, a new generic relationship class ‘RelatedTo’ has been introduced that enables you to define relationships between CIs of different classes. However, it does not indicate a dependency between those CIs. It is also important to note that RelatedTo is is purely informational in nature and is not evaluated as part of Impact or any other processing.

Note

Starting with version 19.08, the RelatedTo attribute is available in the BMC CMDB but is not available in Remedy ITSM or SmartIT.


ClassDescription
BMC_RelatedTo

Used to relate CIs where no impact or true dependency exists. RelatedTo allows any class of CI to be related to a CI of any other class. This relationship has no direction, cardinality, or end point rules.


Added the isDR attribute to BMC_BaseRelationship to represent disaster recovery

The IsDR attribute available on BaseRelationship is used to indicate that a relationship with this attribute set to Yes, provides Disaster Recovery (DR) capability to the source. The source CI provides DR capability to the target CI.

Note

Starting with version 19.08, the isDR attribute is available in the BMC CMDB but is not available in Remedy ITSM or SmartIT.

ClassAttributeDescriptionRequired?Hidden?Possible ValuesDefault Value
BMC_BaseRelationshipIsDR

If the value of this attribute is set to Yes, it indicates that the source CI and destination CI are related to each other for the purpose of disaster recovery.

The direction for this attribute is from source to target.

NNYes, NoNo


Changes to the BMC CMDB 19.02 Common Data Model

This section lists the changes to Common Data Model for version 19.02 of BMC CMDB.

Added location attributes on relationships

New attributes have been added to location relationships to allow specific and detailed information to be stored for locations. For example, for Location CI called 'Datacentre Denver', a CI related to 'Datacentre Denver' can have attributes for elements such as floor, row, rack, shelf that are defined as part of the relationship.

ClassAttributeDescriptionTypeRequired?Hidden?Default Value
BMC_ElementLocationFloorFloor where CI is locatedChar (256)NNNull
BMC_ElementLocationRoomRoom where CI is locatedChar (256)NNNull
BMC_ElementLocationRackRack where CI is locatedChar (256)NNNull
BMC_ElementLocationShelfShelf where CI is locatedChar (256)NNNull

Best Practice

We recommend that two relationship CIs should not be created between two same end point CIs with different location information. If you have more than one active relationship for a location, it might be difficult to know the correct location of the CI.


Added new attributes for Cost Modelling

You can now use the following new attributes in the BMC_BaseRelationship class to allow for cost modeling: 

  • CostFlow —The CostFlow attribute enables you identify the directional flow of cost whether it flows upstream or downstream or is NULL.
  • CostApportionment —The CostApportionment attribute enables you to identify the percentage of source CI cost that is to be shared by the related item or service.

Example:
Server A hosts two services- Service 1 and Service 2. If Server A is related to the two services, the CostFlow on the relationships is set to Upstream and the CostApportionment is set to 50 to show that the upstream Service 1 and 2 contribute to the cost of Server A equally.


Changes to the BMC CMDB 18.08 Common Data Model

There were no changes to the 18.08 Common Data Model.


Changes to the BMC CMDB 18.05 Common Data Model

The following changes were made to the Common Data Model:


ClassAttributeDescriptionHidden?Needs Change in CDM diagram

BMC.CORE:BMC_BaseElement

BMC.CORE:BMC_BaseRelationship
NormalizationStatusNormalizationStatus attribute was changed from hidden to non-hiddenNYes


Changes to the BMC CMDB 9.1.04 Common Data Model

The following changes were made to the Common Data Model.

New enum were added to the attributes.

ClassAttributeDescriptionValueNeeds Change in CDM diagram

BMC.CORE:BMC_ComputerSystem

Primary CapabilityAdded new Enum Items ( Access Point Wireless LAN Controller )

Access Point

Wireless LAN Controller
No
BMC.CORE:BMC_ComputerSystemReconciliationIdentificationErrorAdded new Enum ItemErrorNo
BMC.CORE:BMC_ComputerSystemReconciliationIdentificationErrorReconciliationIdentificationError attribute was added on some classes as attribute and on some only as a field. This was rectified for all non-federated root classes this was added as an attribute.
Yes


Was this page helpful? Yes No Submitting... Thank you

Comments