Chapter 3: Using Integration Utility

Table Of Contents

Using Integration Utility

Starting Integration Utility

Starting Integration Utility on UNIX

Starting Integration Utility on Windows

Starting Integration Utility on NMS

Downloading Data Bundle

Integrating LMS Applications to NMS

Updating NMS

Troubleshooting Integration Utility

Using Integration Utility

---

CiscoWorks Integration Utility downloads Network Management Integration Data Bundle (NMIDB) and integrates LAN Management Solutions (LMS) applications, icons, MIBs, and traps with third-party Network Management Systems (NMS).

This chapter contains:

•Starting Integration Utility

•Downloading Data Bundle

•Integrating LMS Applications to NMS

•Updating NMS

•Troubleshooting Integration Utility

Starting Integration Utility

You must start Integration Utility to:

•Download and upgrade to a new NMIDB version available on Cisco.com.

•Change your LMS application server location.

•Register a new application.

•Change the NMS with which you want to integrate your LMS applications.

•Get a new vendor adapter script.

You must log in as root on UNIX or have administrator privileges on Windows to run Integration Utility.

This section contains:

•Starting Integration Utility on UNIX

•Starting Integration Utility on Windows

•Starting Integration Utility on NMS

Starting Integration Utility on UNIX

To start Integration Utility on UNIX:

---

Step 1 Open a connection to the system on which Integration utility is installed using Telnet.

Step 2 Log in as root.

Step 3 Navigate to the root_ installation_directory/bin directory.

If you plan to start the utility without using any options, set your Display environment variable.

Step 4 Enter the following (including any options from Table 3-1) on the command line:

./nmic.sh

Table 3-1 Command Line Options 

Command Line Option	Description
-h or -help	Displays the command line options and usage.
-v	Displays the Integration Utility version and the NMIDB version.
-q	Runs in quiet mode without showing the GUI screens. Uses the NMIDB that was installed earlier and runs the adapter script that was configured earlier.
-u	Removes the integration information from the Network Management System. The menu entries for Cisco applications are removed but the MIBs and icons are not deleted.
-q -cco	Gets the latest NMIDB from Cisco.com and runs the adapter script that was configured earlier.
-q -file	Installs the NMIDB in quiet mode using the NMIDB file. Enter the full directory path to the NMIDB file. For example: •On Windows, enter: -q -file C:\temp\nmidb.xxx where xxx is the NMIDB version. •On UNIX, enter: -q -file /tmp/nmidb.xxx where xxx is the NMIDB version.

Starting Integration Utility on Windows

From a Windows platform, you can start Integration Utility from either:

•Start menu

Or

•Command line

To start Integration Utility from the Start menu:

---

Step 1 Click Start on your Windows desktop.

Step 2 Select Programs > CiscoWorks > Change Integration Options.

---

To start Integration Utility from the command line:

---

Step 1 Navigate to the root_install_directory\bin directory.

Step 2 Enter the following (including any options from Table 3-1) on the command line:

nmic.exe

---

Starting Integration Utility on NMS

If Integration Utility is integrated with the NMS, select Change Integration Options from the appropriate top-level menu.

Downloading Data Bundle

A Network Management Integration Data Bundle (NMIDB) contains all the information required to add Cisco devices to a Network Management System (NMS).

The NMIDB version shipped with LAN Management Solution 3.0 is 1.085.

The bundle is updated frequently, and you must install the latest version to use your NMS with LMS applications.

When you upgrade device support, a new NMIDB is often downloaded. If Integration Utility detects a later version of the NMIDB, it prompts you to install it.

You can also manually retrieve the latest NMIDB from a file on your local machine, from Cisco.com, or from another system.

If Integration Utility has already been integrated into your NMS, you can download the data bundle from the Update Cisco Device Support menu.

Select Update Cisco Device Support from the appropriate top-level menu. The location of the menu depends on where CiscoView applications have been installed on your system. The new NMIDB is automatically retrieved and integrated into the NMS.

You must log in as root on UNIX or have administrator privileges on Windows to run Integration Utility.

To download the data bundle:

---

Step 1 Start Integration Utility.

The utility checks for a new (later version) NMIDB downloaded by the Software Center.

If it finds a later NMIDB, a dialog box appears, prompting you to update to the later version.

•Click Yes if you want to install the new NMIDB.

•Click No if you do not want to use the new NMIDB downloaded by the Software Center.

If you do not install the new NMIDB, you are prompted to install it each time you start Integration Utility until a later version is installed.

If a new NMIDB was not detected or you clicked No, select one of these options from Table 3-2.

Table 3-2 NMIDB Download Options 

