|
Table Of Contents
System Files Modified During Installation
Running the Installation Program—New Installation
Performing an Upgrade Installation
Running the Installation Program—Upgrade Installation
Installing CD One
This chapter consists of:
•Performing a New Installation
•Performing an Upgrade Installation
Installation Overview
Table 2-1 is an overview of CD One installation tasks. It contains references to more detailed information about each task.
Table 2-1 Installing CD One Task Overview
Task Steps ReferencesPrepare to install CD One.
1. Verify that server requirements are met.
2. Verify that client requirements are met.
3. Note TCP ports that CiscoWorks2000 uses and check for conflicts with existing applications.
Install server software.
Run installation program.
Verify and troubleshoot installation.
Analyze installation error messages.
"Troubleshooting the Installation" appendix, "Understanding Installation Messages" section
Preparing to Install CD One
Before you install CD One, make sure your server and client environments meet the hardware and software requirements described in the "Prerequisites" chapter.
Note Do not use DHCP running in dynamic mode on the CiscoWorks2000 Server.
Setting Environment Variables
Set the following environment variables for CiscoWorks2000 system administrators. These variables are not required for tasks that users perform from the desktop.
•Add /opt/CSCOpx/bin to the PATH variable in the .cshrc or .profile files of CD One users who have administrator privileges.
•Add /opt/CSCOpx/man to the MANPATH variable.
Using the Server IP Address
To avoid inconsistencies in how domain names are used in networks, CiscoWorks2000 uses the IP address of the server when it interacts with web browsers. By using this IP address, CiscoWorks2000 eliminates name lookup failures between the server and the client machines that run web browsers.
TCP and UDP Ports Used
In addition to the standard network ports, CD One uses the following TCP and UDP ports:
•42340/tcp (CiscoWorks2000 Daemon Manager, the tool that manages server processes)
•42341/tcp (Open Server Gateway)
•42342/udp (Osagent)
•42343/tcp (Jrun)
•1741/tcp (the default port for the CiscoWorks2000 HTTP server)
See the "Preparing to Use CD One"chapter for more information about accessing the server.
System Files Modified During Installation
The following system files are modified during CD One installation:
•/etc/services
•/etc/inetd.conf
•/etc/syslog.conf
•/var/sadm/install/admin/default
Performing a New Installation
The CD One installation program takes approximately 30 minutes to complete on a Solaris system with the minimum required hardware. This can extend to 1 hour if you perform network management integration during the installation process.
Running the Installation Program—New Installation
To run the installation program:
Step 1 As root, mount the CD One CD-ROM using either of the following methods:
•Mount the CD-ROM on the CD One server system.
•Mount the CD-ROM on a remote Solaris system, then access the
CD-ROM from the CD One server system.See the "Mounting and Unmounting on Solaris" appendix 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.shwhere remotedir is the remote location where the CD-ROM is mounted.
Note If you are upgrading from a previous version of CD One, go to Step 4.
A message displays:
Enter the location where the product will be installed or q to quit. Default location (PKGROOT)? [/opt/CSCOpx]
Note CD One requires a directory named /opt/CSCOpx. If you select a different installation directory, the /opt/CSCOpx directory will be created and will be a link to the directory you selected.
Step 3 Press Enter to accept the default directory for product installation, or enter a different directory.
Note If CD One has previously been installed on this machine, the product will automatically be installed in the same location CD One was previously installed.
The installation program performs several preinstallation checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen.
Step 4 Select one of the following:
Note If CD One has previously been installed on this machine, the list of components will be different.
•1) NMS Integration Utility to install only the Integration Utility
(For information about the Integration Utility and third party NMS integration, refer to Using CiscoView.)•2) Common Management Foundation (CMF) Base Desktop to install a subset of CMF
(Select this option only if the application you'll be installing next requires the CMF Base Desktop.)•3) Cisco View to install Cisco View and the CiscoWorks2000 Server support
•4) Typical Installation (all components) to install all CD One components
(Recommended for most systems)Step 5 Enter the number corresponding to the option you have chosen or q to quit.
Note If you selected options 2 or 3, go to Step 7.
Note For information about the Integration Utility, refer to Using CiscoView.
The installation program performs system checks and lists dependencies, then displays:
The Integration Utility will be installed now. The Integration Utility integrates Cisco device packages and Cisco applications into third-party SNMP management platforms. You can choose to integrate with a third-party SNMP management platform during this install or later.Do You want to integrate with the third-party product now (y/n)? [n]Step 6 Select one of the following:
•n to integrate with a third party NMS after installation
If you select n, go to Step 7.•y to integrate with a third party NMS during installation
If you select y, continue with steps a through c.a. Select the adapter from the list of available adapters, or select other to choose an adapter that is not listed (you will be prompted to enter the path name of the adapter), or select none to integrate after the installation is complete.
If you select none, go to Step 7.b. Enter the HTTP browser location, or press Enter to accept the default location, /usr/local/bin/netscape.
A message appears, asking if you want to enable download options from the Cisco Web page (CCO).
c. Select one of the following:
•n to not enable future upgrades from the Cisco Web page
•y to enable future upgrades from the Cisco Web page
Enter your CCO user ID and password.
Note You must have CCO login privileges. If you do not have a user account and password on CCO, contact your channel partner or enter a request on the standard CCO web site (www.cisco.com).
Step 7 After installation is complete, unmount the CD-ROM. See the "Mounting and Unmounting on Solaris" appendix for details.
If errors occurred during installation, check the installation log file /var/tmp/ciscoinstall.log. Each installation appends to this file. For troubleshooting information, see the "Troubleshooting the Installation" appendix.
Step 8 Prepare the client system for use. See the "Preparing to Use CD One" chapter.
Performing an Upgrade Installation
Upgrading from previous versions of CiscoWorks2000 (prior to CD One, 1st Edition) involves the following major steps:
Step 1 Install the required patches.
Step 2 Run the CD One installation program.
Note If you're upgrading from a previous version of CD One, see "Performing a New Installation" section.
Running the Installation Program—Upgrade Installation
During an upgrade from a previous version of CD One, the data is preserved. However, during an upgrade from previous CiscoWorks2000 applications (prior to CD One, 1st Edition), previous product versions are removed, but the database, ANI information, community strings, user and host information, and application-specific data files are preserved and will be restored during the new product version installations.
To upgrade from a previous version of CiscoWorks2000 (prior to CD One, 1st Edition):
Step 1 As root, mount the CD One CD-ROM using either of the following methods:
•Mount the CD-ROM on the CD One server system.
•Mount the CD-ROM on a remote Solaris system, then access the
CD-ROM from the CD One server system.See the "Mounting and Unmounting on Solaris" appendix 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.shwhere remotedir is the remote location where the CD-ROM is mounted.
The installation program performs several preinstallation checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen.
The CD One installation program detects any previous product versions installed on your system.
A message displays:
Do you want to proceed (y/n)? [y]Step 3 Enter y, then specify the path where the previous product data will be archived or press Enter to accept the default path, (/opt/CW2000/oldData).
The installation program copies database files and stores them in the location you specified.
A message displays:
The current product's data had been saved. Setup will now uninstall <product name>.Do you want to continue? (y/n) [y]
Note During an upgrade from a previous version of CD One, the data is preserved. However, during an upgrade from previous CiscoWorks2000 applications (prior to CD One, 1st Edition), previous product versions are removed, but the database, ANI information, community strings, user and host information, and application-specific data files are preserved and will be restored during the new product version installations.
Step 4 Select y to uninstall the previous product.
The installation program lists previous version packages, then asks for confirmation:
Delete all CiscoWorks2000 packages listed above (yes)?Step 5 Press Enter.
The CD One install script removes the previous product, saves data in the location you specified in Step 3, then displays:
Enter the location where the product will be installed or q to quit. Default location (PKGROOT)? [/opt/CSCOpx]
Step 6 Press Enter to accept the default directory for product installation, or enter a different directory.
The installation program performs several preinstallation checks on your machine, such as TCP/IP address resolution, TCP/IP port use, disk space, and RAM. These preinstallation checks cause some text to appear on the screen.
Step 7 Select one of the following:
•1) NMS Integration Utility to install only the Integration Utility
(For information about the Integration Utility and third party NMS integration, refer to Using CiscoView.)•2) Common Management Foundation (CMF) Base Desktop to install a subset of CMF
(Select this option only if the application you'll be installing next requires the CMF Base Desktop.)•3) Cisco View to install Cisco View and the CiscoWorks2000 Server support
•4) Typical Installation (all components) to install all CD One components
(Recommended for most systems)
Note If CD One has previously been installed on this machine, the product will automatically be installed in the same location CD One was previously installed.
Step 8 Enter the number corresponding to the option you have chosen or type q to quit.
Note If you selected options 2 or 3, go to Step 10.
The installation program performs system checks and lists dependencies, then displays:
The Integration Utility will be installed now. The Integration Utility integrates Cisco device packages and Cisco applications into a third-party SNMP management platform. You can choose to integrate with a third-party SNMP management platform during this install or later.Do You want to integrate with the third-party product now (y/n)? [n] y
Note For information about the Integration Utility, refer to Using CiscoView.
Step 9 Select one of the following:
•n to integrate with a third party NMS after installation
If you select n, go to Step 10.•y to integrate with a third party NMS during installation
If you select y, continue with steps a through ca. Select the adapter from the list of available adapters, or select other to choose an adapter that is not listed (you will be prompted to enter the path name of the adapter), or select none to integrate after the installation is complete.
If you select none, go to Step 10.b. Enter the HTTP browser location, or press Enter to accept the default location, /usr/local/bin/netscape.
A message appears, asking if you want to enable download options from the Cisco Web page (CCO).
c. Select one of the following:
•n to not enable future upgrades from the Cisco Web page
•y to enable future upgrades from the Cisco Web page
Enter your CCO user ID and password.
Note You must have CCO login privileges. If you do not have a user account and password on CCO, contact your channel partner or enter a request on the standard CCO web site (www.cisco.com).
Step 10 After installation is complete, unmount the CD-ROM. See the "Mounting and Unmounting on Solaris" appendix for details.
If errors occurred during installation, check the installation log file /var/tmp/ciscoinstall.log. Each installation appends to this file. For troubleshooting information or to verify the directories installed on your system, see the "Troubleshooting the Installation" appendix.
Step 11 Prepare the client system for use. See the "Preparing to Use CD One" chapter.
Removing CD One
Use the uninstall command to remove CD One files and settings.
Caution You must use the uninstall command to remove the product. If you try to remove CD One or its components manually, you can damage your system.
Step 1 As root, enter the following commands to start the uninstall script:
# cd /# /opt/CSCOpx/bin/uninstall.shwhere /opt/CSCOpx is the default installation directory.
A list of CiscoWorks2000 components appears.
Note When you remove CD One, 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.
Step 2 Enter the number corresponding to the option you have chosen or q to quit.
When the uninstall script is complete, a message displays:
All files were deleted successfully.Step 3 Check /etc/syslog.conf for syslog changes. Check /etc/services to ensure that port assignments for the Daemon Manager and web server have been removed.