User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration...

30
Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883 User Guide for Cisco Prime Integration Utility Software Release 1.11 Cisco Prime Text Part Number: OL-26453-01

Transcript of User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration...

Page 1: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706 USAhttp://www.cisco.comTel: 408 526-4000

800 553-NETS (6387)Fax: 408 527-0883

User Guide for Cisco Prime Integration UtilitySoftware Release 1.11Cisco Prime

Text Part Number: OL-26453-01

Page 2: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

CCVP, the Cisco logo, and the Cisco Square Bridge logo are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys, MeetingPlace, MGX, Networking Academy, Network Registrar, Packet, PIX, ProConnect, ScriptShare, SMARTnet, StackWise, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

User Guide for Cisco Prime Integration Utility 1.11Copyright © 2012, Cisco Systems, Inc. All rights reserved.

Page 3: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

OL-26453-01

C O N T E N T S

Preface iii

Audience iii

Conventions iii

Product Documentation iv

Related Documentation iv

Obtaining Documentation, Obtaining Support, and Security Guidelines v

C H A P T E R 1 Overview of Integration Utility 1-1

Product Overview 1-1

Integrating Cisco Prime Applications With Third Party Platforms 1-1

NMS and Cisco Prime on Same Machine 1-2

NMS and Cisco Prime on Different Machines 1-2

C H A P T E R 2 Installing Integration Utility 2-1

Software Requirements 2-1

Hardware Requirements 2-1

Supported Network Management Systems 2-2

Installing Integration Utility 2-3

Uninstalling Integration Utility 2-4

C H A P T E R 3 Using Integration Utility 3-1

Starting Integration Utility 3-1

Starting Integration Utility on UNIX 3-2

Starting Integration Utility on Windows 3-2

Starting Integration Utility on NMS 3-3

Downloading Data Bundle 3-3

Integrating Cisco Prime Applications to NMS 3-5

Updating NMS 3-8

Troubleshooting Integration Utility 3-9

I N D E X

iUser Guide for Cisco Prime Integration Utility 1.11

Page 4: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Contents

iiUser Guide for Cisco Prime Integration Utility 1.11

OL-26453-01

Page 5: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Preface

This document describes the Cisco Prime Integration Utility and provides instructions for installing, integrating, and using Integration Utility.

AudienceThis manual is for network administrators who need to configure and maintain Cisco Prime applications and integrate third party Network Management Systems with the Cisco Prime applications.

Network administrators should have the following skills:

• Basic network management skills

• Basic Solaris system administrator skills

• Basic Windows system administrator skills

ConventionsThis document uses the following conventions:

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the publication.

Item Convention

Commands and keywords boldface font

Variables for which you supply values italic font

Displayed session and system information screen font

Information you enter boldface screen font

Variables you enter italic screen font

Menu items and button names boldface font

Selecting a menu item in paragraphs Option > Network Preferences

Selecting a menu item in tables Option > Network Preferences

iiiUser Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 6: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Preface

Caution Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Warning This symbol means danger. You are in a situation that could cause bodily injury.

Product Documentation

Note We sometimes update the printed and electronic documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates.

Table 1 describes the product documentation that is available.

Related Documentation

Note We sometimes update the printed and electronic documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates.

Table 2 describes the additional documentation that is available.

Table 1 Product Documentation

Document Title Available Formats

User Guide for Cisco Prime Integration Utility 1.11 (this document))

• PDF on the LMS Documentation CD-ROM.

• On Cisco.com at:http://www.cisco.com/en/US/products/ps11200/products_user_guide_list.html

Context-sensitive online help Click Help from the page you are on for context-sensitive help.

Table 2 Related Documentation

Document Title Available Formats

Release Notes for Cisco Prime LAN Management Solution 4.2

• PDF on the LMS Documentation CD-ROM.

• On Cisco.com at:http://www.cisco.com/en/US/products/ps11200/prod_release_notes_list.html

