Creating a Discovery Library book for network edge data

Edit online

You can use the Discovery Library Adapter (DLA) to create the Discovery Library book containing only the data for your network edge entities.

Before you begin

Make sure you have edited the ncp_dla.properties file for the domain to include the name of the filtered network view containing the network edge entities.

About this task

To create a DLA book containing network edge data:

Procedure

Change to the DLA installation directory on the Network Manager GUI components server; the default is $NCHOME/precision/adapters/ncp_dla.
Run the Discovery Library Adapter (DLA) to generate the book XML file with data on the tagged network edge entities:
```
./ncp_dla.sh ncp_dla.properties.domain_name [ -genmore ]
```
Note: The -genmore flag is optional. It generates all entities including stacked switches for ComputerSystem CDM filters.
For example, to run the adaptor for the domain called NCOMS, enter the following: ./ncp_dla.sh ncp_dla.properties.NCOMS

Example

The following example shows the system response for running the adaptor for the NCOMS domain:

ncp_DLA ( IBM Tivoli Network Manager IP Edition - Discovery Library Adapter )
Copyright (C) 1997 - 2011 By IBM Corporation.  All Rights Reserved.  See product license for details.

[IDML Generation Mode]
Initializing...
Will use the following Network View(s) filter : ='FILTER'
Working on ITNM domain 'NCOMS'...
Processing 1148 IP Network(s)...
% Complete: 0...10...20...30...40...50...60...70...80...90...100
Processing 772 ComputerSystem(s)...
% Complete: 0...10...20...30...40...50...60...70...80...90...100
Processing 1 Topology(s)...
Processing 2535 Connection(s)...
% Complete: 0...10...20...30...40...50...60...70...80...90...100
Writing IDML Book to '/opt/netcool/itnm39017/netcool/var/precision/ccmdb/ITNMIP39.9.180.209.195.2010-10-05T13.33.37.314Z.refresh.xml'...
Shutting down...
Finished.

The result is an XML file that contains the devices participating in the filtered network view previously created and specified in the ncp_dla.properties file for the domain. The content of the XML file depends on the configuration of the DLA properties file.

The XML file contains Common Data Model (CDM) Segments that describe how devices are connected from the perspective of a given Network Manager port or interface. The process removes duplicates and normalizes connection details. For more information on Segments, please refer to the Tivoli® Common Data Model (CDM) documentation available at http://www.redbooks.ibm.com/abstracts/redp4389.html.

The following examples show parts of the XML file output. The interface chosen to be the segment identity is highlighted in bold, including each instance it is referenced.

Example of a point-to-multipoint connection from the perspective of the interface chosen to be the starting point for a segment:

<cdm:net.Segment id="SegmentVia_359525_L2Interface" >
                <cdm:Name>Layer 2 Segment via 359525_L2Interface</cdm:Name>
                <cdm:ManagedSystemName>itnmSgmnt:359525_L2Interface</cdm:ManagedSystemName>
 </cdm:net.Segment>
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="359525_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="358156_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="404607_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="358221_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="358185_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="404595_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="358107_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="357775_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="358232_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="404589_L2Interface" />
            <cdm:networks source="SegmentVia_359525_L2Interface"  target="358300_L2Interface" />

Example of a simple point-to-point connection:

<cdm:net.Segment id="SegmentVia_355664_L2Interface" >
                <cdm:Name>Layer 2 Segment via 355664_L2Interface</cdm:Name>
                <cdm:ManagedSystemName>itnmSgmnt:355664_L2Interface</cdm:ManagedSystemName>
</cdm:net.Segment>
            <cdm:networks source="SegmentVia_355664_L2Interface"  target="355664_L2Interface" />
            <cdm:networks source="SegmentVia_355664_L2Interface"  target="357336_L2Interface" />