CDM Mapping for Cloud

This topic provides information about mapping for cloud nodes. The CIs created are described in this topic. 

Data models

Note

The default mapping works with CMDB versions 7.5, 7.6, and 7.6.03 and later. The data model in each is slightly different.

  • BMC_Impact relationships are not normally created with CMDB 7.6.03 and later, since the CMDB automatically maintains them itself. See the information about impact relationships for more details.


Click here for reference information on impact and the data models.

Different versions of the CMDB have subtly different data models. Syncmappings can support multiple data models with datamodel declarations. CMDB data models are assigned simple integer values:

Data model

CMDB versions

Effect

6

7.6.03 and later

HasImpact and ImpactDirection attributes are set as appropriate.

5

7.6.03 and later

Only to be used with legacy SIM version 7.4. BMC_Impact relationships with Name “ImpactOnly” are created.

4

7.6.03 and later

No impact details are set by BMC Discovery. They may be set by Impact Normalization in the CMDB.

3

7.6 before 7.6.03

BMC_Impact relationships with name “IMPACT” are created.

2

7.5

BMC_Impact relationships with name “IMPACT” are created.

BMC_CloudInstance (Provider)

The CloudProvider node is mapped to a BMC_CloudInstance CI with the following attributes:

Attribute

Details

Name

Cloud provider name

ShortDescription

Cloud provider short_name, or name

Description

Cloud provider name

ManufacturerName

Publisher comes from the publishers attribute in the metadata of the related cloud pattern. If no publishers are set, the default publisher is used where a default is specified in CMDB_SyncConfig.tpl.

Model

Cloud provider code

TokenId

Cloud provider key

See TokenId rules.

Company

Cloud provider company.

Category

"Cloud"

Type

"Cloud Provider"

Item

"Cloud Provider"

BMC_CloudInstance relationships

Relationship

Name

Source

Destination

BMC_Component
CLOUDREGIONFORPROVIDER

BMC_CloudInstance(Provider)

Impacted

BMC_CloudInstance(Region)


BMC_CloudInstance (Region)

The CloudRegion node is also mapped to a BMC_CloudInstance CI. It has the following attributes:

Attribute

Details

Name

Cloud region name

ShortDescription

Cloud region short_name, or name

Description

Cloud region name

ManufacturerName

Publisher comes from the publishers attribute in the metadata of the related cloud pattern. If no publishers are set, the default publisher is used where a default is specified in CMDB_SyncConfig.tpl.

Model

Cloud region code

TokenId

Cloud region key

See TokenId rules.

Company

Cloud region company.

Category

"Cloud"

Type

"Cloud Provider"

Item

"Cloud Region"

BMC_CloudInstance relationships

Relationship

Name

Source

Destination

BMC_Component
CLOUDSERVICEINREGION

BMC_CloudInstance
(Region)

BMC_CloudInstance(Service)

Impacted

BMC_CloudInstance (Service)

The CloudService node is also mapped to a BMC_CloudInstance CI. It has the following attributes:

Attribute

Details

Name

Cloud service name

ShortDescription

Cloud service short_name, or name

Description

Cloud service name

ConsumedService

Cloud service type

LastScanDate

Cloud service last_update_success

ManufacturerName

Publisher comes from the publishers attribute in the metadata of the related cloud pattern. If no publishers are set, the default publisher is used where a default is specified in CMDB_SyncConfig.tpl.

Model

Cloud service code

TokenId

Cloud service key

See TokenId rules.

Category

"Cloud"

Type

"Cloud Provider"

Item
Cloud service type

BMC_CloudInstance (Provider)

BMC_Cluster

A cluster dependent on CloudService mapped to a BMC_Cluster CI. It has the following attributes:

Attribute

Details

TokenId

TokenId is of the form "ADDM:%lb_service.key%".

See TokenId rules.

Name

Cluster name.

NameFormat

"ClusterName"

ManufacturerName

