Installation and Setup Guide for Campus Manager 4.0 on Solaris
Installing Campus Manager
Downloads: This chapterpdf (PDF - 251.0KB) The complete bookPDF (PDF - 0.98MB) | Feedback

Installing Campus Manager

Table Of Contents

Installing Campus Manager

Installation Overview

Performing a New Installation

Installation Notes

Licensing in Campus Manager

Running the Installation Program—New Installation

Performing an Upgrade Installation

Running the Installation Program—Upgrade

Running the Installation Program—Reinstall

Upgrading Saved Views From Topology Services

Restoring Data After Installation

Converting Campus Data

Converting Campus 3.2 or Campus 3.3 Data

Backing Up Data Manually from Campus Manager 3.2 or 3.3

Restoring Data Manually From Campus Manager 3.2 or 3.3

Restoring Data Using GUI From Campus Manager 3.2 or 3.3

Uninstalling Campus Manager


Installing Campus Manager


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

This chapter contains:

Installation Overview

Performing a New Installation

Performing an Upgrade Installation

Restoring Data After Installation

Uninstalling Campus Manager

Installation Overview

Table 2-1 is an overview of the Campus Manager 4.0 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.

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 4.0 installation. If you are upgrading from Campus Manager 3.2 or 3.3, see the "Performing an Upgrade Installation" section.

Installation Notes

You must install CiscoWorks Common Services 3.0 before installing Campus Manager 4.0. See Installation and Setup Guide for CiscoWorks Common Services 3.0 (Includes Ciscoview) on Solaris.

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

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 4.0 installer automatically updates Campus 3.3 and 3.2 program files and migrate user-entered data related to Campus 4.0.

After installation is complete, the installer re-applies some device updates previously released on Cisco's download site as Incremental Device Updates (IDU).

IDU 9.0 has been incorporated in Campus 4.0. But, to ensure that you retain the latest device support and bug fixes, please install the latest Incremental Device Update (IDU) for Campus Manager 4.0. You can download the latest IDU from

http://www.cisco.com/cgi-bin/tablebuild.pl/cw2000-campus

If you have installed IDU 4.0 or higher for Campus Manager 3.3, you must apply IDU 9.0 after the Campus Manager 4.0 installation is complete.

Licensing in Campus Manager

Licensing in Campus Manager is based on the number of devices managed by Campus Manager. You can purchase a restricted version to manage 300 or less number of devices and an unrestricted version to manage more than 300 devices.

Licenses should be installed during installation of a bundle or at a later time. When installing Campus Manager 4.0, you will be prompted to enter PIN and PAK or purchased license keys that you received along with the product.

You can also proceed with the installation without a PIN and PAK for an evaluation copy of Campus Manager 4.0.

When Campus Manager 4.0 is installed over Ciscoworks Common Services 3.0, the installer checks if PIN and PAK, or license file is already installed on the system. If not, the installer prompts you to enter PIN and PAK or locate path of the license file.

If PIN and PAK were entered during Campus Manager installation, you should provide path of the license file after Campus installation.

If you do not provide licence details, Campus Manager 4.0 evaluation licence will expire in 90 days after installation. You will be reminded to provide the license file.

For more information, see Appendix C, Licensing.

Running the Installation Program—New Installation

To install Campus Manager 4.0:


Step 1 As root, mount the Campus Manager 4.0 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 proceeding License Agreement? (y/n) 
[n]

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

or

Enter n to deny and stop the installation.

A message appears:

To ensure full use of the product features, please select one of the 
following:
(L) If you have a license file for this product,
you will then be prompted for the license file location.
(P) If you know only the PAK and PIN,
but have not obtained the license file.
(E) To evaluate the product only.
You can provide licensing information later if you want to fully 
enable the product.

Step 5 Enter L for License File, P for PAK and PIN, E for Evaluation, or Q to quit.

The installation program checks for compatible patches, dependencies, and disk space. The installation program prompts you to change the default password for the ANI database.

A message appears:

For security reasons,Cisco recommends that you change the default 
password for ANI database. Do you want to change it now? (y/n) [n] 

Step 6 Enter y to change your default ANI database password. Re-enter to confirm it.

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 Manager 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 4.0. You can download the latest IDU from
http://www.cisco.com/cgi-bin/tablebuild.pl/cw2000-campus. 

Please refer to the Installation and Setup Guide for details.

Step 7 The installation completes. CiscoWorks Server starts.



Note After installing Campus Manager 4.0, verify whether all processes are up and running. To verify, run #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 (3.2 or 3.3) to import into Campus Manager 4.0, see the "Restoring 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 "Converting Campus Data" section.

Performing an Upgrade Installation

You can directly upgrade to Campus Manager 4.0 from Campus Manager 3.3 and Campus Manager 3.2.

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

When you install Campus Manager 4.0, certain data from the previous database is converted to Campus Manager 4.0 format.

This data includes:

Seed devices.

SNMP community strings.

Discovery schedule.

Username and Notes fields in User Tracking.

User Tracking queries and layouts.

Path preferences.

Job schedule.

Topology groups.

You must upgrade to CiscoWorks Common Services 3.0 before installing or upgrading to Campus 4.0.

For more information about the ANI database, see the "Converting Campus Data" section.

