Installing and Setting Up Campus Manager 3.1 on AIX - Installing Campus Manager [CiscoWorks Campus Manager]

Table Of Contents

Installing Campus Manager

Installation Overview

Performing a New Installation

Installation Notes

Running the Installation Program—New Installation

Performing an Upgrade Installation

Installation Notes

Running the Installation Program—Upgrade or Reinstallation

Upgrading Saved Views From Topology Services

Importing Data After Installation

Understanding the Data Conversion

Converting Campus Data

Converting CWSI 2.4 Data

Converting Campus 3.0 and Campus 3.0.1 Data

Importing Data Manually From CWSI 2.4

Importing Data Manually from Campus Manager 3.0 and 3.0.1

Upgrading Saved Views From Topology Services

Removing Campus Manager

Installing Campus Manager

This chapter describes how to install, upgrade, uninstall and reinstall Campus Manager (Campus). You must install CiscoWorks2000 CD One Fourth Edition before you can install Campus Manager. Refer to Installing and Setting Up CiscoWorks2000 CD One, 4th Edition AIX.

This chapter contains:

•Installation Overview

•Performing a New Installation

•Performing an Upgrade Installation

•Importing Data After Installation

•Removing Campus Manager

Installation Overview

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

Table 2-1 Installing Campus Overview

Task

Steps

References

1. Prepare to install Campus.

Verify that server requirements are met.

The "Server Requirements" section

2. Install Campus.

a. Mount the Campus CD-ROM.

"Mounting and Unmounting the CD-ROM"

b. Run the installation program.

The "Performing a New Installation" section or

The "Performing an Upgrade Installation" section

3. Verify and troubleshoot the installation

a. Verify that correct files and directories are installed.

"Understanding Installation Error Messages" section

b. Analyze installation error messages.

"Understanding Installation Error Messages" section

4. Set up Campus Manager.

Prepare the system for Campus applications and set up the applications.

"Preparing to Use Campus Manager"

Performing a New Installation

This section describes a new Campus Manager installation. If you are upgrading from CWSI Campus 2.4, Campus Manager 3.0, or Campus Manager 3.0.1, refer to the "Performing an Upgrade Installation" section.

Installation Notes

You must install CiscoWorks2000 CD One Fourth Edition before installing Campus. Refer to Installing and Setting Up CiscoWorks2000 CD One, 4th Edition AIX.

Campus is installed in the default directory /usr/CSCOpx. If you selected another directory during the CiscoWorks2000 CD One Fourth Edition installation, Campus is installed in that directory.

The Campus installation program takes approximately 40 minutes to complete on a AIX system with the minimum required hardware.

Note 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 "Troubleshooting the Installation".

Running the Installation Program—New Installation

To install Campus:

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

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

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

Refer to "Mounting and Unmounting the CD-ROM" for detailed 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:

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

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

The installation program performs several preinstallation 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.

Answer any questions that result from the checks.

The installation program displays many messages about the various packages being installed and the services being started. The packages include application software and device adapter packages for all devices that can be managed with Campus applications.

The installation completes, installing Campus in the same location as CD One (/usr/CSCOpx by default).

If errors occurred during installation, check the installation log file /var/tmp/ciscoinstall.log. For information troubleshooting, refer to "Troubleshooting the Installation."

After the installation finishes, choose one of the following:

•If you have a database from a previous version of CWSI Campus to import into Campus Manager 3.1, refer to the "Importing Data After Installation" section.

•If you do not have a database to import, continue to "Preparing to Use Campus Manager."

Note For more information about the ANI database, refer to the "Understanding the Data Conversion" section.

Performing an Upgrade Installation

You can upgrade to Campus Manager 3.1 from CWSI Campus 2.4, Campus Manager 3.0, or Campus Manager 3.0.1. For versions of CWSI Campus earlier than version 2.4, uninstall the application or upgrade to CWSI Campus 2.4 before upgrading to Campus 3.1.

