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

Importing Data Manually from Campus Manager 3.1 or 3.2

Uninstalling Campus Manager

Installing Campus Manager

This chapter describes how to install, upgrade, uninstall, and reinstall Campus Manager (Campus). You must install CiscoWorks Common Services before you can install Campus Manager. See Installation and Setup Guide for CiscoWorks Common Services on Solaris.

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 or 3.2, see the "Performing an Upgrade Installation" section.

Installation Notes

You must install CiscoWorks Common Services 2.2 before installing Campus. See Installation and Setup Guide for CiscoWorks Common Services on Solaris.

Campus Manager is installed in the directory where you installed CiscoWorks Common Services 2.2.

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.

The Campus Manager 3.3 installer will automatically update Campus 3.2 and 3.1 program files and migrate user-entered data related to Campus. The Campus 3.3 installer will also automatically re-apply some device updates previously released on Cisco's download site as Incremental Device Updates (IDU). IDU 1.0 and IDU 2.0 have been incorporated in Campus 3.3. If you have installed IDU 3.0 or higher for Campus 3.2, you will need to re-apply that IDU after the Campus 3.3 installation is complete.

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.
A message appears:
Press Enter to read/browse the following license agreement:
Step 3 Press Enter to read the license agreement. The following message appears at the end of the license agreement:
You must accept this License agreement for the installation to 
proceed. If you enter N/n, the installation will exit. 
Do you accept all the terms of the preceding License agreement? (y/n) 
[y]
Step 4 Enter y to accept the license and proceed with the installation or Enter n to deny and quit installation.

Note Campus is installed in the same location as CiscoWorks Common Services. The default is /opt/CSCOpx.

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

Step 5 Answer any questions that result from the checks.

The installation program prompts you to change the default password for the ANI database.

Step 6 Enter your ANI password.

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 following message appears:
To ensure that you retain the latest device support and bug 
fixes, please install the latest Incremental Device Update (IDU) 
for Campus Manager 3.3. You can download the latest IDU from
http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-campus. 
Please refer to the Installation and Setup Guide for details.
Note For more information about IDU, see "FAQs about IDU" section.

The installation completes, installing Campus in the same location as CiscoWorks Common Services 2.2 (/opt/CSCOpx by default). The CiscoWorks Server starts

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 either of the following:

•If you have data from the earlier version of Campus Manager (3.1 or 3.2) to import into Campus Manager 3.3, 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.3 from Campus Manager 3.2 and Campus Manager 3.1. For versions earlier than 3.1, upgrade to Campus Manager 3.1 before upgrading to Campus Manager 3.3.

Campus Manger 3.3 requires CiscoWorks Common Services 2.2, which is the foundation for the CiscoWorks Family of Products.

When you install CiscoWorks Common Services, the previous version of Campus Manager is removed and its database is preserved. When you install Campus Manager 3.3, certain data from the previous installation is preserved.

This data includes:

•SNMP community strings

•User Tracking manually entered data fields

•Seed devices

•User preferences

•Topology views including Layer 2 View, Unconnected Device View and LAN Edge View

You must upgrade to CiscoWorks Common Services 2.2 before installing or upgrading to Campus 3.3.

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 CiscoWorks Common Services 2.2 before installing Campus. See Installation and Setup Guide for CiscoWorks Common Services on Solaris.

Campus Manager is installed in the directory where you installed CiscoWorks Common Services 2.2.

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.

The Campus Manager 3.3 installer will automatically update Campus 3.2 and 3.1 program files and migrate user-entered data related to Campus. The Campus 3.3 installer will also automatically re-apply some device updates previously released on Cisco's download site as Incremental Device Updates (IDU). IDU 1.0 and IDU 2.0 have been incorporated in Campus 3.3. If you have installed IDU 3.0 or higher for Campus 3.2, you will need to re-apply that IDU after the Campus 3.3 installation is complete.

Running the Installation Program—Upgrade or Reinstallation

Use this installation procedure if you allowed the CiscoWorks Common Services installation program to save the previous data and remove the previous software.

If you installed CiscoWorks Common Services 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 CiscoWorks 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 CiscoWorks server system.

•Mount the CD-ROM on a remote Solaris system, then access the CD-ROM from the CiscoWorks 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.

A message appears:
Press Enter to read/browse the following license agreement:
Step 3 Press Enter to read the license agreement. The following message appears at the end of the license agreement:
You must accept this License agreement for the installation to 
proceed. If you enter N/n, the installation will exit. 
Do you accept all the terms of the preceding License agreement? (y/n) 
[y]
Enter y to accept the license and proceed with the installation or Enter n to deny and quit installation.

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

Note Campus is installed in the same location as CiscoWorks Common Services. The default is /opt/CSCOpx.

Step 4 A prompt appears:

Campus Manager 3.3 has been detected on your system. If you are running an evaluation version of Campus Manager 3.3 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]

Step 5 Enter y to continue to install or n to cancel.

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

Step 6 Answer any questions that result from the pre-installation checks.

The installation program prompts you to change the default password for the ANI database.

Step 7 Enter your ANI password.

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 following message appears:
To ensure that you retain the latest device support and bug 
fixes, please install the latest Incremental Device Update (IDU) 
for Campus Manager 3.3. You can download the latest IDU from
http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-campus. 
Please refer to the Installation and Setup Guide for details.
Note For more information about IDU, see "FAQs about IDU" section.

The installation completes. The CiscoWorks 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.3 format or directly use the default views generated by Campus Manager 3.3. 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.3 format.

If you do not want to upgrade to the new format but want to use the default views generated by the previous version of Campus Manager (3.1or 3.2), skip the following procedure and 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.3 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 in exactly the same manner as the previous version of the view. This is because of the new features in Campus Manager 3.3.

Importing Data After Installation

This section describes how to manually import data from previous versions of Campus. You might need to import data 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 and Campus Manger 3.2 formats to Campus Manager 3.3 format.

Converting Campus Data

Campus Manager accesses the ANI database for critical network information. The database from previous versions of Campus Manager (3.1or 3.2) is saved, and data from the database can be converted to Campus Manager 3.3 format for immediate use.

The CiscoWorks Common Services 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.3, the old ANI database, called ani.db, remains in the directory you indicated during the CiscoWorks Common Services install until you remove it.

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

Converting Campus 3.1 or Campus 3.2 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 previous versions of Campus Manager (3.1or 3.2). 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.3 format or directly use the default views generated by Campus Manager 3.3.

Importing Data Manually from Campus Manager 3.1 or 3.2

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

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 CiscoWorks Common Services on Solaris.

Step 2 Mount CiscoWorks Common Services 2.2, on the local machine.

Step 3 To save CiscoWorks data, enter:
# cd /cdrom/cdrom0/
#./export_cdone.pl
A prompt appears asking you to enter the location where you want to export CiscoWorks Common Services data.The default location is /opt/CSCOpx/rigel or where Campus Manager 3.1 or 3.2 has been installed.

Step 4 Mount Campus Manager 3.3 on the local system.

Step 5 To save Campus data, enter:
# cd /cdrom/cdrom0/
# ./export_cm.pl
A prompt appears asking you to enter the location where you want to export Campus data.The default location is /opt/CSCOpx/rigel or where Campus Manager 3.1 or 3.2 has been installed.

Note You must export Campus data to the location where CiscoWorks Common Services data has been exported.

Step 6 Copy all subdirectories except the scripts directory from the location in the local machine to which you have exported the data to $NMSROOT/rigel on the remote system.

Step 7 Start the daemon manager on the local machine.

For more information, see Installation and Setup Guide for CiscoWorks Common Services 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 CiscoWorks Common Services on Solaris.

Step 9 To copy CiscoWorks data to corresponding CiscoWorks Common Services directories on the remote machine, enter:
# cd /$NMSROOT/rigel/scripts
# ./import_cdone.pl
A prompt appears:
Importing will cause all the export data files to be overwritten.
Are you sure you want to import CiscoWorks data (y/n)? [n]
Step 10 Enter y to import or n to cancel.

Step 11 To copy Campus data to corresponding Campus Manager 3.3 directories, enter:
# cd /$NMSROOT/rigel/scripts
# ./import_cm.pl
A prompt appears:

Importing will cause all the files to be overwritten. Are you sure you want to import Campus data (y/n)? [n]

Step 12 Enter y to import or n to cancel.

Step 13 Start the daemon manager on the remote machine.

Step 14 For more information see Installation and Setup Guide for CiscoWorks Common Services on Solaris.

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

Uninstalling Campus Manager

The uninstallation program removes Campus files and settings. The uninstall option enables you to remove only Campus or remove CiscoWorks Common Services 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.

A prompt similar to the following appears:
1) Cisco View
2) Integration Utility
3) CiscoWorks Common Services
4) Campus Manager
5) All of the above
Step 2 Select one or more of the items using its number separated by comma or enter q to quit [q]

•To remove Campus Manager only, enter the number that corresponds to it (in this case, 4).

•To remove Campus Manager, CiscoWorks Common Services, Cisco View and Integration Utility enter the number that corresponds to all of the above (in this case, 5).

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

Step 3 Enter y to continue to uninstall or n to cancel.

A prompt appears that lists the packages that the uninstallation is about to delete:
Delete the CiscoWorks packages? (y/n)? [y] 
Step 4 Enter y to continue to uninstall or n to cancel.

Other prompts might appear. 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.

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