For Installation Notes, see "Installation Notes" section

Running the Installation Program—Upgrade

Use this installation procedure to upgrade from Campus Manager 3.3 or 3.2 to Campus Manager 4.0.


Step 1 As root, mount the Campus Manager 4.0 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.

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

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) 
[n]

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

or

Enter n to deny and quit installation

You will be prompted to enter your licence information during installation.

A message appears:

To ensure full use of the product features, please select one of the 
following:
(L) If you have a license file for this product,
you will then be prompted for the license file location.
(P) If you know only the PAK and PIN,
but have not obtained the license file.
(E) To evaluate the product only.
You can provide licensing information later if you want to fully 
enable the product.

Step 5 Enter any of the following:

L for License File

P for PAK and PIN

E for Evaluation

Q to quit.

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

You are prompted to enter ANI database password.

Step 6 Enter your ANI database password. If you do not enter a new password, your default password is retained.

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. The packages for all devices that can be managed with Campus Manager 4.0 applications are installed. The ANI database is converted.



Note After installing Campus Manager 4.0, verify whether all processes are up and running. To verify, run #NMSROOT/bin pdshow


Any errors that occur during installation, appear on the screen. You can also 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 have installed Campus Manager 4.0 on a different system and have data to import, you can import the database remotely. See the "Restoring 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 Manager 4.0 is installed, Topology Services allows you to either convert the saved views in the new Campus Manager 4.0 format or directly use the default views generated by Campus Manager 4.0. See the "Upgrading Saved Views From Topology Services" section for more information.

Running the Installation Program—Reinstall

Use this installation procedure if you need to reinstall Campus Manager 4.0.

To run the reinstallation program:


Step 1 As root, mount the Campus Manager 4.0 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.

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 prompt appears:

Campus Manager 4.0 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. You are prompted to enter the ANI database password.

Step 4 Enter your ANI database password. If you do not enter a new password, your default password is retained.

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. The packages for all devices that can be managed with Campus Manager 4.0 applications are installed. The ANI database is converted.



Note After installing Campus Manager 4.0, verify whether all processes are up and running. To verify, run #NMSROOT/bin pdshow


After installing Campus Manager 4.0, 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 "Restoring Data After Installation" section.

After Campus Manager 4.0 is installed, Topology Services allows you to either convert the saved views in the new Campus Manager 4.0 format or directly use the default views generated by Campus Manager 4.0. 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 generated by the previous version of Campus Manager (3.2 or 3.3) to the new Campus Manager 4.0 format.


Step 1 Start Topology Services from the CiscoWorks Homepage.

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

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

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


Restoring Data After Installation

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

This section consists of:

Converting Campus Data

Converting Campus 3.2 or Campus 3.3 Data

Backing Up Data Manually from Campus Manager 3.2 or 3.3

Restoring Data Manually From Campus Manager 3.2 or 3.3

Restoring Data Using GUI From Campus Manager 3.2 or 3.3

Converting Campus Data

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

The CiscoWorks Common Services 3.0 installation, which is required for the Campus Manager 4.0 installation, automatically saves your old database. When you install Campus Manager 4.0, the saved database is imported into the new files, discoverysnmp.conf and datacollectionsnmp.conf files. After you import your database into Campus Manager 4.0, the old ANI database, called anisnmp.conf, remains in the default directory of CiscoWorks Common Services 3.0 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.2 or Campus 3.3 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 such as discovery.seed, discovery.subnets.include are updated in the new DeviceDiscovery.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 User Tracking discovery.

Topology Services saves topology views from previous versions of Campus Manager (3.2 or 3.3). The following views are saved:

Layer 2 View

Unconnected Device View

LAN Edge View

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

Backing Up Data Manually from Campus Manager 3.2 or 3.3

To back up saved data of Campus Manager 3.2 or 3.3:


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. Enter:

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

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

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

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


Restoring Data Manually From Campus Manager 3.2 or 3.3

To restore saved CiscoWorks data of Campus Manager 3.2 or 3.3 to corresponding Common Services 3.0 directories on the remote machine:


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 Restore CiscoWorks data. Enter:
NMSROOT/opt/CSCOpx/bin/perl /opt/CSCOpx/bin/restorebackup.pl -d /path

You should enter the path where you want to restore CiscoWorks Common Services data.

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


Restoring Data Using GUI From Campus Manager 3.2 or 3.3

Follow this procedure to restore saved CiscoWorks data of Campus Manager 3.2 or 3.3 using the graphical user interface.


Step 1 From the CiscoWorks Home page, click on Server Configuration.

A new window opens.

Step 2 Select Administration > Database Management > Backup Data Now.

Step 3 Specify the path where the data has to be stored and click Finish.


You can also schedule an automatic backup. For more information see Scheduling a Backup online help.

Uninstalling Campus Manager

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

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


Caution Uninstalling Campus Manager deletes the ANI database.

To remove Campus Manager 4.0 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 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
2) Integration Utility
3) CiscoWorks Common Services
4) Campus Manager
5) All of the above

Step 2 To uninstall Campus Manager, 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, 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: Campus Manager (y/n)? [n]

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.

If any other prompts appear, answer them appropriately.

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

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.