Installation and Setup Guide for Campus Manager 3.3 on Windows
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 and 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 Windows.

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 Overview 

Task
Steps
References

1. Prepare to install Campus.

Verify that server requirements are met.

"Server Requirements" section

2. Install Campus.

Run the installation program.

"Performing a New Installation" section

or

"Performing an Upgrade Installation" section

3. Verify and troubleshoot installation.

a. Verify the 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 Campus Manager 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 Windows.

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

You might see warnings that the installation system is running out of disk space. You can chose to free space on the system and click Yes to continue, or click No to exit the installation.

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:


Step 1 Insert the Campus CD-ROM into a CD-ROM drive.

The Installer window opens. Continue to Step 3.

If the Installer window does not open, select Start > Run. The Run dialog box opens.

Step 2 In the Open field, enter:

drive:\autorun.exe

where drive is the CD-ROM drive letter.


Note Campus is installed in the same location as CiscoWorks Common Services. The default is C:\Program Files\CSCOpx.


The Installer window opens.

Step 3 Click Install to continue or Cancel to stop.

If you click Install, the Welcome window opens.

Step 4 Click Next to continue.

The Software License Agreement window opens. To Install Campus Manager you must accept this agreement.

Step 5 Click Yes to continue.

The ANI Password window opens.

Step 6 Enter your ANI Password. Otherwise a random password is generated.

Step 7 Click Next to continue.

The System Requirements Window opens. Verify whether you have the minimum system requirements to install Campus Manager.

Step 8 Click Next to continue.

The Summary dialog box opens, displaying the target directory and program folder. The target directory is the directory in which you installed CiscoWorks Common Services.


Note Click the Show Details button in the Summary dialog box to view the ANI database password. Store the password in a secure location. You may need it for debugging.


Step 9 Click Next to continue.

After installation is complete 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.


Step 10 Click OK to continue.

The Setup Complete dialog box opens.

Step 11 Click Finish.

The CiscoWorks Server starts running.


If errors occurred during installation, check the installation log file in the root directory on the drive where the operating system is installed. The default is C:\Ciscoworks_setup002.log. Each installation creates a new installation log that is saved as a different file.

For example, the second time you install Campus, the installation log is saved as C:\Ciscoworks_setup003.log. The default installation log from the Common Services installation is C:\Ciscoworks_setup001.log. For other troubleshooting information, 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, refer to the "Understanding the Data Conversion" 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 "Converting Campus Data" section.

Performing an Upgrade Installation

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

Campus 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 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

Path Analysis 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.


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

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

You might see warnings that the target system is running out of disk space. You can chose to free space on the system and click Yes to continue, or click No to exit the installation.

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 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, 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 Insert the Campus CD-ROM into a CD-ROM drive.

The Installer window opens. Continue to Step 4.

Step 2 If the Installer window does not open, select Start > Run.

The Run dialog box opens.

Step 3 In the Open field, enter:

drive:\autorun.exe

where drive is the CD-ROM drive letter.


Note Campus is installed in the same location as CiscoWorks Common Services. The default is C:\Program Files\CSCOpx.


The Installer window opens. Continue to step 4.

Step 4 Click Install to continue or Cancel to stop.

If you click Install, the Welcome window opens.

Step 5 Click Next to continue.

The Software License Agreement window opens. To Install Campus Manager you must accept this agreement.

Step 6 Click Yes to continue.

The ANI Password window opens.

Step 7 Enter your ANI Password. Otherwise a random password is generated.

Step 8 Click Next to continue.

The System Requirements Window opens. Verify whether you have the minimum system requirements to install Campus Manager.

Step 9 Click Next to continue.

The Summary dialog box opens, displaying the target directory and program folder. The target directory is the directory in which you installed CiscoWorks Common Services.


Note The Show Details button appears in the Summary dialog box only if you entered a new password. Click the Show Details button to view the ANI database password. Store the password in a secure location. You may need it for debugging.


Step 10 Click Next to continue.

The installation program converts your database but does not remove the original database. The original database is preserved and remains until you manually remove it.

