User Guide for CiscoWorks Integration Utility 1.6
Chapter 2: Installing Integration Utility

Table Of Contents

Installing Integration Utility

Software Requirements

Hardware Requirements

Supported Network Management Systems

Installing Integration Utility

Installing Along With CiscoWorks Common Services 3.0

Installing as a Standalone Application

Installing Integration Utility on UNIX

Installing Integration Utility on Windows

Installing Integration Utility in Typical Mode

Installing Integration Utility in Custom Mode

Uninstalling Integration Utility

Uninstalling With CiscoWorks Common Services 3.0

Uninstalling Standalone Integration Utility

Uninstalling Standalone Integration Utility on UNIX

Uninstalling Standalone Integration Utility on Windows


Installing Integration Utility


This chapter describes the tasks you must perform for installing and uninstalling CiscoWorks Integration Utility.

This chapter contains:

Software Requirements

Hardware Requirements

Supported Network Management Systems

Installing Integration Utility

Uninstalling Integration Utility

Software Requirements

You must run one of these operating systems:

On Unix:

Solaris 2.8 and 2.9

HP-UX 11.0

AIX 5.1

On Windows:

Windows 2000 Professional with SP3 or SP4.

Windows 2000 Server with SP3 or SP4.

Windows 2000 Advanced Server with SP3 and SP4.

Windows 2003 Server Standard Edition.

Windows 2003 Server Enterprise Edition.

Hardware Requirements

Memory (RAM): 256 MB

Space required: 300 MB (this includes the space required to extract the NMIDB package)

Supported Network Management Systems

Integration Utility 1.6 supports the following Network Management Systems (NMS) for integrating CiscoWorks applications with them.

HP Network Node Manager 6.4.

HP Network Node Manager 7.0.

HP Network Node Manager 7.0.1.

NetView 7.1.

Installing Integration Utility

You can install Integration Utility as part of CiscoWorks Common Services installation or as a standalone product on your system.

This section contains:

Installing Along With CiscoWorks Common Services 3.0

Installing as a Standalone Application

Installing Along With CiscoWorks Common Services 3.0

The CiscoWorks Integration Utility 1.6 is part of the CD-ROM that contains CiscoWorks Common Services 3.0 and CiscoView 6.1.You can choose to install Integration Utility 1.6 when you install CiscoWorks Common Services 3.0.


Note If you want to use Network Node Manager (NNM) with dynamic view, we recommend you install Common Services 3.0 on a separate server. Internet Information Services (IIS) is needed to access dynamic view or extended topology on Network Node Manager. However, IIS should be disabled or uninstalled for CiscoWorks to work properly. In such scenarios, we recommend you install Common Services 3.0 on a separate machine and Integration Utility as a standalone application on the machine where NNM is installed. This is applicable only on Windows. See Installing Integration Utility on Windows for more details.


For more information on CiscoWorks Common Services 3.0 installation, see the following Installation Guides:

Installation and Setup Guide for CiscoWorks Common Services 3.0 on Solaris

Installation and Setup Guide for CiscoWorks Common Services 3.0 on Windows

Installing as a Standalone Application

You can install Integration Utility as a standalone application on your system. You must download the Integration Utility from Cisco.com at http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-utility.

This section contains:

Installing Integration Utility on UNIX

Installing Integration Utility on Windows

Installing Integration Utility on UNIX

This section describes the tasks you must perform to install Integration Utility on a UNIX platform.

To install Integration Utility on UNIX:


Step 1 Download the Integration Utility image, IntgUtil.v1-6.os.tar file, where os is the code for your operating system (for example, sol for Solaris) into a target directory.

The target directory should have 300 MB of free space.

Step 2 Untar the downloaded file (IntgUtil.v1-6.sol.tar) in the target directory by entering:

# tar -xvf IntgUtil.v1-6.sol.tar

A setup.sh is created in the target directory.

Step 3 In the target directory, enter:

# ./setup.sh

A message appears:

Enter the location where the product will be installed or q to quit. 
Default location (PKGROOT)? [/opt/CSCOpx]

Step 4 Press Enter to accept the default directory for installation, or enter a different directory.

The installation program performs system checks and lists dependencies. The following message appears:

The Integration Utility will be installed now. The Integration Utility 
integrates Cisco device packages and Cisco applications into 
third-party SNMP management platforms. You can choose to integrate 
with a third-party SNMP management platform during install or later.
Do You want to integrate with the third-party product now (y/n)? [n]

Step 5 Select one of the following:

NTo not integrate during installation. You must run the utility later to integrate.

YTo integrate now. Go to Step 6.

Step 6 Select the adapter file for your target NMS from the files listed.

OtherTo specify an adapter file for a different NMS.

Or

