Installing and Setting Up CD One, 4th Edition on AIX - Installing CD One [CiscoWorks CD One]

Table Of Contents

Installing CD One

Installation Overview

Preparing to Install CD One

Setting Environment Variables

Using the Server IP Address

TCP and UDP Ports Used

System Files Modified During Installation

Performing a New Installation

Running the Installation Program—New Installation

Performing an Upgrade Installation

Upgrading CD One—Local Upgrade

Upgrading CD One—Remote Upgrade

Removing CD One

Installing CD One

This chapter consists of:

•Installation Overview

•Preparing to Install CD One

•Performing a New Installation

•Performing an Upgrade Installation

•Removing CD One

Installation Overview

Table 2-1 is an overview of CD One installation tasks. It contains references to more detailed information about each task.

Table 2-1 Installing CD One Task Overview

Task

Steps

References

1. Prepare to install CD One.

a. Verify that server requirements are met.

"Prerequisites" chapter, "Server Requirements" section

b. Verify that client requirements are met.

"Prerequisites" chapter, "Client Requirements" section

c. Note TCP ports that CiscoWorks2000 uses and check for conflicts with existing applications.

"TCP and UDP Ports Used" section

2. Install server software.

Run installation program.

"Performing a New Installation" section

3. Verify and troubleshoot installation.

Analyze installation error messages.

"Troubleshooting the Installation" appendix, "Understanding Installation Messages" section

Caution You can cancel the installation at any time by pressing Ctrl-C.
However, any changes to your system (for example, installation of new files or changes to system files) will not be undone. Refer to Release Notes for CiscoWorks2000 CD One 4th Edition on AIX for instructions to manually clean up the system.

CD One is installed in the default directory /usr/CSCOpx.

Preparing to Install CD One

Before you install CD One, make sure your server and client environments meet the hardware and software requirements described in the "Prerequisites" chapter.

Note Do not use DHCP running in dynamic mode on the CiscoWorks2000 Server.

If you are running IBM Net View, the installation might take significantly longer to complete. Please stop all IBM Net View services before installing CD One.

Setting Environment Variables

Set these environment variables for CiscoWorks2000 system administrators. These variables are not required for tasks that users perform from the desktop.

•Add /opt/CSCOpx/bin to the PATH variable in the .cshrc or .profile files of CD One users who have administrator privileges.

•Add /opt/CSCOpx/man to the MANPATH variable.

Using the Server IP Address

To avoid inconsistencies in how domain names are used in networks, CiscoWorks2000 uses the IP address of the server when it interacts with web browsers. By using this IP address, CiscoWorks2000 eliminates name lookup failures between the server and the client machines that run web browsers.

TCP and UDP Ports Used

In addition to the standard network ports, CD One uses these TCP and UDP ports:

•42340/tcp (CiscoWorks2000 Daemon Manager, the tool that manages server processes)

•42342/udp (Osagent)

•42343/tcp (JRun)

•42344/tcp (ANI HTTP server)

•7500/udp (Electronic Switching System [ESS] Service port)

•7500/tcp (ESS Listening port)

•7580/tcp (ESS HTTP port)

•7588/tcp (ESS Routing port)

•1741/tcp (port used for the CiscoWorks2000 HTTP server)

See the "Preparing to Use CD One" chapter for more information about accessing the server.

System Files Modified During Installation

The system files modified during CD One installation are:

•/etc/services

•/etc/inetd.conf

•/etc/syslog.conf

•/etc/passwd

•/etc/group

Performing a New Installation

The CD One installation program takes approximately 1 hour to complete on a AIX system with the minimum required hardware. This can extend to 1 hour 30 minutes if you perform network management integration during the installation process.

For information on setting up multi-homed machines, refer to the Release Notes for CiscoWorks2000 CD One, 4th Edition.

Running the Installation Program—New Installation

To run the installation program:

Step 1 As root, mount the CD One CD-ROM using either of these methods:

•Mount the CD-ROM on the CD One server system.

•Mount the CD-ROM on a remote AIX system, then access the
CD-ROM from the CD One server system.

See the "Mounting and Unmounting on AIX" appendix for detailed mounting instructions.

Step 2 Run the installation program.

•For a local installation, enter:
# cd /cdrom
# ./setup.sh 
•For a remote installation, enter:
# cd remotedir
# ./setup.sh
where remotedir is the remote location where the CD-ROM is mounted.

