This topic provides information about CDM mapping for Host nodes.
Host nodes in the Discovery model are mapped to the Common Data Model as shown in this automatically-generated diagram:
The CIs created are described below.
CMDB version differences
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.Differences from previous versions of BMC Atrium Discovery
Except where noted below, the model populated by BMC Atrium Discovery version 9.0 is the same as that populated by earlier versions.
The root Host
node is mapped to a root BMC_ComputerSystem
CI with the following attributes:
Attribute | Details |
---|---|
Name | The fully qualified name of the host if available, otherwise the unqualified name; if no names are available, the IP address |
NameFormat | " |
ShortDescription | Host |
Description | The host name and the fully qualified domain name separated by a colon |
CapabilityList | A single value corresponding to Server, Desktop, or Laptop |
Domain | Host |
HostName | Host |
isVirtual |
|
LastScanDate | Host |
ManufacturerName | Host |
Model | Host |
PrimaryCapability | Server, Desktop or Laptop |
SerialNumber | Host |
SystemType | Enumeration value corresponding to the system type |
TokenId | See TokenId rules below |
PartitionId | Host |
TotalPhysicalMemory | Host |
VirtualSystemType | Enumeration value corresponding to the type of virtual machine |
Workgroup | Host |
Category | " |
Type | " |
Item | " |
TokenId
is an attribute that in some circumstances aids reconciliation of CIs populated by multiple data sources. The following describes how discovery sets TokenId for BMC_ComputerSystem
.
For most hosts, TokenId
is of the form hostname:
DNS domain name.
For some virtual hosts, TokenId
contains a UUID:
TokenId
is of the form "VI-UUID:
ABCD-
EF-
GH-
IJ-
KLMNOP". Where each letter represents a hexadecimal digit.TokenId
is of the form "HYPERV-ID:
ABCD-
EF-
GH-
IJ-
KLMNOP". With 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.TokenId
is of the form "XEN-ID:
ABCD-
EF-
GH-
IJ-
KLMNOP".TokenId
is of the form "KVM-ID:
ABCD-
EF-
GH-
IJ-
KLMNOP".The root Host
is also mapped to a single BMC_OperatingSystem
CI, with the following attributes:
Attribute | Details |
---|---|
Name | Host |
NameFormat | " |
ShortDescription | " |
Description | Host |
ManufacturerName | Host |
MarketVersion | Host |
Model | Host |
OSType | Enumeration value for OS type |
OSProductSuite | Enumeration value for OS product suite |
ServicePack | Host |
VersionNumber | Host |
Category | " |
Type | " |
Item | " |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
The root Host
is mapped to a number of BMC_Processor
CIs.
In some circumstances, it is not possible to discover the number of physical CPU packages in a physical machine. In such cases, no BMC_Processor
CIs are created for the machine.
All the BMC_Processor
CIs for a host are normally identical to each other. New in BMC Atrium Discovery 8.3, they can be different in cases that a physical machine has more than one type of CPU.
Attribute | Details |
---|---|
Name | " |
NameFormat | " |
ShortDescription | Host |
Description | Description of the processor and its index |
isVirtual | True if the Host is virtual; not set if physical. (Not present in CMDB 7.5.) |
ManufacturerName | Manufacturer of the processor. (New in ADDM 8.3.) |
MaxClockSpeed | Host |
Model | Host |
NumberOfCores | Host |
NumberOfLogicalProcessors | Host |
OtherProcessorFamilyDescription | Host |
ProcessorArchitecture | Enumeration representing the architecture |
ProcessorFamily | Enumeration representing the processor family |
ProcessorStatus | 1 – CPU enabled |
ProcessorType | 2 – Central processor |
UpgradeMethod | 1 – Unknown |
Category | " |
Type | " |
Item | " |
Difference from BMC Atrium Discovery 8.1
BMC Discovery version 8.1 always created one single BMC_Processor
CI, regardless of the circumstances.
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
Each NetworkInterface
node connected to the root Host
in the Discovery model is mapped to a BMC_NetworkPort
, and its MAC address is mapped to a BMC_LANEndpoint
. Each of its associated IP addresses are mapped to BMC_IPEndpoint
CIs.
Where Discovery has been able to connect a NetworkInterface
to a NetworkDevice
(via associated port nodes), a BMC_Dependency
relationship is created between the two BMC_ComputerSystem
CIs representing the host and the network device.
Attribute | Details |
---|---|
Name | NetworkInterface |
ShortDescription | NetworkInterface |
Description | NetworkInterface |
AutoSense | Yes (0) or No (1) or null if not known |
FullDuplex | Yes (0) or No (1) or null if not known |
LinkTechnology | Ethernet (2) |
ManufacturerName | NetworkInterface |
PermanentAddress | NetworkInterface |
PortType | Ethernet (2) |
Speed | NetworkInterface |
Category | " |
Type | " |
Item | " |
Each Fibre Channel HBA card node is mapped to the BMC_NetworkPort CI with the following attributes:
Attribute | Details |
---|---|
Name | FibreChannelHBA description and FibreChannelPort wwpn or just FibreChannelPort wwpn |
ShortDescription | FibreChannelPort wwpn |
Description | FibreChannelHBA description and FibreChannelPort wwpn or just FibreChannelPort wwpn |
LinkTechnology | Fibre Channel (4) |
ManufacturerName | FibreChannelHBA vendor |
Model | FibreChannelHBA model |
PermanentAddress | FibreChannelPort wwpn |
PortType | Fibre Channel (6) |
SerialNumber | FibreChannelHBA serial |
Category | “H |
Type | “Card” |
Item | “Fibre Channel HBA card” |
Differences from earlier BMC Atrium Discovery versions
BMC_NetworkPort
was not created in versions prior to 8.3.
MAC addresses in the Discovery data model are stored in the conventional form with colons separating each pair of hexadecimal digits; in the CDM, MAC addresses are stored as just the hexadecimal digits, with no separating colons.
Attribute | Details |
---|---|
Name | NetworkInterface |
NameFormat | " |
ShortDescription | NetworkInterface |
Description | "MAC address |
Address | MAC address (no separating colons) |
MACAddress | MAC address (no separating colons) |
ProtocolType | Ethernet (14) |
Category | " |
Type | " |
Item | " |
Differences from earlier BMC Atrium Discovery versions
Prior to version 8.3, Category
was set to "Miscellaneous
" instead of "Network
" and Address
was set to the IP address, not the MAC address.
Attribute | Details |
---|---|
Name | IPAddress |
NameFormat | " |
ShortDescription | IPAddress |
Description | IPAddress |
Address | IPAddress |
AddressType | IPv4 (1) or IPv6 (2) |
DNSHostName | IPAddress |
ProtocolType | IPv4 (2) or IPv6 (3) |
SubnetMask | IPAddress |
ManagementAddress | Yes (1) if the IP address was used to scan the host; No (0) if not. (Not in CMDB 7.5.) |
Category | " |
Type | " |
Item | " |
Differences from earlier BMC Atrium Discovery versions
Prior to version 8.3, Category
was set to "Miscellaneous
" instead of "Network
".
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Discovery Subnet
is mapped to BMC_IPConnectivitySubnet
:
Attribute | Details |
---|---|
Name | Subnet |
ShortDescription | Subnet |
Description | Subnet |
AddressType | IPv4 (1) or IPv6 (2) |
PrefixLength | IPAddress |
SubnetMask | IPAddress |
SubnetNumber | Subnet |
Category | " |
Type | " |
Item | " |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
Host
Cluster
nodes are mapped to BMC_Cluster
:
Attribute | Details |
---|---|
Name | Cluster |
NameFormat | " |
Description | Cluster |
ShortDescription | Cluster |
Category | " |
Type | " |
Item | " |
TokenId | Attribute that aids reconciliation of CIs populated by multiple data sources. |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
When a physical machine hosts one or more virtual machines, the Discovery model represents it as a number of SoftwareInstance
nodes related to the physical Host
, one SoftwareInstance
per virtual host. In the CDM, the BMC_ComputerSystem
corresponding to the physical machine has a BMC_HostedSystemComponents
relationship to a single BMC_VirtualSystemEnabler
CI. (Strictly speaking, it is one per technology, so a physical machine running more than one virtualization technology could have more than one BMC_VirtualSystemEnabler
CI.)
Attribute | Details |
---|---|
Name | SoftwareInstance |
ShortDescription | " |
Description | " |
BuildNumber | SoftwareInstance |
EnablerType | Enumeration representing the type of virtualization technology |
ManufacturerName | Publisher from the Pattern maintaining the SoftwareInstance |
MarketVersion | SoftwareInstance |
Model | SoftwareInstance |
PatchNumber | SoftwareInstance |
ServicePack | SoftwareInstance |
VersionNumber | SoftwareInstance |
Category | " |
Type | " |
Item | " |
Differences from earlier BMC Atrium Discovery versions
Prior to version 8.3, Name
was set to the BMC_ComputerSystem
Name
.
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
HostContainer
nodes are mapped to BMC_ComputerSystem
representing the partitioned container.
Attribute | Details |
---|---|
Name | HostContainer |
ShortDescription | HostContainer |
Description | HostContainer |
CapabilityList | " |
LastScanDate | Host |
ManufacturerName | HostContainer |
Model | HostContainer |
OtherCapabilityDescription | HostContainer |
PrimaryCapability | Other (2) |
SerialNumber | HostContainer |
Category | " |
Type | " |
Item | HadwareContainer |
TokenId | Attribute that aids reconciliation of CIs populated by multiple data sources. |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
Each SoftwareInstance
in the Discovery model is mapped to either a BMC_SoftwareServer
CI or a BMC_ApplicationSystem
CI:
SoftwareInstance
nodes with DDD triggers are directly running on a single host, and are mapped to BMC_SoftwareServer
SoftwareInstance
nodes composed of other SoftwareInstance
nodes are mapped to BMC_ApplicationSystem
.Note that SoftwareInstance
nodes are also mapped (in an indirect manner) to BMC_Product
.
Except as noted, the attributes set are the same in BMC_SoftwareServer
and BMC_ApplicationSystem
.
Attribute | Details |
---|---|
Name | SoftwareInstance |
ShortDescription | SoftwareInstance |
Description | SoftwareInstance |
BuildNumber | SoftwareInstance |
ManufacturerName | Publisher specified in the maintaining Pattern or on the SoftwareInstance |
MarketVersion | SoftwareInstance |
Model | SoftwareInstance |
OtherSoftwareServerType | SoftwareInstance |
PatchNumber | SoftwareInstance |
ServicePack | SoftwareInstance |
SoftwareServerType | Enumeration representing the type of SoftwareServer. Often 0 meaning "Other". (Only in |
VersionNumber | SoftwareInstance |
Category | " |
Type | " |
Item | Product category from the maintaining Pattern |
TokenId | Attribute that aids reconciliation of CIs populated by multiple data sources. |
Item values
The Item
attribute is populated from the Pattern that is maintaining the SoftwareInstance. To obtain a list of all the possible Item
values, perform the following query in the Discovery Generic Query page:
search Pattern show categories processwith countUnique(0)
Differences from earlier BMC Atrium Discovery versions
Prior to version 8.3, Name
was set to "hostname:
type:
name".
Version 8.2 mapped all SoftwareInstance
nodes to BMC_SoftwareServer
. Version 8.1 mapped those SoftwareInstances
containing other SoftwareInstances
to BMC_ApplicationInfrastructure
.
Version 8.1 always hard-coded Item
to "BMC Discovered
".
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
As shown in the table, BMC_SoftwareServer
and BMC_ApplicationSystem
CIs can be related to each other with a BMC_Dependency
relationship. This is mapped from both Dependency
and Communication
relationships between the SoftwareInstance
nodes in the Discovery model.
BMC_SoftwareServer
and BMC_ApplicationSystem
CIs also have relationships to BMC_Product
, shown in the table below.
BMC_Product
represents the installed aspects of a product. BMC Atrium Discovery uses SoftwareInstance
nodes and associated metadata to provide an accurate picture of the installed products, regardless of how the products are installed. The mapping groups the SoftwareInstance
nodes according to the product information on the maintaining patterns, and maintains one BMC_Product
CI for each unique product version on the Host. SoftwareInstance
nodes with different types can belong to a single product. So, for example, a server running four Oracle database instances and one Oracle TNS Listener would have five SoftwareInstance
nodes; those five SoftwareInstances
would map to a single "Oracle Database" BMC_Product
CI.
Attribute | Details |
---|---|
Name | "product name |
NameFormat | " |
ShortDescription | "product name product version" — up to and including TKU 2012-Nov-1 |
Description | "product name product version on hostname" — up to and including TKU 2012-Nov-1 |
BuildNumber | SoftwareInstance |
ManufacturerName | Publisher from Pattern or |
MarketVersion | SoftwareInstance |
Model | Product name from Pattern or |
PatchNumber | SoftwareInstance |
ServicePack | SoftwareInstance |
VersionNumber | SoftwareInstance |
Category | " |
Type | " |
Item | Product category from the maintaining Pattern |
Item values
The Item
attribute is populated from the Pattern that is maintaining the SoftwareInstance. To obtain a list of all the possible Item
values, perform the following query in the Discovery Generic Query page:
search Pattern show categories processwith countUnique(0)
Difference from BMC Atrium Discovery 8.1
BMC Atrium Discovery version 8.1 always hard-coded Item
to "BMC Discovered
".
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
SoftwareComponent
is mapped to BMC_ApplicationService
.
Attribute | Details |
---|---|
Name | SoftwareComponent |
ShortDescription | SoftwareComponent |
Description | SoftwareComponent |
Model | SoftwareComponent |
VersionNumber | SoftwareComponent |
ApplicationServiceType | Enumeration value representing the service type |
Category | " |
Type | " |
Item | " |
TokenId | Attribute that aids reconciliation of CIs populated by multiple data sources. |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
DatabaseDetail
nodes representing logical databases are mapped to BMC_DataBase
:
Attribute | Details |
---|---|
Name | DatabaseDetail |
ShortDescription | DatabaseDetail |
Description | DatabaseDetail |
ManufacturerName | SoftwareInstance |
MarketVersion | SoftwareInstance |
Model | DatabaseDetail |
PatchNumber | SoftwareInstance |
ServicePack | SoftwareInstance |
VersionNumber | SoftwareInstance |
Category | " |
Type | " |
Item | " |
TokenId | Attribute that aids reconciliation of CIs populated by multiple data sources. |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
Differences from earlier BMC Atrium Discovery versions
BMC_DataBase
was not created in version 8.2.
BusinessApplicationInstance
is mapped to BMC_Application
. Contained SoftwareInstance
and BusinessApplicationInstance
nodes are mapped to corresponding BMC_Component
relationships.
Name | BusinessApplicationInstance |
ShortDescription | BusinessApplicationInstance |
Description | BusinessApplicationInstance |
MarketVersion | BusinessApplicationInstance |
Model | BusinessApplicationInstance |
VersionNumber | BusinessApplicationInstance |
Category | " |
Type | " |
Item | " |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FunctionalComponent
nodes representing CAM Functional Components are mapped to BMC_ConcreteCollection
— from TKU 2014-Jan-1 onwards.
Attribute | Details |
---|---|
Name | Functional Component |
ShortDescription | Functional Component |
Description | Functional Component |
Model | Functional Component |
Company | Host |
Category | " |
Type | " |
Item | " |
Relationship | Name | Source | Destination |
---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The relationship between BMC_Application
and BMC_ConcreteCollection
is used for Functional Components reached from any of the following node kinds:
5 Comments
Unknown User (petrus.johansson@ikea.com)
I see that HBAs of a Host node is missing from the mapping table above.
Brice-Emmanuel Loiseaux
That's correct. This is a special case for BMC_NetworkPort CI creation based on FibreChannelHBA and FibreChannelPort nodes attributes.
Unknown User (petrus.johansson@ikea.com)
So it shouldn´t be documented, is that what you are saying?
Brice-Emmanuel Loiseaux
No, it should. It's just a question of writing it elegantly.
Unknown User (petrus.johansson@ikea.com)
Come to think IF it...shouldnt the 'Item' attributen be 'Fibrer Channel Port' instead IF 'Fibrer cannl HBA port' since it is a sanswitch port?