How to Run NNMi–UCMDB Integration

This task includes the steps to run the NNMi-UCMDB integration jobs.

This task includes the following steps:

1. Run NNMi Integration

   In the Integration Studio, create a new integration point.

   1. Provide a name and description for the integration point.

   2. Under Integration Properties > Adapter, select the appropriate adapter:

   • Pull Topology from NNMi: Use this adapter to run population jobs.

     This job connects to the NNMi Web service and retrieves NNMi discovered nodes, IP addresses, networks, interfaces, physical ports, VLANs, hardware boards, Layer 2 connection information to create a Layer 2 topology in UCMDB.

   • Pull Topology from NNMi by REST API: Use this adapter to run population jobs by REST API.

     This job is needed when you can only discover switches and Layer2 connection to servers in NNMi, and the servers are discovered in Universal Discovery. This adapter can populate Layer2 connection from NNMi to Universal Discovery.

     To use this job, follow these steps:

     1. Run the Pull Topology from NNMi job to populate switches from NNMi to Universal Discovery.
     2. Run the Pull Topology from NNMi by REST API job to query server and switch interfaces from Universal Discovery and then pass them to NNMi, and query Layer2 connection and then send it back to Universal Discovery.

   • NNMI Update IDs: Use this adapter to run push jobs. This job:

     • Retrieves the UCMDB IDs of the NNMi hosts and NNMi interfaces from the UCMDB Server using the UCMDB Web Services API.

     • Updates the ODB_ID and UCMDB_ID custom attributes on the corresponding Node and Interface CIs on the NNMi server using the NNMi Web service.

   3. Under Adapter Properties > Data Flow Probe, select the Data Flow Probe.

   4. Under Adapter Properties > Trigger CI instance select:

   • Select Existing CI (if you have a valid, existing CI). The Select Existing CI pane appears. Select the CI; or
   • Create New CI (if you need to create a new CI). The Topology CI Creation Wizard appears. Complete the creation of the CI using the Wizard.

   Note For details on the Topology CI Creation Wizard, see "Topology CI Creation Wizard" in the Data Flow Management section of the UCMDB Help.

   5. Under Adapter Properties > Credentials ID select the appropriate credentials for connection to the NNMi server.

   6. Save the Integration Point.

   7. Run the job.

   Note For details on running an integration job, see "Integration Studio" in the Data Flow Management section of the UCMDB Help.

2. Validate results

   Verify that data was discovered using the NNMi integration jobs.

   1. For the Pull Topology from NNMi and Pull Topology from NNMi by REST API jobs:

      • In UCMDB, navigate to Managers > Modeling > IT Universe Manager.

      • In the CI Selector pane, select Browse Views.

      • On the View drop-down menu, select Layer 2 by NNMi. Select a view. The view displays the CIs and relationships discovered by the integration job.

   2. For the NNMI Update IDs job:

      • In NNMi, open an NNMi Node or Interface that was discovered in UCMDB.

      • On the Custom Attributes tab, look for the ODB_ID and UCMDB_ID custom attributes. These attributes contain the UCMDB ID of the corresponding host or interface in UCMDB.