A message appears:
Warning: User casuser already exists, the installation process will 
overwrite its privilege.
Do you want to continue (y/n)? [y]
This message will not appear if this is the first time CD One, 4th Edition, has been installed on this machine.

Step 3 Press Enter if you receive the casuser message. The installation program adds the new user casuser and the new group casusers to the system.

Note If CD One has previously been installed on this machine, the product will automatically be installed in the same location where CD One was previously installed.

A message appears:

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

Note If you select a installation directory other than /usr/CSCOpx, the /usr/CSCOpx directory will be created and will be a link to the directory you selected.

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

Step 5 Select one of these components.If CD One has previously been installed on this machine, the list of components will be different.

1) NMS Integration Utility to install only the Integration Utility
(For information about the Integration Utility and third-party NMS integration, refer to Using CiscoView.)

2) Common Management Foundation (CMF) Base Desktop to install a subset of CMF
(Select this option only if the application you will be installing next needs the CMF Base Desktop and you do not want CiscoView or NMS Integration Utility installed.)

3) CiscoView

4) CiscoView, NMS Integration Utility and CMF to install all CD One components (Recommended for most systems)

Step 6 Enter the number corresponding to the option you have chosen or q to quit.

Note For information about the Integration Utility, refer to
Using CiscoView 5.3.

The installation program performs several preinstallation and dependency checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen

A 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 this install or 
later.
Do You want to integrate with the third-party product now (y/n)? [n] 
Step 7 Select one of the following:

•n to integrate with a third party NMS after installation. (This is the recommended choice to complete the installation more quickly, and to avoid faulty third-party installation errors.)
If you select n, go to Step 8.

•y to integrate with a third party NMS during installation
If you select y, continue with steps a through c

a. Select the adapter from the list of available adapters, or select other to choose an adapter that is not listed. (You will be prompted to enter the path name of the adapter), or select none to integrate after the installation is complete.
If you select none, go to Step 8.

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

A message appears, asking if you want to enable download options from the Cisco Web page (CCO).

c. Select one of the following:

•n to not enable future upgrades from the Cisco Web page

•y to enable future upgrades from the Cisco Web page
Enter your CCO user ID and password.

Note You must have CCO login privileges. If you do not have a user account and password on CCO, contact your channel partner or enter a request on the standard CCO web site (www.cisco.com).

Step 8 After installation is complete, unmount the CD-ROM. See the "Mounting and Unmounting on AIX" appendix for details.

Note A warning message appears if obsolete AIX patches are present on your system. Before running CD One, 4th Edition, download and install the latest recommended patches from www.sunsolve.sun.com

If errors occurred during installation, check the installation log file /var/tmp/ciscoinstall.log. Each installation appends to this file. For troubleshooting information see the "Troubleshooting the Installation" appendix.

Step 9 Prepare the client system for use. See the "Preparing to Use CD One" chapter.

Performing an Upgrade Installation

During an upgrade from a previous version of CD One, the data is preserved. However, during an upgrade from previous CiscoWorks2000 applications (prior to CD One, 1st Edition), previous product versions are removed. The database, ANI information, community strings, user and host information, and application-specific data files are preserved and will be restored during the new product version installations.

For a description of the different upgrade paths and their results, refer to Table 1-1 ("Upgrade Paths").

To perform a local upgrade, see the "Upgrading CD One—Local Upgrade" section.

To perform a remote upgrade, see the "Upgrading CD One—Remote Upgrade" section.

Upgrading CD One—Local Upgrade

If you are upgrading from applications prior to CD One, 1st Edition, run the installation program as described below.

If you are upgrading from a previous edition of CD One, you must install a patch on the old system before you can begin installing CD One, 4th Edition. This patch suspends all currently scheduled job data. Necessary data can then be exported during upgrade to the new version.

To install the patch:

Step 1 As root, mount the CD One CD-ROM using either of these methods:

•Mount the CD-ROM on the CD One server system.

•Mount the CD-ROM on a remote AIX system, then access the
CD-ROM from the CD One server system.

See the "Mounting and Unmounting on AIX" appendix for detailed mounting instructions.

Step 2 At the command line, enter:
patch_1x_20.pl
The patch copies the file DisableJobs.class to the runtime installation directory.

