Installation and Setup Guide for Campus Manager 4.0.3 on Solaris (With LMS 2.5.1)
Chapter 2: Installing Campus Manager

Table Of Contents

Installing Campus Manager

Installation Overview

Installing Campus Manager 4.0.3

Licensing in Campus Manager 4.0.3

Installation Notes

Running the Installation Program

Reinstalling Campus Manager

Upgrading Saved View Layouts From Topology Services

Backing Up and Restoring Data After Installation

Backing Up Data Using GUI

Backing Up Data Manually From Campus Manager

Restoring Data Manually From Campus Manager

Uninstalling Campus Manager


Installing Campus Manager


This chapter describes how to install, uninstall, and reinstall Campus Manager 4.0.3.

You must install Common Services 3.0.3 before you can install
Campus Manager 4.0.3.

This chapter contains:

Installation Overview

Installing Campus Manager 4.0.3

Reinstalling Campus Manager

Backing Up and Restoring Data After Installation

Uninstalling Campus Manager

Installation Overview

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

Table 2-1 Installation Tasks 

Task
Steps
References

1. Prepare to install Campus Manager.

Verify that server requirements are met.

"Server Requirements" section

2. Install Campus Manager.

Run the installation program.

"Installing Campus Manager 4.0.3" section

3. Verify and troubleshoot installation.

a. Verify the correct files and directories are installed.

b. Analyze installation error messages.

"Understanding Installation Messages" section

4. Set up Campus Manager

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

Setting Up Campus Manager Applications


Installing Campus Manager 4.0.3

This section describes how to install Campus Manager 4.0.3. You must install CiscoWorks Common Services 3.0.3 before installing Campus Manager 4.0.3.

For information on installing CiscoWorks Common Services 3.0.3, see the Installation and Setup Guide for CiscoWorks Common Services 3.0.3 (Includes CiscoView) on Solaris.

Campus Manager gets installed in the same directory where you have installed CiscoWorks Common Services 3.0.3.

The Campus Manager 4.0.3 installer automatically updates program files and data from previous versions of Campus Manager .

All device updates up to Campus Manager 4.0 SP 2 have been incorporated in Campus Manager 4.0.3.

Licensing in Campus Manager 4.0.3

Campus Manager 4.0.3 uses the license of Campus Manager 4.0. If you have a licensed version of Campus Manager 4.0, you can install Campus Manager 4.0.3.

Campus Manager 4.0.3 emulates the licensing behavior of Campus Manager 4.0. For example, if the Campus Manager 4.0 license is restricted, Campus Manager 4.0.3 is also restricted.

For information on the licensing mechanism in Campus Manager 4.0, see Installation and Setup Guide for Campus Manager 4.0 on Solaris.

Installation Notes

If you have configured Common Services in ACS mode (Common Services > Server > Security > AAA Mode Setup), while installing RME 4.0.3, you are prompted with this message during installation:

CiscoWorks Server is in ACS mode
The application that you are installing requires new tasks to be 
registered with ACS. If you have already registered this application 
with ACS from another server, you do not need to register it again.
However if you re-register the application, you will lose any custom 
roles that you had created earlier for this application in ACS.
Enter (Y)es to Register, (N)o to continue without registering, (Q)uit 
: [N]


If you enter Y, Campus Manager 4.0.3 gets registered with ACS server.

If you enter N, Campus Manager 4.0.3 does not get registered with ACS server.

After the installation, you can register Campus Manager 4.0.3 with ACS server, using the script, AcsRegCli.pl:

/opt/CSCOpx/bin/perl /opt/CSCOpx/bin/AcsRegCli.pl -register rme

If you enter Q, Campus Manager 4.0.3 installation is aborted.

Running the Installation Program

To install Campus Manager 4.0.3:


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

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

Or

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.

Enter:

./setup.sh 

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 proceeding License Agreement? (y/n) 
[n]

If you are upgrading from Campus Manager 4.0, you will not see the license agreement.

Step 4 Enter y to accept the license and proceed with the installation.

Or

Enter n to deny and stop the installation.

If you select y, the following message appears:

For security reasons, Cisco recommends that you change the default 
password for ANI database.
Do you want to change it now, no is the default option.

Step 5 Enter y to change your default Campus Manager database password.

The following message appears:

Enter ANI database password:
Confirm password:

Step 6 Enter the password, and re-enter to confirm it.

The following message appears:

If no other CiscoWorks application installations are pending, you can 
choose to start CiscoWorks Daemons.
Do you want to restart CiscoWorks Daemons at the end of this 
installation?(y/n) [n]:

Step 7 Enter y to restart the CiscoWorks daemons after installation.

The following message appears:

Exiting installation beyond this point might result in system 
instability.
Do you want to continue the installation? (y/n) [y]:

Step 8 Enter y to continue the installation.

The installation program displays 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 Manager applications. The following message appears:

To ensure that you retain the latest device support and bug fixes, 
please install the latest Service Pack (SP) for Campus Manager 4.0.3

You can download the latest SP from 
http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-campus.
Please refer to the Installation and Setup Guide for details.

User Tracking Utility 1.0 is not compatible with Campus Manager 4.0.3
User Tracking Utility 1.1.1 is available for Campus Manager 4.0.3.
You can download the latest UTU from 
http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-campus-crypto.

The installation completes.


After installing Campus Manager 4.0.3, you can verify the process status by running NMSROOT/bin pdshow

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 to import into Campus Manager 4.0.3, see the "Backing Up and Restoring Data After Installation" section.

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

After Campus Manager 4.0.3 is installed, Topology Services allows you to either convert the saved view layouts in the new Campus Manager 4.0.3 format or directly use the default view layouts generated by Campus Manager 4.0.3. See the "Upgrading Saved View Layouts From Topology Services" section for more information.

Reinstalling Campus Manager

If you had any problems with previous installation, you can reinstall Campus Manager.

To run the reinstallation program:


Step 1 As root, mount the Campus Manager 4.0.3 CD-ROM. You can either:

Mount the CD-ROM on the CiscoWorks server system.

Or

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.

Enter:

./setup.sh 

A prompt appears:

Campus Manager 4.0.3 has been detected on your system. Are you sure 
you want to reinstall? (y/n)? [n]

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

If you select y, the following message appears:

For security reasons, Cisco recommends that you change the default 
password for ANI database.
Do you want to change it now, no is the default option.

Step 4 Enter y to change your default Campus Manager database password.

The following message appears:

Enter ANI database password:

Step 5 Enter the password, and re-enter to confirm it.

The installation program displays 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 Manager applications.

The following message appears:

To ensure that you retain the latest device support and bug fixes, 
please install the latest Service Pack (SP) for Campus Manager 4.0.3.
You can download the latest SP from 
http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-campus.
Please refer to the Installation and Setup Guide for details.

User Tracking Utility 1.0 is not compatible with Campus Manager 4.0.3
User Tracking Utility 1.1.1 is available for Campus Manager 4.0.3.
You can download the latest UTU from 
http://www.cisco.com/pcgi-bin/tablebuild.pl/cw2000-campus-crypto.
Please refer to the Installation and Setup Guide for details

The re-installation completes.


After installing Campus Manager 4.0.3, you can verify the process status by running NMSROOT/bin pdshow

After installing Campus Manager 4.0.3, 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 "Backing Up and Restoring Data After Installation" section.

After Campus Manager 4.0.3 is installed, Topology Services allows you to either convert the saved view layouts in the new Campus Manager 4.0.3 format or directly use the default view layouts generated by Campus Manager 4.0.3. See the "Upgrading Saved View Layouts From Topology Services" section for more information.

Upgrading Saved View Layouts From Topology Services

Use the following procedure to upgrade saved topology view layouts generated by the previous version of Campus Manager to the new Campus Manager 4.0.3 format. The following view layouts are upgraded:

Layer 2 View

Unconnected Device View

LAN Edge View

To upgrade saved view layouts:


Step 1 Start Topology Services. (Campus Manager > Topology Services)

Step 2 Select File > Upgrade View Layouts.

Step 3 Select the view layout you want to upgrade.

Step 4 Click Upgrade to upgrade the selected view layout.