Getting Started with Cisco Prime LAN Management 4.2

• PDF on the LMS Documentation CD-ROM.

• On Cisco.com at:http://www.cisco.com/en/US/products/ps11200/products_user_guide_list.html

ivUser Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 7: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Preface

Obtaining Documentation, Obtaining Support, and Security Guidelines

For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Installing and Migrating to Cisco Prime LAN Management Solution 4.2

• Printed document that was included with the product.

• PDF on the LMS Documentation CD-ROM.

• On Cisco.com:http://www.cisco.com/en/US/products/ps11200/prod_installation_guides_list.html

Table 2 Related Documentation (continued)

Document Title Available Formats

vUser Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 8: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Preface

viUser Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 9: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

OL-26453-01

C H A P T E R 1

Overview of Integration Utility

Cisco Prime Integration Utility is a utility that integrates Cisco Prime applications with third party Network Management Systems (NMS).

This utility adds Cisco device icons to topology maps, allows Cisco MIB browsing from NMS, and sets up menu items on the NMS to launch remotely installed Cisco Prime applications, such as CiscoView and Device Center.

This chapter contains:

• Product Overview

• Integrating Cisco Prime Applications With Third Party Platforms

Product OverviewIntegration Utility allows you to easily integrate the Cisco devices and Cisco Prime applications into NMS.

The features of Integration Utility are:

• Common installation mechanism for Network Management Integration Data Bundle (NMIDB) into NMS.

• Ability to integrate Cisco Prime applications, icons, MIBs, and traps to third party NMS.

• Support for new NMS without any change in the application.

• Support for new devices from NMS to launch Cisco Prime applications.

Integrating Cisco Prime Applications With Third Party PlatformsYou can integrate Cisco Prime applications, icons, MIBs, and traps with third party SNMP management platforms. Depending on the specific platform, Integration Utility allows you to:

• Launch Cisco Prime applications.

• Browse Cisco MIBs.

• Integrate traps.

• Add Cisco device icons to NMS topology maps.

This utility also allows remote integration between Cisco Prime applications residing on one server and an SNMP management platform residing on another server.

1-1User Guide for Cisco Prime Integration Utilty 1.11

Page 10: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 1 Overview of Integration Utility Integrating Cisco Prime Applications With Third Party Platforms

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

Integration Utility performs the following tasks:

• Downloads the NMIDB from Cisco.com, from a local file, or through FTP from another system.

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

• Prompts for additional configuration information to register each application.

• Gets the adapter script from a local file or through FTP from another system.

• Runs the adapter script to integrate the applications, icons, MIBs, and traps into the NMS.

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

You must install Integration Utility on the same machine on which the target NMS is installed. The two integration scenarios are:

• NMS and Cisco Prime on Same Machine, page 1-2

• NMS and Cisco Prime on Different Machines, page 1-2

NMS and Cisco Prime on Same MachineIn this case, Integration Utility runs as part of a single CiscoView install. Since Integration Utility can get all the information it needs from the Cisco Prime Server, it integrates the applications, device icons, MIBs, and traps into the NMS automatically.

Integration Utility is installed even if the NMS is not present. Later, when the NMS is installed, select Change Integration Options to integrate applications or device information into the NMS.

When you add device support from Cisco.com, you automatically receive a new NMIDB. If necessary, you can download and integrate this NMIDB into your NMS.

NMS and Cisco Prime on Different MachinesIf you install NMS and Integration Utility on one machine and Cisco Prime on another, Integration Utility guides you to integrate the Cisco Prime applications and device information into the SNMP management platform. During this process, Integration Utility prompts you to enter any necessary information.

You can launch the Change Integration Options to display application-specific information installed on a remote system and proceed with the integration. This integrates the Cisco Prime application residing on a remote system with the NMS.

You can download a new NMIDB from the NMS, if required. If an NMIDB is already integrated with the NMS, select Update Cisco Device Support from the NMS menu to download the new NMIDB.