Option	Purpose	Enter
File	Install the NMIDB from a file on your local machine.	•Enter the full directory path and the NMIDB file name. For example: –On Windows, enter: C:\temp\nmidb.xxx where xxx is the NMIDB version. –On UNIX, enter: /tmp/nmidb.xxx where xxx is the NMIDB version. Or •Click Browse to search for the NMIDB file.
Cisco.com	Install the NMIDB from Cisco.com.	Enter your Cisco.com username and password. You must have Cisco.com login privileges. If you do not have a user account and password on Cisco.com, contact your channel partner or enter a request on the web site (http://www.cisco.com).
FTP	Install the NMIDB from another system.	Enter the device login information: •System name •User name •User password •Full directory path and the NMIDB file name (for example, /tmp/nmidb.xxx).

Step 2 Click Get NMIDB.

The NMIDB is installed if it is a version later than the version of the NMIDB already installed on your system.

Step 3 Click Next.

If you made changes to any fields in this dialog box, you are prompted to confirm whether you want to get the NMIDB from the new location.

•Click Yes to install the new NMIDB.

The NMIDB is installed if it is a version later than the version of the NMIDB already installed on your system.

•Click No to cancel your changes.

The Application Registration dialog box appears. See Integrating LMS Applications to NMS for integration details.

---

Integrating LMS Applications to NMS

Use the Application Integration dialog box to select the applications you want to integrate into NMS. Integrating an application allows you to launch that application from an icon or menu in your NMS.

Before you register applications with the NMS, you must complete downloading the data bundle for this device.

If you do not download the data bundle, Integration utility uses the already installed NMIDB.

To integrate LMS applications to your NMS:

---

Step 1 Select an application tab.

There is one tab for each available application. If you are updating NMIDB for new device support only and do not need to make any application registration changes, skip the following steps and click Next.

To designate a default application that launches from the NMS, check the Set as default application to be launched from NMS.

Some Network Management System adapters do not support this option.

Step 2 Double-click the device icon on the NMS map after integration completes.

Step 3 Change the registration parameters as follows:

•To register web-based applications, enter or select:

–HTTP/HTTPS protocol.

–CiscoWorks web server hostname or IP address.

–CiscoWorks web server port number.

–Browser executable with the full path to launch the application.

•To register another application, select another application tab.

Step 4 Click Next after completing the registration process for all applications.

If you made any application registration updates, a confirmation dialog box prompts you to save or cancel your changes.

•Click Yes to save your changes.

•Click No to cancel your changes.

The Choose Adapters dialog box appears.

Step 5 Select an adapter from the list of Available adapters in the Choose Adapters dialog box.

The adapters that are available, by default, with Integration Utility are:

•CA-Unicenter

•HitachiNMMAdapter

•NetView60NTClientAdapter

•NetView60NTServerAdapter

•NetViewNTClientAdapter

•NetViewNTServerAdapter

•NNMAdapter

---

Note NNM Adapter is also known as HP OpenView Network Node Manager Adapter.

---

•SPECTRUMAdapter

•SystemWalkerAdapter

You can also get new adapters from a file or from a remote FTP server and add them to the list of existing adapters. See Updating NMS for more information.

Step 6 Click Integrate to integrate the LMS application with the selected NMS.

The integration may take some time. You should wait for the integration to complete successfully.

Figure 3-1, displays HPOV after integration with CiscoView.

Figure 3-1 HPOV After Integration With CiscoView

1	LMS Application (CiscoView)
2	Cisco Alarms-appearing after integration
3	HPOV Panner
4	Cisco Icon

---

Updating NMS

You can update or change the Network Management System (NMS) with which you integrate your LMS applications.

For example, you can upgrade from HP Network Node Manager 6.4 to 7.0 or you can use another NMS.

To preserve the integration with LMS applications, you must acquire a new adapter script. Adapter scripts integrate icons, MIBs, and applications from the NMIDB into the NMS.

Before you run the adapter script to integrate your LMS applications, make sure the NMS for that script is available.

To update your NMS:

---

Step 1 Select an adapter script from the Available Adapters list.

You can select an adapter script from the list of NMS adapters provided with the Integration Utility or use an adapter script provided by the NMS vendor.

When you select a script from the Available Adapters list, a description of that script appears in the Adapter Description dialog box.

To add an adapter script to the list:

a. Click Add...

The Get New Adapter dialog box appears.

b. Select one of these options from Table 3-3

Table 3-3 Options for Installing Adapter Script

Options	Purpose	Enter
File	Install the adapter script from a file on your local machine.	•Enter the full directory path and the adapter script file name. For example: –On Windows, enter: C:\temp\adapter.xxx where adapter is the name of the NMS adapter and xxx is the filename extension of the adapter. –On UNIX, enter: /tmp/adapter.xxx where adapter is the name of the NMS adapter and xxx is the filename extension of the adapter. Or •Click Browse to search for the adapter script file.
FTP	Install the adapter script from another system.	Enter the following device login information: •System name •User name •User password •Full directory path and the adapter script file name. For example, /tmp/adapter.xxx where adapter is the name of the NMS adapter and xxx is the filename extension of the adapter.

c. Navigate to the directory that contains the new adapter script and select the file.

d. Click OK.

The script is added to the Available Adapters list.

Step 2 Click Integrate to run the selected script.

The adapter script integrates the icons, MIBs, and applications into the NMS.

---

Troubleshooting Integration Utility

Use the suggestions in the Troubleshooting Suggestions Table 3-4 to resolve errors or other problems you encounter while using Integration Utility.

Table 3-4 Troubleshooting Suggestions 

Symptom	Probable Cause	Possible Solutions
Invoking NMIC displays error messages while extracting NMIDB.	After integration, when you run Change Integration Options, your system extracts NMIDB. If there is not enough disk space to extract NMIDB, the extraction fails.	Free up some disk space and re-launch Change Integration Options. •On Windows, make sure you have at least 190 MB of free disk space. •For other file and operating systems, make sure you have at least 25 MB of free disk space.
Cannot display specific Cisco device icons with adapter 1.7 for HP Network Node Manager.	This happens when the NMIDB used for integration does not have the specific device icon information.	You can extract the latest NMIDB from Cisco.com using the Change Integration Utility GUI and perform the integration.
After Integration, traps are not properly integrated.	This happens when the appropriate NMS Adapter is not being used.	Download the latest adapter version from Cisco.com for the specific NMS.