Campus requires CiscoWorks2000 CD One Fourth Edition, which is the foundation for the CiscoWorks2000 Family of Products; it includes the CiscoWorks2000 Server and the ANI Server.

When you install CiscoWorks2000 CD One, the previous version of CWSI Campus is removed and its database is preserved. When you install Campus Manager 3.1, the preserved database is converted to Campus Manager 3.1 format. For versions of CiscoWorks2000 CD One earlier than the Fourth Edition, you must upgrade to CiscoWorks2000 CD One Fourth Edition before installing or upgrading to Campus 3.1.

When you install Campus Manager 3.1, certain data from the preserved database is converted to Campus Manager 3.1 format. This data includes:

•SNMP community strings

•User Tracking manually entered data fields

•Seed devices

If you are upgrading from Campus Manager 3.0 or Campus Manager 3.0.1, Topology Services saves certain views during installation. These views include:

•Layer 2 View

•Unconnected Device View

•LAN Edge View

For versions of CiscoWorks2000 CD One earlier than the 4th Edition, you must upgrade to CiscoWorks2000 CD One, 4th Edition before installing or upgrading to Campus 3.1.

Note Uninstalling Campus deletes the ANI database. For more information about the ANI database, refer to the "Understanding the Data Conversion" section.

Installation Notes

You must install CiscoWorks2000 CD One Fourth Edition before installing Campus. Refer to Installing and Setting Up CiscoWorks2000 CD One, 4th Edition AIX.

Campus is installed in the default directory /usr/CSCOpx. If you selected another directory during the CiscoWorks2000 CD One Fourth Edition installation, Campus is installed in that directory.

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

Running the Installation Program—Upgrade or Reinstallation

Use this installation procedure if you allowed the CD One installation program to save the previous data and remove the previous software.

If you installed CD One on a clean system, follow the procedure for a new installation in the "Performing a New Installation" section.

After installing Campus, you can manually import your existing database to the system on which CiscoWorks2000 is installed if it was not automatically imported during installation. Refer to the "Importing Data After Installation" section.

To run the installation program for an upgrade:

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

•Mount the CD-ROM on the CiscoWorks2000 server system

Or

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

Refer to "Mounting and Unmounting the CD-ROM" 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.

Note Campus will be installed in the same location as CiscoWorks2000 CD One Fourth Edition. The default is /usr/CSCOpx.

Step 3 A prompt appears:

CW2000 has been detected on your system, are you sure you want to reinstall (y/n)? [n]

Enter y to continue to uninstall or n to cancel.

The installation program checks on your system for compatible patches, dependencies, diskspace, memory (RAM), and swap space.

Step 4 Answer any questions that result from the pre-installation checks:

The installation program displays many messages about the various packages being installed and the services being started. The packages include application software and device adapter packages. The packages for all devices that can be managed with Campus applications are installed. The database is converted.

If errors occurred during installation, check the installation log file /var/tmp/ciscoinstall.log. For troubleshooting information, refer to "Troubleshooting the Installation."

After the installation finishes, continue on to "Preparing to Use Campus Manager."

After the installation finishes, choose one of the following:

•If you installed Campus on a different system and have data to import, you can import the database remotely. Refer to the "Importing Data After Installation" section for more information.

•If your data is already converted or you do not want to import the old data, continue to "Preparing to Use Campus Manager."

After Campus is installed, Topology Services allows you to either convert the saved views in the new Campus Manager 3.1 format or directly use the default views generated by Campus Manager 3.1. Refer to the "Upgrading Saved Views From Topology Services" section for more information.

Upgrading Saved Views From Topology Services

Use this procedure to upgrade saved topology views to the new Campus Manager 3.1 format. If you do not want to upgrade to the new format but want to use the default views generated by Campus Manager 3.1, selecting Layer 2 View, LAN Edge View, or Unconnected Devices View from the side panel in Topology Services displays them.

Step 1 Start Topology Services from the desktop.

Step 2 Select File > Upgrade View Layouts.

