Installation and Setup Guide for Campus Manager 3.2 on Solaris
Installing 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 Campus 3.1 Data

Importing Data Manually from Campus Manager 3.1

Upgrading Saved Views From Topology Services

Uninstalling Campus Manager


Installing Campus Manager


This chapter describes how to install, upgrade, uninstall, and reinstall Campus Manager (Campus). You must install CiscoWorks2000 CD One, 5th Edition before you can install Campus Manager. See Installation and Setup Guide for CD One on Solaris.


Note Ensure that SSL (Secure Socket Layer) is disabled in CiscoWorks 2000 server before you install Campus Manager.


This chapter contains:

Installation Overview

Performing a New Installation

Performing an Upgrade Installation

Importing Data After Installation

Uninstalling 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 Manager Overview 

Task
Steps
References

1. Prepare to install Campus Manager.

Verify that server requirements are met.

"Server Requirements" section

2. Install Campus.

a. Mount the Campus Manager CD-ROM.

"Mounting and Unmounting the CD-ROM"

b. Run the installation program.

"Performing a New Installation" section

or

"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 Campus Manager 3.1, see the "Performing an Upgrade Installation" section.

Installation Notes

You must install CiscoWorks2000 CD One, 5th Edition before installing Campus. See Installation and Setup Guide for CD One on Solaris.

You must disable SSL (Secure Socket Layer) from CD One before installing Campus Manager 3.2.

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

You can press Ctrl-C at any time to end the installation. However, any changes to your system (for example, installation of new files or changes to system files) will not be undone.

Running the Installation Program—New Installation

To install Campus Manager:


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

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

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

See Appendix B, "Mounting and Unmounting the CD-ROM" for mounting instructions.

Step 2 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.


Note Campus is installed in the same location as CiscoWorks2000 CD One. The default is /opt/CSCOpx.


The installation program checks for compatible patches, dependencies, and disk space.

Step 3 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 (/opt/CSCOpx by default). The CiscoWorks2000 Server is running.


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

After the installation completes, do one of the following:

If you have data from Campus Manager 3.1 to import into
Campus Manager 3.2, see the "Importing Data After Installation" section.

If you do not have data to import, continue to "Preparing to Use Campus Manager."

For more information about the ANI database, see the "Understanding the Data Conversion" section.

Performing an Upgrade Installation

You can upgrade to Campus Manager 3.2 from Campus Manager 3.1. For versions earlier than 3.1, upgrade to Campus Manager 3.1 before upgrading to Campus Manager 3.2.

Campus Manger 3.2 requires CiscoWorks2000 CD One, 5th 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.2, certain data from the previous installation is preserved.

This data includes:

SNMP community strings

User Tracking manually entered data fields

Seed devices

User preferences

If you are upgrading from Campus Manager 3.1, Topology Services saves certain views during installation. These views include the following:

Layer 2 View

Unconnected Device View

LAN Edge View

You must upgrade to CiscoWorks2000 CD One, 5th Edition before installing or upgrading to Campus 3.2.


Caution Uninstalling Campus deletes the ANI database.

For more information about the ANI database, see the "Understanding the Data Conversion" section.

Installation Notes

You must install CiscoWorks2000 CD One 5th Edition before installing Campus. See Installation and Setup Guide for CD One on Solaris.

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

You can press Ctrl-C at any time to end the installation. However, any changes to your system (for example, installation of new files or changes to system files) will not be undone.

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 Manager, you can manually import your existing database to the system on which CiscoWorks2000 is installed if it was not automatically imported during installation. See the "Importing Data After Installation" section.

To run the installation program for an upgrade:


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

Mount the CD-ROM on the CiscoWorks2000 server system.

Mount the CD-ROM on a remote Solaris system, then access the CD-ROM from the CiscoWorks2000 server system.

See "Mounting and Unmounting the CD-ROM," for detailed mounting instructions.

Step 2 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.

If you are reinstalling Campus Manager continue to Step 3. If you are upgrading skip to Step 4.


Note Campus is installed in the same location as CiscoWorks2000 CD One. The default is /opt/CSCOpx.