NoneTo choose an NMS adapter file later.You must run the utility later.

If you select Other, the Adapter Selection screen appears.

Enter the full pathname of the adapter file.

If you have Cisco.com access, you can download adapters from the location http://www.cisco.com/kobayashi/sw-center/cw2000/cmc3rd.shtml.

For an HP-UX or AIX platform, as Application Integration is not supported in these platforms, go to Step 9.

Step 7 Enter the remote server name, port number and protocol (http/https) where CiscoWorks is installed.

If you do not enter this optional information, CiscoWorks application will not be integrated with the NMS. Go to Step 9.

Step 8 Enter the HTTP browser location, or press Enter to accept the default location, /opt/netscape/netscape.

Step 9 Select either:

N—Not to enter Cisco.com information now. You can enter it later when you want to upgrade.

YTo enter your Cisco.com user ID and password now for future upgrades.

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 Cisco.com.

If errors occur during installation, check the files /var/tmp/ciscoinstall.log and /tmp/nmimintegration.log.


Installing Integration Utility on Windows

This section describes the tasks you must perform to install Integration Utility on a Windows platform.

Installation Notes

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

Install CiscoWorks Common Services on a remote server.

You must have admin privileges to install Integration Utility.

User inputs during Installation

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

Default browser path to launch Cisco Applications

CiscoWorks Server name and port to reach CiscoView 6.1 from NM map (standalone only).

NM adapter to use for integration.

To install Integration Utility on Windows:


Step 1 Unzip the IntgUtil.v1-6.win.zip file into a target directory.

A setup.exe is created in the target directory.

Make sure that your target directory name do not contain blank spaces.

Step 2 Run setup.exe from the target directory.

The Install Shield setup program appears.

Step 3 Click Install to install the utility.

The Welcome screen appears.

Step 4 Click Next to continue.

The Software License Agreement dialog box appears.

Step 5 Click Yes to accept the license agreement and proceed with the installation.

The Setup Type dialog box appears.

To deny the agreement and stop the installation, click No.

Step 6 Select one of the following installation modes:

Typical to install Integration Utility in the default location (System Drive\Program Files\CSCOpx).

See Installing Integration Utility in Typical Mode.

Custom to customize the settings, and to specify the location.

See Installing Integration Utility in Custom Mode.


Installing Integration Utility in Typical Mode

To install Integration Utility in Typical mode:


Step 1 Select the desired installation mode (see Installing Integration Utility on Windows).

Step 2 Click Next to continue.

The installation program checks dependencies and component requirements.

The System Requirements dialog box appears with the system requirements, available space in the drive and Temp Directory (%TEMP%), and available memory.

Step 3 Click Next to continue.

The Create Casuser dialog box appears.

Step 4 Select either:

YesTo create the local user casuser. Casuser is the user who administers and maintains CiscoWorks Server without having administrative privileges.

Or

NoTo exit installation.

You can create the casuser and run the installation in Custom mode.

Step 5 Click Next to continue.

The installation proceeds and the Summary dialog box appears with the summary of settings for the installation.

Select either:

Show DetailsTo view passwords and other security sensitive data.

If you click Show Details, the Security Alert dialog box appears.

Click Yes in the Security Alert dialog box to view the Summary page with the passwords and other security sensitive data.

You can select and copy the data from the Summary page.

Hide DetailsTo hide the details.

BackTo change any settings.

Step 6 Click Next to continue.

The installation proceeds.

The Setup Complete dialog box appears after installation completes.

The Integration Utility is installed in C:\Program Files\CSCOpx.

If errors occur during installation, check the installation log located in the root directory on the drive where the operating system is installed.


Installing Integration Utility in Custom Mode

To install Integration Utility in Custom mode:


Step 1 Select the desired installation mode (see, Installing Integration Utility on Windows).

The Choose Destination Folder dialog box appears with the default location (System Drive\Program Files\CSCOpx).

To install in another location, click Browse and select the location.

We recommend that you specify a short path for the destination folder.

If the folder CSCOpx already exists in System Drive\Program Files\ with files or folders, a message appears:

The selected folder, System Drive\program files\CSCOpx is not empty. 
Mixing new and existing files can cause severe problems during 
installation. Please remove all files from this folder or choose 
another folder to install the product.

You must remove all files from this folder or choose another location to install Integration Utility.

Step 2 Either click Next to accept the default location.

Or

a. Select another location.

b. Click OK, and click Next.

The installation program checks dependencies and component requirements.

The System Requirements dialog box appears with the system requirements, available space in the drive and Temp Directory (%TEMP%), and available memory.

Step 3 Click Next to continue.

The Change Casuser Password dialog box appears.

Casuser is the user who administers and maintains CiscoWorks Server without having administrative privileges.