Step 3 Select the view you want to upgrade.

Step 4 Click Upgrade to upgrade the selected view.

Topology Services upgrades the selected view to the Campus Manager 3.1 format. Selecting the corresponding view from the side panel in Topology Services displays them.

Note The upgraded view might not be formatted exactly the same as the previous version of the view because of the new features in Campus Manager 3.1.

Importing Data After Installation

This section describes how to manually import data from previous versions of Campus. You might need to import manually if you performed a new installation of Campus but have data from previous versions of the software on a different system.

Understanding the Data Conversion

Certain data must be converted from CWSI Campus2.4, Campus Manager 3.0, or Campus Manager 3.0.1 format to Campus Manager 3.1 format.

Converting Campus Data

Campus Manager accesses the ANI database for critical network information. The database from CWSI 2.4, Campus Manager 3.0, or Campus Manager 3.0.1 is saved, and certain data from the database can be converted to Campus Manager 3.1 format for immediate use.

The CiscoWorks2000 CD One installation, which is required for the Campus Manager installation, automatically saves your old database. When you install Campus Manager, the saved database is imported into the new file, ani.db. After you import your database into Campus Manager 3.1, the old CWSI database, called cwsi.db, remains in the directory you indicated during the CD One install until you remove it.

For more information about the ANI database, refer to the ANI online help or Getting Started with the CiscoWorks2000 Server.

Converting CWSI 2.4 Data

The community strings are transferred from the old communities.dat file (specified by the Community File property in the ani.properties file) to the new anisnmp.conf file. The following properties from the CWSI ani.properties file are updated in the new ANIServer.properties file:

•Discovery.seed

•Discovery.router

•Domains.include

•Domains.exclude

The User Tracking data is extracted from the old cwsi.db file and saved as bg_ut.txt. This data is found and processed during the first User Tracking discovery.

Converting Campus 3.0 and Campus 3.0.1 Data

The community strings are upgraded from the old anisnmp.conf file to the updated anisnmp.conf file. The following properties from the old ANIServer.properties file are updated in the new ANIServer.properties file:

•Discovery.seed

•Discovery.router

•Domains.subnets.include

•Discovery.subnets.exclude

The User Tracking data is extracted from the old ani.db file and saved as rigel_ut.txt. This data is found and processed during the first User Tracking discovery.

Topology Services saves topology views from Campus Manager 3.0 and 3.0.1. The following views are saved:

•Layer 2 View

•Unconnected Device View

•LAN Edge View

After Campus is installed, Topology Services allows you to either convert the saved views into the new Campus Manager 3.1 format or directly use the default views generated by Campus Manager 3.1.

Importing Data Manually From CWSI 2.4

To import data manually:

Step 1 Install CiscoWorks2000 CD One, 4th Edition and Campus Manager 3.1.

Step 2 Log in as root.

Step 3 Mount the directory containing the previous data or copy the data to the CiscoWorks2000 Server.

Step 4 Stop the daemon manager on the local machine.

Step 5 Enter:
# cd /
# opt/CSCOpx/conf/bg2rigel/scripts/bg2rigel.pl -l <CWSI data path> cm 
The converted database is called ani.db.

Step 6 Start the daemon manager on the local system.

When you access Campus applications, the database will be found. You should immediately backup the converted ANI database.

Continue to "Preparing to Use Campus Manager."

Importing Data Manually from Campus Manager 3.0 and 3.0.1

Follow this procedure to remotely import saved data from Campus Manager 3.0 or 3.0.1.

Step 1 Stop the daemon manager on the local machine on which the previous version of CD One is installed. For more information on stopping the daemon manager, refer to Installing and Setting Up CiscoWorks2000 CD One, 4th Edition on AIX.

Step 2 Mount CD One, 4th Edition, on the local system.

Step 3 To save CiscoWorks2000 data, enter:
# cd /cdrom
# perl patch_1x_20.pl
#./export_cdone.pl.
Step 4 Mount Campus Manager 3.1 on the local system.