Step 3 A prompt appears:

Campus Manager has been detected on your system. If you are running an evaluation version of Campus Manager and you choose to reinstall the product, you will automatically upgrade to a licensed version. Are you sure you want to reinstall this software and any required patches.(y/n)? [n]

Enter y to continue to uninstall or n to cancel.

The installation program checks on your system for compatible patches, dependencies, disk space, 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.

The installation completes. The CiscoWorks2000 Server is running.


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

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. See 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.2 format or directly use the default views generated by Campus Manager 3.2. See 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.2 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, select Layer 2 View, LAN Edge View, or Unconnected Devices View from the side panel in Topology Services.


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.2 format.

Step 5 To display this view, select the corresponding view from the side panel in Topology Services.


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



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

Data must be converted from Campus Manager 3.1 format to Campus Manager 3.2 format.

Converting Campus Data

Campus Manager accesses the ANI database for critical network information. The database from Campus Manager 3.1 is saved, and data from the database can be converted to Campus Manager 3.2 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.2, the old ANI database, called ani.db, remains in the directory you indicated during the CD One install until you remove it.

For more information about the ANI database, see the ANI online help or User Guide for CiscoWorks2000 Server.

Converting Campus 3.1 Data

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

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.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.2 format or directly use the default views generated by Campus Manager 3.2.

Importing Data Manually from Campus Manager 3.1

Follow this procedure to remotely import saved data from Campus Manager 3.1.


Step 1 Stop the daemon manager on the local machine on which the previous version of Campus Manager is installed. For more information on stopping the daemon manager, refer to Installation and Setup Guide for CD One on Solaris.

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

Step 3 To save CiscoWorks2000 data, enter:

# cd /cdrom/cdrom0/
#./export_cdone.pl

Step 4 Mount Campus Manager 3.2 on the local system.

Step 5 To save Campus data, enter:

# cd /cdrom/cdrom0/
# ./export_cm.pl

Step 6 Copy all subdirectories except the scripts directory 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, see Installation and Setup Guide for CD One on Solaris.

Step 8 Stop the daemon manager on the remote machine. For more information on stopping the daemon manager, see Installation and Setup Guide for CD One on Solaris.

Step 9 To copy CiscoWorks2000 data to corresponding CD One, 5th 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.2 directories, enter:

# cd /opt/CSCOpx/rigel/scripts
# ./import_cm.pl

Step 11 Start the daemon manager on the remote machine. Refer to Installation and Setup Guide for CD One on Solaris for more information.


After Campus is installed, Topology Services allows you to either convert the saved views into the new Campus Manager 3.2 format or directly use the default views generated by Campus Manager 3.2. See 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.2 format.

If you do not want to upgrade to the new format but want to use the default views generated by Campus Manager 3.2, select Layer 2 View, LAN Edge View, or Unconnected Devices View from the side panel in Topology Services.


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.2 format.

Step 5 To display this view, select the corresponding view from the side panel in Topology Services.


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



Uninstalling 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 Campus Manager uninstallation program to remove the product. If you attempt to remove Campus Manager or its components manually, you could damage your system.


Caution Uninstalling Campus Manager deletes the ANI database. To upgrade and convert the database, see the "Performing an Upgrade Installation" section.

To remove Campus Manager or other major components:


Step 1 Enter the following commands as root to start the uninstall program:

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

where /opt/CSCOpx is the default installation directory. If you specified a different directory when you installed Device Manager, substitute the name of the directory.

Step 2 A prompt similar to the following appears:

1) CD One, Fifth Edition (including Integration Utility)
2) Campus Manager
3) CMF Web Desktop
4) 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, 2).

To remove Campus Manager, CiscoWorks2000 CD One and CMF Web Desktop, enter the number that corresponds to all of the above (in this case, 4).

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.

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 5 Check /etc/syslog.conf for syslog changes. See Appendix A, "Troubleshooting the Installation" for more information.


To reinstall Campus Manager, follow the instructions in the "Performing an Upgrade Installation" section.