Publisher comes from the publishers attribute in the metadata of the related cloud pattern. If no publishers are set, the default publisher is used where a default is specified in CMDB_SyncConfig.tpl.

Model

Cluster type.

Description

Cluster name.

ShortDescription

Cluster name.

isCloud

Yes if the service exists directly within a cloud; null if not.

ComponentAliases

Cluster aliases.

CloudID

Cluster unique cloud identifier (cloud_id).

Company

Cloud service Company.

Category

"Unknown".

Type

"Unknown".

Item

"BMC Discovered".

Relationship

Name

Source

Destination

BMC_Dependency
CLOUDSERVICECLUSTER

BMC_CloudInstance
(Service)

BMC_Cluster
Impacted


BMC_LogicalSystemComponent

The cloud LoadBalancerService is mapped to BMC_LogicalSystemComponent. It has the following attributes:

Attribute

Details

TokenId

TokenId is of the form "ADDM:%lb_service.key%".

See TokenId rules.

Name

Load balancer service name or
Load balancer service name : cloud service name if the target is Remedyforce.

ShortDescription

Load balancer service short_name, or name

Description

Load balancer service name

isCloud

Yes if  the service exists directly within a cloud; null if not

Model

Load balancer service model

CloudID

Load balancer service unique cloud identifier (cloud_id).

Company

Cloud service Company

Category
"Network"
Type
"Service"
Item
"Load Balancer service"

BMC_LogicalSystemComponent relationships

Relationship

Name

Source

Destination

BMC_Dependency
LOADBALANCERSERVICE

BMC_CloudInstance(Service)

BMC_LogicalSystemComponentImpacted

BMC_ResourcePool

The cloud LoadBalancerPool is mapped to BMC_ResourcePool. It has the following attributes:

Attribute

Details

TokenId

TokenId is of the form "ADDM:%lb_pool.key%".

See TokenId rules.

Name

Load balancer pool name or
Load balancer pool name : cloud service name if the target is Remedyforce.

ShortDescription

Load balancer pool short.name

Description

Load balancer pool name

ResourceType

Other (0)

Company

Cloud service Company

Category
"Network"
Type
"Service"
Item
"Load Balancer pool"

BMC_ResourcePool relationships

Relationship

Name

Source

Destination

BMC_Component
HOSTEDRESOURCEPOOL

BMC_CloudInstance(Service)

BMC_ResourcePool
BMC_Dependency
LOADBALANCERSERVICE

BMC_ResourcePool
(Service)

BMC_LogicalSystemComponentImpacted

BMC_AdminDomain (AdminCollection)

The cloud AdminCollection node is mapped to BMC_AdminDomain. It has the following attributes:

Attribute

Details

Name

Administrative collection name orAdministrative collection name : cloud service name if the target is Remedyforce.

ShortDescription

Administrative collection short_name, or name

Description

Administrative collection name

ManufacturerName

Publisher comes from the publishers attribute in the metadata of the related cloud pattern. If no publishers are set, the default publisher is used where a default is specified in CMDB_SyncConfig.tpl.

Model

Administrative collection type

TokenId

Administrative collection {{code language="none"}}
key
{{/code}}

See TokenId rules.

CloudID

Administrative collection unique cloud identifier (cloud_id).

Company

Cloud service Company

Category
"Cloud"
Type
"Administrative Collection"
Item

Administrative collection name

BMC_AdminDomain (AdminCollection) relationships

Relationship

Name

Source

Destination

BMC_Dependency
CLOUDADMINCOLLECTION

BMC_CloudInstance(Service)

BMC_AdminDomain
BMC_Dependency
ADMINCOLLECTIONMEMBER

BMC_AdminDomain

BMC_BaseElement

BMC_AdminDomain (CloudManagementGroup, NestedCloudManagementGroup, OwnedManagementGroup)

The cloud CloudManagementGroup,  NestedCloudManagementGroup, and OwnedManagementGroup nodes are each mapped to BMC_AdminDomain. This mapping was updated in the November 2020 TKU. It has the following attributes:

Attribute

Details

Name

Management Group name

ShortDescription

Management Group short_name or name

Description

Management Group name

ConsumedService

Management Group type

isCloud

Yes if the service exists directly within a cloud; null if not.

LastScanDate

Cloud service last_update_success

Model

Management Group type

SerialNumber

Management Group id

TokenId

Management Group cloud_id

See TokenId rules.

CloudID

Management Group cloud_id

Company

Cloud service Company

Category 

"Cloud"

Type

"Cloud Management Group"

Item

Management Group type

BMC_AdminDomain (CloudManagementGroup) relationships

Relationship

Name

Source

Destination

BMC_MemberOfCollection
CLOUDMANAGEMENTGROUPPROVIDER
BMC_CloudRegion

BMC_AdminDomain
(CloudManagementGroup)
impacted

BMC_Component
CLOUDMANAGEMENTGROUPHIERARCHY

BMC_AdminDomain
(parent CloudManagementGroup)

BMC_CloudManagementGroup (child CloudManagementGroup)

BMC_MemberOfCollection
CLOUDMANAGEMENTGROUPOWNEDACCOUNT

BMC_AdminDomain(owning CloudManagementGroup)

BMC_AdminDomain
(owned CloudManagementGroup)

BMC_ConcreteCollection

The cloud Deployment node is mapped to BMC_ConcreteCollection. It has the following attributes:

Attribute

Details

Name

Deployment name or
Deployment name : cloud service name if the target is Remedyforce.

ShortDescription

Deployment short_name, or name

Description

Deployment name

Model

Deployment type

TokenId

Deployment {{code language="none"}}
key
{{/code}}

See TokenId rules.

CloudID

Deployment unique cloud identifier (cloud_id).

Company

Cloud service Company

Category
"Cloud"
Type
"Deployment"
Item

Deployment name

BMC_ConcreteCollection relationships

Relationship

Name

Source

Destination

BMC_Dependency
CLOUDDEPLOYMENT

BMC_CloudInstance(Service)

BMC_ConcreteCollection
BMC_Dependency
CLOUDDEPLOYMENT

BMC_Cluster(Service)

BMC_ConcreteCollection
BMC_Dependency
CLOUDDEPLOYMENT

BMC_Cluster(Cloud)

BMC_ConcreteCollection
BMC_Dependency
MEMBERINDEPLOYMENT
BMC_ConcreteCollection
BMC_BaseElement

Mapping of VirtualMachine nodes, SoftwareInstance nodes, and contained Database nodes

Where VirtualMachine nodes, SoftwareInstance nodes, and contained Database nodes that are cloud-hosted are populated, it is done so using the same rules as for those on a Host node. The mapping rules are shown below:

Excerpt named SIandDatabase was not found in document xwiki:IT-Operations-Management.Discovery.BMC-Discovery.DISCO221.Integrating.CMDB-synchronization.Default-CDM-Mapping.CDM-Mapping-for-Host.WebHome.

TokenId rules

TokenId is an attribute that, in some circumstances, aids the reconciliation of CIs populated by multiple data sources. BMC Discovery sets TokenId depending on the Node kind.

For most Nodes, TokenId is one of the forms:

key

or

ADDM:%key%

or

ADDM:%hashed_key%

For databases, TokenId is a database host found as a result of all possible combinations of where the database might be running:

%hosting_ci.TokenId%:%database_node.type%:%si_instance%:%database_node.instance%

and

%hosting_ci.Name%:%database_node.type%:%si_instance%:%database_node.instance%

For the Fibre Channel Node, TokenId is of the form:

WWN:%wwpn% 

For physical hosts, TokenId is of the form:

%host.hostname%:%host.dns_domain%

If the domain name is unavailable, then

%host.hostname%

For virtual hosts that are running in the cloud, TokenId contains instance_id.

  • For Alibaba, TokenId is of the form:
%alibaba_instance_id%
  • For Azure, TokenId is of the form:
%azure_vm_id%
  • For AWS, TokenId is of the form:
%aws_instance_id%
  • For GCP, TokenId is of the form:
%gce_instance_id%
  • For IBM, TokenId is of the form:
%instance_id%
  • For OCI, TokenId is of the form:
%ocid%

For virtual hosts that are running in the hypervisor, TokenId contains UUID.

  • For AHV, TokenId is of the form:
AHV-UUID:%uuid%
  • For Hyper-V, the UUID is only available on the physical machine, so TokenId is only set for virtual machines that have been successfully linked to their hosting physical machines:
HYPERV-ID:%vm_uuid%
  • For KVM (including RedHat Enterprise Virtualization), TokenId is of the form:
KVM-ID:%uuid%
  • For VMware, TokenId is of the form where each letter represents a hexadecimal digit:
VI-UUID:%uuid%
  • For Xen (including Oracle VM), TokenId is of the form: 
XEN-ID:%uuid%

The following table shows how TokenId looks like for different Node Kinds:

Node Kind

CI

TokenId

AdminCollection

BMC_AdminDomain

key

Cluster (cloud)

BMC_Cluster

key

LoadBalancerService

BMC_LogicalSystemComponent

ADDM:%key%

LoadBalancerPool

BMC_ResourcePool

ADDM:%key%

CloudManagementGroup

BMC_AdminDomain

cloud_id

CloudProvider

BMC_CloudInstance

key

CloudRegion

BMC_CloudInstance

key

CloudService

BMC_CloudInstance

key

Cluster

BMC_Cluster

ADDM:%hashed_key%

Database (cloud)

BMC_DataBase

ADDM:%key%

Database


BMC_DataBase


%hosting_ci.TokenId%:%database_node.type%:%si_instance%:%database_node.instance%
%hosting_ci.Name%:%database_node.type%:%si_instance%:%database_node.instance%

HardwareComponent

BMC_HardwareSystemComponent

ADDM:%hashed_key%

HardwareContainer

BMC_ComputerSystem

ADDM:%hashed_key%

HostContainer

BMC_ComputerSystem

ADDM:%hashed_key%

Host








BMC_ComputerSystem








%host.hostname%:%host.dns_domain%
%host.hostname%
ALIBABA-ID:%alibaba_instance_id%
AWS-ID:%aws_instance_id%
GCP-ID:%gce_instance_id%
IBM-ID:%instance_id%
OCI-ID:%ocid%
AZURE-ID:%azure_vm_id%
HYPERV-ID:%vm_uuid%
XEN-ID:%uuid%
KVM-UUID:%uuid%
AHV-UUID:%uuid%
VI-UUID:%uuid%

LoadBalancerGroup

BMC_Cluster

ADDM:%key%

MFPart

BMC_ComputerSystem

key

Namespace

BMC_AdminDomain

key

Deployment

BMC_ConcreteCollection

key

NetworkService

BMC_LogicalSystemComponent

ADDM:%key%

FibreChannelPort

BMC_NetworkPort

WWN:%wwpn%

SoftwareCluster

BMC_Cluster

ADDM:%hashed_key%

SoftwareComponent

BMC_ApplicationService

ADDM:%hashed_key%

SoftwareInstance

BMC_ApplicationSystem

ADDM:%hashed_key%

SoftwareInstance

BMC_SoftwareServer

ADDM:%hashed_key%

VirtualMachine

BMC_VirtualSystemEnabler

ADDM:%hashed_key%

StorageDevice

BMC_Cluster

ADDM:%key%

StoragePool

BMC_ResourcePool

ADDM:%key%

StorageSystemGroup

BMC_Cluster

ADDM:%key%

StorageProcessor

BMC_HardwarePackage

ADDM:%key%

HardwareContainer

BMC_HardwareSystemComponent

ADDM:%hashed_key%

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*