If you entered the correct Cisco.com user name and password (while installing Integration Utility or when using Change Integration Options), the utility automatically retrieves and integrates the NMIDB into your NMS.

1-2User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 11: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

OL-26453-01

C H A P T E R 2

Installing Integration Utility

This chapter describes the tasks you must perform to install and uninstall Cisco Prime Integration Utility.

This chapter contains:

• Software Requirements

• Hardware Requirements

• Supported Network Management Systems

• Installing Integration Utility

• Uninstalling Integration Utility

Software RequirementsYou must run one of these operating systems:

On Unix:

• Solaris 10

On Windows:

• Windows 2008 Standard Edition Release 1 with SP1 and SP2

• Windows 2008 Enterprise Edition Release 1 with SP1 and SP2

• Windows Server 2008 R2 Standard Edition

• Windows Server 2008 R2 Enterprise Edition with SP1

Note Only 64-bit Operating Systems are supported on the above versions of Windows operating system.

Hardware Requirements• Memory (RAM): Minimum of 4 GB memory and 8 GB swap is required. If the swap is less than 8

GB, the installation aborts.

• Space required: 4096MB (This includes the space required to extract the NMIDB package)

2-1User Guide for Cisco Prime Integration Utilty 1.11

Page 12: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 2 Installing Integration Utility Supported Network Management Systems

Supported Network Management SystemsTable 2-1 lists the Network Management Systems (NMS) supported by Integration Utility 1.11.

Table 2-1 Supported Network Management Systems

Network Management System Supported Platforms

HP Open View 9.1, 9.01, 9.0, 8.13, 8.1

Windows

• Windows 2008 R2 Standard x 64 Edition

• Windows 2008 Server Standard Edition Release 1 with SP1 and SP2

• Windows 2008 Enterprise Edition Release 1 with SP1 and SP2

• Windows Server 2008 R2 Standard Edition

• Windows Server 2008 R2 Enterprise Edition

Note Only 64-bit Operating Systems are supported on the above versions.

Solaris

• Solaris 10

Both local and remote integration are supported for these platforms.

Soft Appliance

Note Only remote integration is supported for Soft Appliance.

For information on integrating HP OpenView- LMS, see NNMi Deployment Guide on the HP site.

HP OpenView 7.53, 7.51, 7.50 Windows:

• Windows 2008 Server Standard Edition Release 1 with SP1 and SP2

• Windows 2008 Enterprise Edition Release 1 with SP1 and SP2

• Windows Server 2008 R2 Standard Edition

• Windows Server 2008 R2 Enterprise Edition

Note Only 64-bit Operating Systems are supported on the above versions.

Solaris:

• Solaris 10

Only remote integration is supported for the above platforms.

2-2User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 13: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 2 Installing Integration Utility Installing Integration Utility

Installing Integration UtilityThe Cisco Prime Integration Utility 1.11 is part of the LMS 4.2 product DVD. You can install Integration Utility 1.11 as a standlone product on your system. Run the setup.exe file from SystemDrive:\disk1\install\NMIM\setup.exe.

Installation Notes

Before you begin installing Integration Utility, ensure that you:

• Have administrator privileges to install the product.

• Install the Integration Utility on the same machine as your third-party NMS.

Installation Instructions

You can install the Integration Utility using Custom mode of installation.

For more information on Integration Utility installation, see Installing and Migrating to Cisco Prime LAN Management Solution 4.2.

User Inputs During Installation

At the end of Custom installation of Integration Utility, you are prompted to integrate the utility with the NMS.

You can select either:

• Integrate Now

Or

• Integrate Later

You are prompted to enter the following information if you choose the Integrate Now option:

• NM adapter to use for integration.

• Cisco Prime Server details to reach CiscoView from NMS map (standalone only)

– Cisco Prime Server name

– Port

NetView 7.1.4, 7.1.5 Windows:

• Windows 2008 Server Standard Edition Release 1 with SP1 and SP2

• Windows 2008 Enterprise Edition Release 1 with SP1 and SP2

• Windows Server 2008 R2 Standard Edition

• Windows Server 2008 R2 Enterprise Edition

Note Only 64-bit Operating Systems are supported on the above platforms.

Only remote integration is supported for the above platforms.

Table 2-1 Supported Network Management Systems (continued)

Network Management System Supported Platforms

2-3User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 14: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 2 Installing Integration Utility Uninstalling Integration Utility

– Protocol (HTTP or HTTPS)

• Option to get NMIDB updates from Cisco.com (Yes or No)

• Cisco.com login and password for updating NMIDB (Optional)

• Default browser path to launch Cisco Prime Applications

See Integrating Cisco Prime Applications to NMS to know more about these fields.

If you select the Integrate Later option, you must enter these information when you start to integrate the Cisco Prime applications with the third party Network Management Systems.

Uninstalling Integration UtilityYou can uninstall Integration Utility along with other Cisco Prime applications.

For more information on uninstallation, see Installing and Migrating to Cisco Prime LAN Management Solution 4.2.

2-4User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 15: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

OL-26453-01

C H A P T E R 3

Using Integration Utility

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

This chapter contains:

• Starting Integration Utility

• Downloading Data Bundle

• Integrating Cisco Prime Applications to NMS

• Updating NMS

• Troubleshooting Integration Utility

Starting Integration UtilityYou must start Integration Utility to:

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

• Change your Cisco Prime application server location.

• Register a new application.

• Change the NMS with which you want to integrate your Cisco Prime 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

3-1User Guide for Cisco Prime Integration Utilty 1.11

Page 16: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Starting Integration Utility

Starting Integration Utility on UNIXTo 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

Starting Integration Utility on WindowsFrom a Windows platform, you can start Integration Utility from either:

• Start menu

Or

• Command line

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.

3-2User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 17: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Downloading Data Bundle

To start Integration Utility from the Start menu:

Step 1 Click Start on your Windows desktop.

Step 2 Select Programs > Cisco Prime > 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 NMSIf Integration Utility is integrated with the NMS, select Change Integration Options from the appropriate top-level menu.

Downloading Data BundleA 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 Cisco Prime 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.

3-3User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 18: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Downloading Data Bundle

• 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.

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.

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).

3-4User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 19: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Integrating Cisco Prime Applications to NMS

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

Integrating Cisco Prime Applications to NMSUse 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 Cisco Prime 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.

– Cisco Prime web server hostname or IP address.

– Cisco Prime 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

3-5User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 20: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Integrating Cisco Prime Applications to NMS

• 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 Cisco Prime 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.

3-6User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 21: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Integrating Cisco Prime Applications to NMS

Figure 3-1 HPOV After Integration With CiscoView

1 Cisco Prime Application (CiscoView)

2 Cisco Alarms-appearing after integration

3 HPOV Panner

4 Cisco Icon

3-7User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 22: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Integrating Cisco Prime Applications to NMS

Enabling HP NNMi-Cisco Prime LMS IntegrationConfigure the integration between NNMi and Cisco Prime LMS by following these steps.

Step 1 Open the HP NNMi-CiscoWorks LMS Integration Configuration menu from the Workflow Integration Module Configuration -> CiscoWorks LMS.

Step 2 Select the "Enable Integration" check box to activate the remaining fields.

3-8User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 23: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Integrating Cisco Prime Applications to NMS

Step 3 Enter the information about the NNMI management server & LMS Integration server.

3-9User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 24: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Integrating Cisco Prime Applications to NMS

Note Note: If anyone of the server or both the server configured as SSL, then Enable the "NNMi SSL Enabled" check box and provide the SSL port.

Step 4 Click submit to make the successful integration. It will display the following status message.

Note Note: After successful integration, if you can't see the LMS cross launch link (Device Center, Cisco View) under the "Action" tab in NNMI, relogin to make the changes (integration) effect.