Step 4 Enter the casuser password and confirm it.

If you do not enter a password, the installation program generates a random password and adds the new user, Casuser and the new group, Casusers to the system.

Step 5 Click Next to continue.

The Installation proceeds and the Integration Utility dialog box appears after some time.

Step 6 Select either:

Later —To integrate after installation. You must run the utility (Change Integration Options) later.

Or

Now —To integrate during installation. Go to Step 7.

Step 7 Select any of the following:

The adapter file for your target NMS from the list of files.

Other —To specify an adapter file for a different NMS.

The Adapter selection screen appears. Browse for or enter the full pathname of the adapter file. If you have Cisco.com access, you can download adapters from the location http://www.cisco.com/kobayashi/sw-center/cw2000/cmc3rd.shtml

None —To choose an NMS adapter file later.You must run the utility (Change Integration Options) later.

Step 8 Click Next.

Step 9 Enter the remote server name, port number and protocol (http/https) where CiscoWorks Common Services is installed.

If you do not enter this optional information, CiscoWorks applications will not be integrated with the NMS. If you want to skip this, click Next and continue with Step 10.

Step 10 Select either:

No To not enter Cisco.com information now. You can enter it later when you want to upgrade.

Yes To enter Cisco.com user ID and password now for future upgrades.

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 standard Cisco.com web site (www.cisco.com).

Step 11 Click Next to continue.

The Summary dialog box appears, displaying the summary of settings for the installation.

Step 12 Click any of the following:

Show Details —To view passwords and other security sensitive data.

If you click Show Details, the Security Alert dialog box appears.

Click Yes in the Security Alert dialog box to view the Summary page with the passwords and other security sensitive data.

You can select and copy the data from the Summary page.

Hide Details To hide the details.

Back To change any settings.

Step 13 Click Next to continue.

The installation proceeds.

The Setup Complete dialog box appears after installation completes.

The Integration Utility is installed in the selected location.

If errors occur during installation, check the installation log located in the root directory on the drive where the operating system is installed.


Uninstalling Integration Utility

The uninstallation process depends on the way you have installed Integration Utility on your system.

If you have installed Integration Utility as a standalone product, you can uninstall it directly from your system.

You can also uninstall Integration Utility from the system where you have installed CiscoWorks Common Services.

This section contains:

Uninstalling With CiscoWorks Common Services 3.0

Uninstalling Standalone Integration Utility

Uninstalling With CiscoWorks Common Services 3.0

The CiscoWorks Integration Utility 1.6 is part of the CD-ROM that contains CiscoWorks Common Services 3.0 and CiscoView 6.1.You can choose to install Integration Utility 1.6 when you install CiscoWorks Common Services 3.0.

You can uninstall Integration Utility from the system where you have installed CiscoWorks Common Services. You can either choose to uninstall Integration Utility alone or to uninstall both Common Services and Integration Utility.

For more information on uninstalling Integration Utility which was installed as part of the CiscoWorks Common Services installation, see the respective uninstallation sections in the following Installation Guides:

Installation and Setup Guide for CiscoWorks Common Services 3.0 on Solaris

Installation and Setup Guide for CiscoWorks Common Services 3.0 on Windows

Uninstalling Standalone Integration Utility

You can uninstall Integration Utility that was installed as a standalone application on your system.

This section contains:

Uninstalling Standalone Integration Utility on UNIX

Uninstalling Standalone Integration Utility on Windows

Uninstalling Standalone Integration Utility on UNIX

You must use the uninstall command to remove Integration Utility. If you try to remove this utility manually, you may damage your system.

To uninstall Integration Utility on UNIX:


Step 1 As root, enter the following commands to start the uninstall script:

# cd /
# /opt/CSCOpx/bin/uninstall.sh

where /opt/CSCOpx is the default installation directory.

Step 2 Enter y or press Enter to confirm uninstallation.

Or

Enter n to quit the uninstallation process.

If you press y to continue uninstallation, the uninstallation proceeds.

After the uninstallation is complete, a message appears:

All files were deleted successfully.


Uninstalling Standalone Integration Utility on Windows

Use the Uninstall option to remove Integration Utility on your system. You must be logged in as administrator to remove the utility. If you try to remove the utility manually, you may damage your system.

To uninstall Integration Utility on Windows:


Step 1 From the Windows desktop, select
Start > Programs > CiscoWorks > Uninstall CiscoWorks.

The Uninstallation dialog box appears with
CiscoWorks Integration Utility -Standalone as the option.

Step 2 Click Next to continue uninstallation.

Messages about uninstallation appear and the Information dialog box appears at the end of the uninstallation.

Step 3 Click OK in the Information dialog box to complete uninstallation.