If there is not enough disk space in the location to convert and import the archived database, an information message appears. If you have data you want to save and upgrade but not enough disk space, do one of the following:

Free up enough disk space to be able to save and upgrade data, then continue with the installation process.

Install Common Services, and Campus on a different machine, then remotely import the data. Refer to the "Importing Data After Installation" section.

After installation is complete 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.


Step 11 Click OK to continue.

The Setup Complete dialog box opens.

Step 12 Click Finish.

The CiscoWorks Server starts running.


If errors occurred during installation, check the installation log file in the root directory on the drive where the operating system is installed. The default is C:\Ciscoworks_setup002.log. Each installation creates a new installation log that is saved as a different file.

For example, the second time you install Campus, the installation log is saved as C:\Ciscoworks_setup003.log. The default installation log from the Common Services installation is C:\Ciscoworks_setup001.log. For other troubleshooting information, see "Troubleshooting the Installation."

After the installation completes, choose either 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 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 into the new Campus Manager 3.3 format or directly use the default views generated by Campus Manager 3.3. See "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 previous versions of Campus Manager (3.1 and 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 in 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 exactly the same 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 can be converted from both Campus Manager 3.1 and Campus Manager 3.2 formats to Campus Manager 3.3 format.

Converting Campus Data

Campus Manger accesses the ANI database for critical network information. During an upgrade from Campus Manager 3.1 or 3.2 the database is saved. Data from the saved 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 Common Services install until you remove it.

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

Converting Campus 3.1 and 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 the earlier versions of Campus Manager (3.1 or 3.2). The following views are saved:

Layer 2 View

Unconnected Device View

LAN Edge View

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

Step 2 Insert the CiscoWorks Common Services 2.2 CD-ROM into the CD-ROM drive on the local machine.

The Installer window opens.

Step 3 Click Cancel.

Step 4 Select Start > Run.

The Run dialog box opens.

Step 5 To save CiscoWorks data, run:

NMSROOT/bin/perl drive:\ export_cdone.pl 

where drive is the CD-ROM drive letter. A prompt appears asking you to enter the location where you want to export CiscoWorks Common Services data.The default location is C:\PROGRA~1\CSCOpx\rigel

Step 6 Insert the Campus CD-ROM into the CD-ROM drive.

Step 7 To save Campus data, run:

NMSROOT/bin/perl drive:\ export_cm.pl

where drive is the CD-ROM drive letter. A prompt appears asking you to enter the location where you want to export Campus data.The default location is C:\PROGRA~1\CSCOpx\rigel.


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


Step 8 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 machine.

Step 9 Start the daemon manager on the local machine.

For more information, refer to Installation and Setup Guide for CiscoWorks Common Services on Windows.

Step 10 Stop the daemon manager on the remote machine.

For more information on stopping the daemon manager, refer to Installation and Setup Guide for CiscoWorks Common Services on Windows.

Step 11 To copy CiscoWorks data to corresponding Common Services 2.2 directories on the remote machine, enter:

cd /d NMSROOT\rigel\scripts
NMSROOT\bin\perl 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 12 Enter y to import and n to cancel.

Step 13 To copy Campus data to corresponding Campus Manager 3.3 directories on the remote machine, enter:

cd /d NMSROOT\rigel\scripts
NMSROOT\bin\perl 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 14 Enter y to import and n to cancel.

Step 15 Start the daemon manager on the remote machine. See Installation and Setup Guide for CiscoWorks Common Services on Windows for more information.

After the data is imported, 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. Uninstallation allows 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 try to remove Campus 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 or other major components:


Step 1 Select Start > Programs> CiscoWorks > Uninstall CiscoWorks.

The Uninstallation dialog box appears, displaying all of the installed components.

Step 2 Deselect the components you do not want to remove or click Uninstall All.

Step 3 Click Next to begin uninstalling Campus.

A dialog box opens, listing the components selected for uninstallation.

Step 4 Click Next after verifying the components to be uninstalled.

Messages about the uninstall process appear and the uninstallation finishes.


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