Step 3 At the command line, enter:
cwjava -cw install directory com.cisco.nm.cmf.jrm.DisableJobs
The class file suspends all the jobs and creates a list of job IDs for the suspended jobs and other job information in a file called joblist.jrm. The file joblist.jrm is saved in $NMSROOT/setup. Jobs are re-enabled as part of the upgrade process for individual applications.

Now that the patch is installed, you can install CD One, 4th Edition.

To run the installation program:

Step 1 Install the required patches as described in the "AIX Patches" section.

Step 2 As root, mount the CD One CD-ROM using either of these methods:

•Mount the CD-ROM on the CD One server system.

•Mount the CD-ROM on a remote AIX system, then access the
CD-ROM from the CD One server system.

See the "Mounting and Unmounting on AIX"appendix for detailed mounting instructions.

Step 3 Run the installation program.

•For a local installation, enter:
# cd /cdrom/cdrom0/
# ./setup.sh 
•For a remote installation, enter:
# cd remotedir
# ./setup.sh
where remotedir is the remote location where the CD-ROM is mounted.

A message may appear:
Warning: User casuser already exists, the installation process will 
overwrite its privilege.
Do you want to continue (y/n)? [y]
This message will not appear if this is the first time CD One, 4th Edition, has been installed on this machine.

Step 4 Press Enter if you receive the casuser message. The installation program adds the new user casuser and the new group casusers to the system.

Note If you are upgrading from a previous version of CD One, proceed to the next step. Otherwise, skip to Step 6.

Step 5 A message appears, stating that the installation of CiscoView 5.3 will remove all existing device support files and replace it with the files found in CD One, 4th Edition. To access a list of existing and CiscoView 5.3 device support files, navigate to the directory specified at the end of the message.

Note The device support files installed with CD One, 4th Edition may be older than the files currently on your system. If that is the case, download the latest device support files from www.cisco.com.

Press Enter to continue, and skip to Step 12.

Step 6 A message appears, stating that Essentials and CWSI have been detected.

You are then prompted:
Do you want to proceed with the backup? (y/n) [y]
If you proceed with the backup, key data from the current applications will be archived before deletion from the server. You can then import this information can into the latest applications upon installation.

Step 7 Enter y, then specify the path where the previous product data will be archived or press Enter to accept the default path, /opt/CW2000/OldData.

The installation program copies database files and stores them in the location you specified.

Note Refer to the online help for your specific applications for information on importing data into new application versions.

Step 8 A message appears:
The current product's data has been saved in /opt/CW2000/OldData.  
Setup will now uninstall <product name>.
Do you want to continue? (y/n) [y]
Select y to uninstall the previous product.

Step 9 Press Enter.

The CD One install script removes the previous product, saves data in the location you specified in Step 6, then displays:

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

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

Step 11 Select one of the following:

1) NMS Integration Utility to install only the Integration Utility
(For information about the Integration Utility and third-party NMS integration, refer to Using CiscoView.)

2) Common Management Foundation (CMF) Base Desktop to install a subset of CMF
(Select this option only if the application you'll be installing next requires the CMF Base Desktop and you do not want CiscoView or NMS Integration Utility installed.)

3) CiscoView

4) CiscoView, NMS Integration Utility and CMF to install all CD One components (Recommended for most systems)

Note If CD One has previously been installed on this machine, the product will automatically be installed in the same location CD One was previously installed.

Enter the number corresponding to the option you have chosen or type q to quit.

Step 12 The installation program performs several preinstallation and dependency checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen.

Step 13 If you are upgrading from CD One 1.0 or 1.1, a message appears:
Existing CV Device Packages will be removed. Press Enter to continue.
Step 14 Press Enter to continue. Information about the Integration Utility appears.

If your previous version of CiscoWorks2000 is already integrated with a third-party NMS, enter your CCO user ID and password, and go to Step 16. If your previous version of CiscoWorks2000 is not already integrated with a third-party NMS, a message appears:
The Integration Utility will be installed now. The Integration Utility 
integrates Cisco device packages and Cisco applications into a 
third-party SNMP management platform. You can choose to integrate with 
a third-party SNMP management platform during this install or later.
Do you want to integrate with the third-party product now (y/n)? [n] y
Note For information about the Integration Utility, refer to Using CiscoView.

Step 15 Select one of the following:

•n to integrate with a third-party NMS after installation (this is the recommended choice to complete the installation more quickly, and to avoid faulty third-party installation errors)
If you select n, go to Step 16.