Topology Services upgrades the selected view layout to the Campus Manager 4.0.3 format.

Step 5 Select the corresponding view layout from the side panel in Topology Services to display this layout.

The upgraded view layout might not be formatted in exactly the same as the previous version of the view layout.


Backing Up and Restoring Data After Installation

This section describes how to back up and restore data from previous versions of Campus Manager. You can back up and restore data from:

Campus Manager 3.2.x

Campus Manager 3.3.x

Campus Manager 4.0

Campus Manager 4.0 Service Pack 1

Campus Manager 4.0 Service Pack 2

where .x refers to the IDU upgrades.

This section consists of:

Backing Up Data Using GUI

Backing Up Data Manually From Campus Manager

Restoring Data Manually From Campus Manager

Backing Up Data Using GUI

You can schedule immediate, daily, weekly, or monthly automatic database backups.

To back up data:


Step 1 In the CiscoWorks Homepage, select Common Services > Server > Admin > Backup.

The Backup page appears.

Step 2 Enter the appropriate information in the following fields:

Table 2-2 Backing Up Data

Field

Description

Backup Directory

Location of the backup directory. We recommend that your target location be on a different partition than the CiscoWorks installation location.

Runtype

Select the desired check box. You have options to schedule immediate, daily, weekly, or monthly backups.

Time

From the drop-down lists, select the time and date.

If you schedule a weekly backup, select the day of the week from the drop-down list.

If you schedule a monthly backup, select the day of the month from the drop-down list.

Generations

Maximum number of backups to be stored in the backup directory.


Step 3 Click Apply.


Backing Up Data Manually From Campus Manager

To manually back up saved data in earlier versions of Campus Manager:


Step 1 Stop the daemon manager on the local machine on which the previous version of Campus Manager is installed. Enter:
/etc/init.d/dmgtd stop

Step 2 Export CiscoWorks data by entering:

NMSROOT/bin/perl NMSROOT/bin/backup.pl -d /backup dir

You should enter the path where you want to export CiscoWorks Common Services data. The script command will back up the CiscoWorks data.

Step 3 Start the daemon manager by entering:
/etc/init.d/dmgtd start

Step 4 Copy the backed up directory to the remote machine.


Restoring Data Manually From Campus Manager

To restore data manually:


Step 1 Stop the daemon manager on the local machine on which the previous version of Campus Manager is installed by entering:
/etc/init.d/dmgtd stop

Step 2 Restore CiscoWorks data by entering:
NMSROOT/opt/CSCOpx/bin/perl /opt/CSCOpx/bin/restorebackup.pl -d /backup dir

You should enter the path where you want the data to be restored.

Step 3 Start the daemon manager by entering:
NMSROOT /etc/init.d/dmgtd start


Uninstalling Campus Manager

The uninstallation program removes Campus Manager 4.0.3 files and settings. The uninstall option enables you to remove only Campus Manager 4.0.3 or remove CiscoWorks Common Services 3.0.3 as well.

You must use the Campus Manager 4.0.3 uninstallation program to remove the product. You could damage your system, if you attempt to remove
Campus Manager Manager 4.0.3 or its components manually.


Caution Uninstalling Campus Manager deletes the Campus Manager database.

To remove Campus Manager Manager 4.0.3 or other major components:


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

# /opt/CSCOpx/bin/uninstall.sh

where /opt/CSCOpx is the default installation directory. If you have specified a different directory while installing CiscoWorks Common Services, substitute the name of the directory.

A prompt similar to the following appears:

1) Cisco View 6.1.2
2) Integration Utility 1.6
3) CiscoWorks Common Services 3.0.3
4) Campus Manager 4.0.3
5) All of the above

Select one or more of the items using its number separated by comma or 
enter q to quit [q]

Step 2 Enter the number that corresponds to it (in this case, 4).

You can select one or more of the items using its number separated by comma or enter q to quit.

To remove Campus Manager, CiscoWorks Common Services, CiscoView 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: Campus Manager 4.0.3 (y/n)? [n]

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

If any other prompts appear, respond appropriately.

The uninstallation program displays a series of messages. Ignore any additional messages that ask if you want to remove packages.

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.