Cross Launching Cisco Prime from NNMIIntegration provides the link from the NNMI console to Cisco Prime LMS. This integration adds the following links to the NNMI console.

CiscoWorks Device Center - Opens the CiscoWorks Device Center for the selected node.

CiscoWorks CiscoView - Opens CiscoWorks CiscoView for the selected node.

3-10User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 25: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Integrating Cisco Prime Applications to NMS

View Node in NNM To view a particular node in NNM, refer to the following steps:

Step 1 Open NNM, select a particular node and go to CiscoWorks CiscoView or CiscoWorks Device center.

Step 2 Enter the Credentials in the login page of the integrated LMS server to view the reports for the selected node.

Note Integration does not provide single sign on between the products. You must enter your CiscoWorks LMS user credentials to view the CiscoWorks LMS pages.

Removing NNMITo remove NNMi from a local system, follow these steps:

3-11User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 26: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Updating NMS

Step 1 Log on with administrator privileges to the system where you plan to remove NNMi.

Step 2 To begin uninstalling NNMi in Windows, do one of the following:

At a command prompt, enter the following command:

%NnmInstallDir%\Uninstall\NNM\setup.exe

As an alternative to running the setup.exe command, you can use the

Start > Programs > HP > Network Node Manager > Uninstall NNM menu item.

Step 3 To begin uninstalling NNMI in Sol, enter the following command:

/opt/OV/Uninstall/NNM/setup.bin

Note Note: To remove the NNMI 7.53 or lower in Sol, enter the following command: /opt/OV/bin/remove.nnm

Updating NMSYou can update or change the Network Management System (NMS) with which you integrate your Cisco Prime 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 Cisco Prime 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 Cisco Prime 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

3-12User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 27: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Troubleshooting Integration Utility

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 UtilityUse the suggestions in the Troubleshooting Suggestions Table 3-4 to resolve errors or other problems you encounter while using Integration Utility.

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.xxxwhere adapter is the name of the NMS adapter and xxx is the filename extension of the adapter.

– On UNIX, enter:

/tmp/adapter.xxxwhere 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.

3-13User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 28: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Chapter 3 Using Integration Utility Troubleshooting 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.

3-14User Guide for Cisco Prime Integration Utilty 1.11

OL-26453-01

Page 29: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

OL-25953-01

I N D E X

A

audience for this document 1-iii

C

cautions

significance of 1-iv

Cisco Prime applications

integrating to NMS 3-5

integrating with third party NMS

NMS and Cisco Prime on different machines 1-2

NMS and Cisco Prime on same machine 1-2

D

documentation 1-iv

additional online 1-v

audience for this 1-iii

related to this product 1-v

typographical conventions in 1-iii

downloading Data Bundle 3-3

downloading NMIDB 3-3

H

help

online documentation 1-v

Customer Order Number:

I

installing Integration Utility 2-1

hardware requirements 2-1

software requirements 2-1

user inputs during installation 2-4

Integration Utility

command line options 2-2, 3-2

overview 1-1

starting on UNIX 3-2

starting on Windows 3-2

troubleshooting 3-9

N

Network Management Integration Data Bundle (see NMIDB) 3-3

NMIDB

downloading 3-3

NMS

upgrading 3-8

S

Supported NMS 2-2

T

typographical conventions in this document 1-iii

IN-1User Guide for Cisco Prime Integration Utility 1.11

Page 30: User Guide for Cisco Prime Integration Utility€¦ · i User Guide for Cisco Prime Integration Utility 1.11 OL-26453-01 CONTENTS Preface iii Audience iii Conventions iii Product

Index

U

UNIX

starting Integration Utility 3-2

updating NMS version 3-8

W

warnings, significance of 1-iv

Windows

starting Integration Utlity 3-2

IN-2User Guide for Cisco Prime Integration Utility 1.11

OL-25953-01