For simple topologies, you can directly map data from the discovery XML to RTSM, without the need to provide a sync package.
Create a script (or program) that runs on the BSM Connector server and discovers configuration items (CIs) and CI relations. This discovery script must write details of each discovered CI in XML to a file on the BSM Connector system or send it through the REST Web Service. For details on the XML syntax, see Topology Discovery Syntax.
To make sure that data is mapped directly to RTSM, you must set the following attributes for the instance you want to map:
hpom_citype
Sets the CI type as stored in the RTSM.
hpom_discoTarget
Set this attribute to the value "BSM".
ucmdb_<CI_attribute_name>
Attribute names with the prefix ucmdb_
map directly to CI attributes in RTSM. For example, ucmdb_primary_dns_name
maps to the CI attribute primary_dns_name.
Syntax:
<Attributes> <attribute name="hpom_citype" value="<CIType>" <attribute name="hpom_discoTarget" value="BSM"> <attribute name="ucmdb_<CI_attribut_name>" value="<CIValue>"> </Attributes>
Examples:
In the following example, the CI type set to "host_node" and the attributes "name" and "primary_dns_name" are mapped to the corresponding CI attributes in RTSM.
<NewInstance ref="HOST:server3.company.com"> <Std>DiscoveredElement</Std> <Virtual/> <Key>HOST:server3.company.com</Key> <Attributes> <attribute name="hpom_citype" value="host_node"> <attribute name="hpom_discoTarget" name="BSM"> <attribute name="ucmdb_name" value="server3"> <attribute name="ucmdb_primary_dns_name" value="server3.company.com"> <attribute name="ucmdb_data_externalid" value="server3.company.com"> </Attributes> </NewInstance>
In the following example, the CI type set to "sqlserver" and the attributes "name", "database_dbsid", and "discovered_product_name" are mapped to the corresponding CI attributes in RTSM.
<NewInstance ref="SQLSERVER:MSSQLSERVER:server3.company.com"> <Std>DiscoveredElement</Std> <Virtual /> <Key>SQLSERVER:MSSQLSERVER:server3.company.com</Key> <Attributes> <Attribute name="hpom_citype" value="sqlserver" /> <Attribute name="hpom_discoTarget" value="BSM" /> <Attribute name="ucmdb_name" value="MSSQLSERVER" /> <Attribute name="ucmdb_database_dbsid" value="MSSQLSERVER" /> <Attribute name="ucmdb_discovered_product_name" value="mssqlserver" /> <Attribute name="ucmdb_data_externalid" value="server3.company.com/MSSQLSERVER" /> </Attributes> </NewInstance>
Make sure the relations type does not have the prefix omrel_
.
For example, the relation type "composition" should be set like:
<NewRelationship> <Parent> <Instance ref="HOST:server3.company.com"/> </Parent> <GenericRelations> <Relations type="composition"> <Instance ref="SQLSERVER:MSSQLSERVER:server3.company.com"/> </Relations> </GenericRelations> </NewRelationship>
Create a topology XML or Rest Web Service policy. For details on topology policies, see Configuring Topology Through the REST Web Service Listener and How to Collect Topology Data from XML Files.