Step 5 To save Campus data, enter:
# cd /cdrom
# perl patch_1x_20.pl
# ./export_cm.pl
Step 6 Copy all subdirectories under /opt/CSCOpx/rigel/ from the local system to /opt/CSCOpx/rigel on the remote system.

Step 7 Start the daemon manager on the local system. For more information, refer to Installing and Setting Up CiscoWorks2000 CD One,4th Edition, on AIX.

Step 8 Stop the daemon manager on the remote machine. For more information on stopping the daemon manager, refer to Installing and Setting Up CiscoWorks2000 CD One, 4th Edition on AIX.

Step 9 To copy CiscoWorks2000 data to corresponding CD One, 4th Edition, directories on the remote machine, enter:
# cd /opt/CSCOpx/rigel/scripts
# ./import_cdone.pl
Step 10 To copy Campus data to corresponding Campus Manager 3.1 directories, enter:
# cd /opt/CSCOpx/rigel/scripts
# ./import_cm.pl
Step 11 Start the daemon manager on the remote machine. Refer to Installing and Setting Up CiscoWorks2000 CD One, 4th Edition on AIX for more information.

After Campus is installed, Topology Services allows you to either convert the saved views into the new Campus Manager 3.1 format or directly use the default views generated by Campus Manager 3.1. Refer to the "Upgrading Saved Views From Topology Services" section for more information.

Upgrading Saved Views From Topology Services

Use the following procedure to upgrade saved topology views to the new Campus Manager 3.1 format. If you do not want to upgrade to the new format but want to use the default views generated by Campus Manager 3.1, selecting Layer 2 View, LAN Edge View, or Unconnected Devices View from the side panel in Topology Services displays them.

Step 1 Start Topology Services from the desktop.

Step 2 Select File > Upgrade View Layouts.

Step 3 Select the view you want to upgrade.

Step 4 Click Upgrade to upgrade the selected view.

Topology Services upgrades the selected view to the Campus Manager 3.1 format. Selecting the corresponding view from the side panel in Topology Services displays them.

Note The upgraded view might not be formatted exactly the same as the previous version of the view because of the new features in Campus Manager 3.1.

Removing Campus Manager

The uninstall program removes Campus files and settings. The uninstall option enables you to remove only Campus or remove CiscoWorks2000 CD One as well.

Caution You must use the uninstall option of the Campus installation program to remove the product. If you attempt to remove Campus or its components manually, you can damage your system.

Caution Uninstalling Campus Manager will delete the database. To upgrade and convert the database, refer to "Performing an Upgrade Installation."

To remove Campus or other major components:

Step 1 Enter the following commands as root to start the uninstall program:
# cd /
# /usr/CSCOpx/bin/uninstall.sh
where /usr/CSCOpx is the default installation directory. If you specified a different directory when you installed Campus Manager, substitute the name of the directory.

Step 2 A prompt similar to the following appears:
1) Campus Manager
2) CD One Fourth Edition (including Integration Utility)
3) All of the above
Select one of the items using its number or enter q to quit [q]
To remove Campus Manager only, enter the number that corresponds to it (in this case, 1).

Step 3 Another prompt appears, where the default selection is indicated in brackets:
Are you sure you want to uninstall: program name (y/n)? [n]
where program name is the name of the choice you entered in the last question. Enter y to continue to uninstall or n to cancel.

Step 4 Another prompt appears that lists the packages that the uninstallation is about to delete:

Delete the CiscoWorks 2000 packages? (y/n)? [y]

Enter y to continue to uninstall or n to cancel.

Other prompts might appear. You should answer them appropriately.

Step 5 The installation program displays a series of messages. Ignore any additional messages that ask if you want to remove packages. You cannot answer these questions.

When you remove Campus, 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.

When the uninstallation script successfully completes, the following message appears:
All files were deleted successfully.
Step 6 Check /etc/syslog.conf for syslog changes. Refer to "Troubleshooting the Installation" for more information.