•y to integrate with a third-party NMS during installation
If you select y, continue with steps a through c

a. Select the adapter from the list of available adapters, or select other to choose an adapter that is not listed (you will be prompted to enter the path name of the adapter), or select none to integrate after the installation is complete.
If you select none, go to Step 16.

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

A message appears, asking if you want to enable download options from the Cisco Web page (CCO).

c. Select one of the following:

•n to disallow future upgrades from the Cisco Web page.

•y to enable future upgrades from the Cisco Web page.
Enter your CCO user ID and password.

Note You must have CCO login privileges. If you do not have a user account and password on CCO, contact your channel partner or enter a request on the standard CCO web site (www.cisco.com).

Step 16 After installation is complete, unmount the CD-ROM. See the "Mounting and Unmounting on AIX"appendix for details.

Note A warning message appears if obsolete AIX patches are present on your system. Before running CD One, 4th Edition, download and install the latest recommended patches from www.sunsolve.sun.com.

If errors occurred during installation, check the installation log file /var/tmp/ciscoinstall.log. Each installation appends to this file. For troubleshooting information or to verify the directories installed on your system, see the "Troubleshooting the Installation" appendix.

Step 17 Prepare the client system for use. See the "Preparing to Use CD One"chapter.

Upgrading CD One—Remote Upgrade

If you do not want to overwrite your current application and replace it with
CD One, 4th Edition, you can perform a remote upgrade instead. During a remote upgrade, you install CD One, 4th Edition, on a new machine, and export essential data to the new machine from the machine running the previous version.

Step 1 Install CD One on the new machine. See the "Performing a New Installation" section.

Caution If you are planning to perform a remote upgrade, do not change the database password for the new version of CD One. Changing the password will make the target system's database inaccessible after the upgrade.

Step 2 Remove the CD One CD-ROM from the new machine.

If you are upgrading from applications prior to CD One, 1st Edition, you must import application data to the new system. Refer to the online help for your specific applications for information about importing data into new application versions.

If you are upgrading from a previous edition of CD One, data from all jobs must be exported to the new system. To make this possible, you must first install a patch on the old system. The patch is shipped with CD One. Continue on to the next section to install the patch.

To install the patch:

Step 1 Insert the CD One CD-ROM into the CD-ROM drive of the machine running the previous version of CD One.

Step 2 At the command line, enter:
patch_1x_20.pl
Step 3 At the command line, enter:
cwjava -cw install directory com.cisco.nm.cmf.jrm.DisableJobs
The class file suspends all the jobs and creates a list of job IDs for the suspended jobs and other job information in a file called joblist.jrm. The file joblist.jrm is saved in $NMSROOT/setup. Jobs are re-enabled as part of the upgrade process for individual applications.

Now that you have installed the patch, you can export the necessary job data from the old machine to the new one.

To export the data:

Step 1 The CD One CD-ROM should be in the CD-ROM drive of the machine running the old version of CD One. Go to the Root directory on the CD One CD-ROM.

Step 2 From the Root directory, run the script export_cdone.pl.

Step 3 Copy the directories $NMSROOT/rigel/cmf and $NMSROOT/rigel/manifest/cmf from the machine running the old version of CD One into the corresponding directories on the machine running the new version of CD One.

Step 4 On the new machine, go to the directory $NMSROOT/rigel/scripts, and run the script import_cdone.pl.

Step 5 Start the daemon manager. At the command line, enter:
/etc/init.d/dmgtd start
The upgrade is now complete, and all necessary job data from the previous version of CD One has been exported.

Removing CD One

Use the uninstall command to remove CD One files and settings.

Caution You must use the uninstall command to remove the product. If you try to remove CD One or its components manually, you can damage your system.

Step 1 As root, enter the following commands to start the uninstall script:
# cd /
# /usr/CSCOpx/bin/uninstall.sh
where /usr/CSCOpx is the default installation directory.

A list of CiscoWorks2000 components appears.

Note When you remove CD One, the uninstall script removes changes made to the /etc/services file. The /etc directory still contains all system file changes. The uninstall messages are written to the /var/tmp/ciscouninstall.log file.

Step 2 Enter the number corresponding to the option you have chosen or q to quit.

When the uninstall script is complete, a message appears:
All files were deleted successfully.
Step 3 Check /etc/syslog.conf for syslog changes. Check /etc/services to ensure that port assignments for the Daemon Manager and web server have been removed.