Creating a Discovery Library book

To create a Discovery Library book, run the Discovery Library Adapter (DLA) with the appropriate DLA properties file.

Before you begin

Before you can run the DLA, the DLA properties file must have been configured correctly.

About this task

The DLA has two modes of operation:
Primary mode
Generates Discovery Library books by querying the Network Connectivity and Inventory Model (NCIM) database for the domain identified in the specified configuration file.
Import mode
Provides a means of importing IBM Tivoli Application Dependency Discovery Manager GUIDs back into the NCIM database, so that the TADDM UI can be opened from Network Manager.

Procedure

  1. Change to the DLA installation directory on the Network Manager GUI components server; the default is $NCHOME/precision/adapters/ncp_dla.
  2. Run the Discovery Library Adapter (DLA) and reference the appropriate DLA properties file for your domain to create a Discovery Library book: 
    ./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.
    See Example for an example of running the command and the system response.

Example

The following example shows how to run the DLA, and the system response:

[root@abc.test]# ./ncp_dla.sh ncp_dla.properties.NCOMS
ncp_DLA ( IBM Tivoli Network Manager IP Edition - Discovery Library Adapter )
Copyright (C) 1997 - 2013 By IBM Corporation.  All Rights Reserved.
See product license for details.

[IDML Generation Mode]
Initializing...
WARNING: user.install.root not defined, using /opt/IBM/netcool/core/precision/profiles/TIPProfile
Loading properties from /opt/IBM/netcool/core/precision/profiles/TIPProfile/etc/tnm/tnm.properties
FINE: database.type = db2
FINE: database.dbname = ITNM
FINE: database.jdbc.url = null
FINE: database.host = abc.test.ibm.com
FINE: database.port = 50000
FINE: database.username = ncim
FINE: database.connection.defaultFetchSize = null
FINE: database.connection.propertiesFile = null
FINE: Getting encrypted password
Jun 3, 2013 9:15:09 AM DbConnectionPool getJdbcURL
FINE: JDBC URL = jdbc:db2://abc.test.ibm.com:50000/ITNM
INFO: HNMXB0006I=JDBC Driver: com.ibm.db2.jcc.Db2Driver
INFO: HNMXB0007I=JDBC URL   : jdbc:db2://abc.test.ibm.com:50000/ITNM
INFO: HNMXB0007I=JDBC URL   : jdbc:db2://abc.test.ibm.com:50000/ITNM
Jun 3, 2013 9:15:10 AM DbConnectionPool getConnection
FINEST:  Connection Pool READ has size 0
Working on ITNM domain 'NCOMS'...
Processing 142 ComputerSystem(s)...
% Complete: 0...10...20...30...40...50...60...70...80...90...100
Writing IDML Book to '/tmp/dla/ITNMIP39.9.42.16.62.2013-06-03T13.15.11.579Z.refresh.xml'...
Shutting down...
Finished.