For complex topologies, you need to create a topology synchronization package that contains mapping rules that map data in to RTSM CIs and relationships.
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.
Create the sync package:
In a temporary location, create a directory with a name that matches the synchronization package name (for example, /temp/mysyncpkg
).
Create the package descriptor file and save it in the synchronization package directory (for example, /temp/mysyncpkg/package.xml
).
For details on the package descriptor file, see Package Descriptor File: package.xml.
Configure the context mapping file to tag which elements included in discovered data you want to include in the topology synchronization for mapping. The mapping rules contained in the XML mapping files are applied to the tagged elements.
Save the context mapping file in the synchronization package directory (for example, /temp/mysyncpkg/contextmapping.xml
).
For details on the context mapping file, see Context Mapping (Filtering): contextmapping.xml.
Configure the type mapping file to define the mapping between the discovered CIs to the type of a CI in the RTSM.
Save the type mapping file in the synchronization package directory (for example, /temp/mysyncpkg/typemapping.xml
).
For details on the type mapping file, see Type Mapping File: typemapping.xml.
Configure the attribute mapping file to map the attributes of a discovered CI to the attributes of a CI in the RTSM.
Save the attribute mapping file in the synchronization package directory (for example, /temp/mysyncpkg/attributemapping.xml
).
For details on the attribute mapping file, see Attribute Mapping File: attributemapping.xml.
Configure the relation mapping file to define the CI relationships created in the RTSM between specified discovered CIs.
Save the relation mapping file in the synchronization package directory (for example, /temp/mysyncpkg/relationmapping.xml
).
For details on the relation mapping file, see Relation Mapping File: relationmapping.xml.
Optional: Use the supplied XML schema definitions to validate the correctness of the XML mapping files. The definitions are located theOMi server:
%topaz_home%/conf/opr/topology-sync/schemas
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.