|
|
This chapter describes how to upgrade your CSRC installation to version 1.0(2). If you have not previously installed CSRC, see "Installing the Software Packages."
The CSRC installer checks to see if you have a previous version of CSRC installed and does the following to upgrade your CSRC installation:
To upgrade CSRC to version 1.0(2), you will need the following:
To upgrade to CSRC version 1.0(2), you must do the following:
For more information, see the "Upgrade Process Summary" section.
The process used to upgrade CSRC involves the following:
Cisco recommends that you first review the following upgrade process summary to familiarize yourself with the overall upgrade process. For more detailed information, see the appropriate sections in this guide.
The CSRC upgrade process consists of the following steps:
Step 1 Uninstall the Netscape Application Server.
Step 2 Stop the TFTP server.
Step 3 Upgrade the LDAP data CSRC package.
Step 4 Restore LDAP schema extensions.
Step 5 Upgrade the remaining CSRC software packages.
Step 6 Restore file customizations for replaced files.
Step 7 Start the CSRC servers and the TFTP server.
Step 8 Verify the installation.
Step 9 Configure your cable network for CSRC.
During the upgrade installation, the CSRC installer does not replace the existing csrc.cfg configuration file in the /opt/csrc/conf directory. If the installer adds or modifies parameters in the csrc.cfg file, a message appears indicating that the installer is updating the file.
After the CSRC installer finishes installing all of the CSRC files, it inserts the CSRC license key you specified into the license key parameter in the csrc.cfg file.
The CSRC installer copies the CSRC files from the distribution media to the /opt/csrc directory. During the upgrade process, the installer checks for an existing CSRC file before it installs a new file. The way in which the installer treats the existing file depends upon the file's category. The installer creates a log file called update.log.# to provide information about the files installed under the specific file categories. For more information, see the "CSRC Installer Log File" section.
The file categories are the following:
During the upgrade installation, the installer creates a log file if it upgraded previously installed CSRC components. The log file is called update.log.# (where # is a number that starts at one and increments as necessary) and it is located in the /opt/csrc directory. After the installation completes, the installer saves the update.log.# file on disk for later examination and it displays a message to refer you to the file.
The update.log.# file contains the following upgrade information:
The "CSRC Installation Worksheet" (see Figure 2-1) helps you to enter consistent parameter values as you upgrade the CSRC components. For more information, see the "Using the CSRC Installation Worksheet for CSRC" section.
For information on upgrading CSRC from the CSRC distribution CD-ROM or from the CSRC electronic distribution image, see the "CSRC Installation from the Distribution Media" section and the "CSRC Installation from the Electronic Distribution Image" section.
Before you begin upgrading the CSRC software packages, create a list of the CSRC files that you modified after you initially installed CSRC. Having this list will simplify the process of merging your previous file modifications into the newly installed CSRC files.
The following sections discuss the steps you must perform to upgrade to CSRC 1.0(2).
Step 1 of the CSRC upgrade process is to uninstall the Netscape Application Server (NAS). CSRC version 1.0(2) does not require the NAS as previous CSRC versions did. To upgrade CSRC to version 1.0(2), Cisco recommends that you first remove the NAS using the NAS uninstallation program.
To uninstall NAS, do the following:
Step 1 Open a new terminal window as root on your Solaris system.
Step 2 Enter the following command to change to the directory in which NAS is installed. For example, if NAS was installed in /usr/local/nas21, enter the following command:
# cd /usr/local/nas21
Step 3 Enter the following command to change to the bin directory:
# cd bin
Step 4 Enter the following command to start the uninstallation program and begin uninstalling NAS:
# ./remove.sh
Step 5 Follow the remaining prompts until NAS is completely removed. Be sure you do the following:
Do you want to contine? yes
Step 6 Do the following to manually delete the remaining NAS files:
# cd /usr/local
# rm -rf nas21
Step 2 of the CSRC upgrade process is to stop the TFTP server.
To stop the TFTP server from the nrcmd command line interface, enter the following command:
nrcmd> tftp stop
Step 3 of the CSRC upgrade process is to upgrade the LDAP data CSRC package: CSCOcsrcd. You must upgrade this package before you upgrade any of the other CSRC packages (CSCOcsrcw, CSCOcsrcn, CSCOcsrcu). You must upgrade CSRC as root.
To upgrade the CSCOcsrcd package on a host, do the following.
Step 1 Log in to your Solaris system as superuser or switch to superuser if you are logged in as a normal user.
Step 2 To start the installer from the CD-ROM, enter the following command line:
# pkgadd -d /cdrom/csrc_1_0_2/CSRC/Solaris CSCOcsrcd
where cdrom specifies the CD-ROM directory containing the CNR installer and 1_0_2 is the version number of CSRC.
The installer checks to see if the CSCOcsrcd package is already installed on your system and then displays the following message:
Version old-version of this component of Cisco Subscriber Registration Center (CSRC) is already installed. Do you wish to upgrade it? If not, this installation will be aborted.
Step 3 Enter yes at the following prompt to continue upgrading CSCOcsrcd:
Upgrade previously installed CSRC component? yes
Step 4 Enter yes at the following prompt if you stopped the TFTP server. If not, enter no or quit at the prompt and the upgrade installation terminates. The default answer is no.
Has the TFTP Server been stopped? yes
Step 5 Enter yes at the following prompt to continue upgrading CSCOcsrcd. If you enter no or quit, the upgrade installation terminates.
Continue with CSRC upgrade? yes
Step 6 Enter your CSRC license key at the following prompt:
Enter CSRC license key:
If you enter an invalid key, an error message appears and the prompt displays again.
If you do not specify a license key, the installer installs a thirty-day evaluation key.
Step 7 Continue following the installer's prompts. For more information, see the "First CSRC Software Package Installation Procedure" section, beginning with Step 5 of that procedure in which the installer displays the following prompt:
Enter the LDAP server installation root directory:
As the upgrade installation continues, the installer displays the following message:
Checking for conflicts with packages already installed.
When the installer finds files that are already installed on the system and that are being used by another package, the installer displays a list of the files it found. Enter yes when the installer asks you the following question:
Do you want to install these conflicting files [y,n,?,q] yes
If you enter yes, the installer installs the conflicting files and the installation continues.
If you enter no, the installer does not install the conflicting files and the installation continues.
If you enter ?, the installer displays help information.
If you enter quit, the installer terminates the installation.
Step 4 of the CSRC upgrade process is to restore the LDAP schema extensions. You must restore LDAP schema extensions before you install the remaining CSRC software packages. To do this, you execute the csrc_schema_add.pl script file in the /opt/csrc/conf directory on the csrc_schema_ext.dat LDAP data file, placing all of your previous cumulative additions into the new data file.
To restore your LDAP schema extensions in the Netscape Directory Server (NDS), do the following:
Step 1 Make a copy of your data and schema files, and store them in a safe place.
Step 2 Execute the csrc_schema_add.pl script file on the data file, adding your previously added schema extensions. This script is located in the /opt/csrc/conf directory and uses the following input parameters:
The csrc_schema_add.pl script creates additional data files.
Step 3 Enter yes when the csrc_schema_add.pl script asks the following question:
Do you want to install files to a permanent directory? yes
Step 4 Check the csrc_schema_add.pl script file's error messages to verify that the changes were successfully installed and integrated into the CSRC and NDS environments.
Step 5 Stop NDS when the csrc_schema_add.pl script asks you to do so. For more information, see the Netscape Directory Server documentation.
Step 6 Restart NDS.
For more information about extending the CSRC schema, see the User Registrar User's Guide.
Step 5 of the CSRC upgrade process is to upgrade the remaining CSRC software packages.
To upgrade the remaining CSRC packages on a host, do the following.
Step 1 Log in to your Solaris system as superuser or switch to superuser if you are logged in as a normal user.
Step 2 To start the installer from the CD-ROM and install the CSRC packages, enter the following command line:
# pkgadd -d /cdrom/csrc_1_0_2/CSRC/Solaris packages
where 1_0_2 is the version number of CSRC and packages is the identifier for the CSRC software package(s) you are installing.
The installer checks to see if the CSRC package is already installed on your system and then displays the following message:
Version old-version of this component of Cisco Subscriber Registration Center (CSRC) is already installed. Do you wish to upgrade it? If not, this installation will be aborted.
Step 3 Enter yes at the following prompt to continue upgrading the CSRC package:
Upgrade previously installed CSRC component? yes
Step 4 Enter yes at the following prompt if you stopped the TFTP server. If not, enter no or quit at the prompt and the upgrade installation terminates. The default answer is no.
Has the TFTP server been stopped? yes
Step 5 Enter yes at the following prompt if you upgraded the CSCOcsrcd package. If not, enter no or quit at the prompt and the upgrade installation terminates. The default answer is no.
Has the CSRC LDAP data been upgraded? yes
You must upgrade the CSCOcsrcd package before you upgrade other CSRC software packages. For more information, see the "Upgrade the LDAP Data CSRC Package" section.
Step 6 Enter yes at the following prompt to continue upgrading the CSRC package. If you enter no or quit, the upgrade installation terminates.
Continue with CSRC upgrade? yes
Step 7 Enter your CSRC license key at the following prompt. If you do not specify a license key, the installer installs a thirty-day evaluation key. If you enter an invalid key, an error message appears and the prompt displays again.
Enter CSRC license key:
Step 8 Continue following the installer's prompts. For more information, see the "First CSRC Software Package Installation Procedure" section, beginning with Step 5 of that procedure in which the installer displays the following prompt:
Enter the LDAP server installation root directory:
As the upgrade installation continues, the installer displays the following message:
Checking for conflicts with packages already installed.
When the installer finds files that are already installed on the system and that are being used by another package, the installer displays a list of the files it found. Enter yes when the installer asks you the following question:
Do you want to install these conflicting files [y,n,?,q] yes
If you enter yes, the installer installs the conflicting files and the installation continues.
If you enter no, the installer does not install the conflicting files and the installation continues.
If you enter ?, the installer displays help information.
If you enter quit, the installer terminates the installation.
Step 6 of the upgrade process is to restore file customizations for the files replaced during CSRC upgrade installation. The CSRC installer saves the modifications you made to the previously installed files. After you install the CSRC packages, a message appears instructing you to check the update.log.# log file in the /opt/csrc directory for information about merging your previous file customizations into the newly installed CSRC files. Refer to the list of files you compiled before you began upgrading CSRC.
For more information, see the "Saving Previous File Modifications" section and the "CSRC Installer Log File" section.
Step 7 of the upgrade process is to start the CSRC servers (JRUN and Apache Web server) and the Cisco Network Registrar TFTP server. The CSRC installer automatically installs the JRUN and Apache servers that CSRC requires to operate properly. You must manually start them.
To start the JRUN and Apache servers, enter the following command:
# /opt/csrc/bin/csrc_start
To start the TFTP server from the nrcmd command line interface, enter the following command:
nrcmd> tftp start
Step 8 of the upgrade process is to verify the installation. For more information, see the "Verify the CSRC Installation" section.
Step 9 of the upgrade process is to configure your cable network for CSRC before you begin using the CSRC software. For more information, see the "Configure Your Network for CSRC" section.
Posted: Mon Sep 25 12:36:15 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.