|
|
This chapter describes how to upgrade your CSRC installation to version 1.0(1). The CSRC installer checks to see if you have a previous version of CSRC installed. If so, the installer does the following to upgrade your CSRC installation:
To upgrade CSRC to version 1.0(1), you will need the following:
To upgrade to CSRC version 1.0(1), you must do the following:
For more information, see the "Upgrade Process Summary" section.
The process used to upgrade CSRC involves upgrading the CSRC software packages and restoring previous schema and file modifications. 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 Stop the CSRC servers.
Step 2 Upgrade the LDAP data CSRC package.
Step 3 Restore LDAP schema extensions.
Step 4 Upgrade the remaining CSRC software packages.
Step 5 Restore file customizations for replaced files.
Step 6 Start the CSRC servers.
Step 7 Verify the installation.
Step 8 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 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 "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, do the following:
The following sections discuss how to upgrade to CSRC 1.0(1).
Step 1 of the CSRC upgrade process is to stop the CSRC servers.
To stop the Netscape Application Server (NAS), do the following:
Step 1 Enter the following command line to stop NAS:
# NASHOME/bin/KIVAes.sh stop
where NASHOME is the directory in which NAS is installed. For more information, see the "Before You Begin Installing CSRC" section.
Step 2 Enter the following command to confirm that NAS has indeed stopped:
# /usr/bin/ps -ef | grep -i nas
To stop the TFTP server from the nrcmd command line interface, enter the following command:
tftp stop
Step 2 of the CSRC upgrade process is to upgrade the LDAP data CSRC package: CSCOcsrcd.
You must upgrade CSRC as root. The following procedure describes how to upgrade the CSCOcsrcd package. You must upgrade this package before you upgrade any of the other CSRC packages (CSCOcsrcw, CSCOcsrcn, CSCOcsrcu). The steps in the procedure indicate the number of the box on the "CSRC Installation Worksheet" (see Figure 2-1) that contains the information requested.
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 Enter the following command to ensure that NAS is stopped:
# /usr/bin/ps -ef | grep -i nas
Step 3 To start the installer from the CD-ROM, enter the following command line:
# pkgadd -d /cdrom/csrc_1_0_1/CSRC/Solaris CSCOcsrcd
where 1_0_1 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 4 Enter yes at the following prompt to continue upgrading CSCOcsrcd:
Upgrade previously installed CSRC component? yes
A message appears indicating that you must stop the Netscape Application Server (NAS) and the Cisco Network Registrar (CNR) TFTP server.
Step 5 Enter yes at the following prompt if you stopped NAS and the TFTP server. If not, enter no or quit at the prompt and the upgrade installation terminates. The default answer is no.
Have the CSRC servers been stopped? yes
NAS must not be running when you install CSRC. The CSRC installer starts NAS at the appropriate time. You must stop NAS and verify that it has stopped before you install CSRC. For more information, see the "Step 1Stop the CSRC Servers" section.
Step 6 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 7 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 8 Continue following the installer's prompts. For more information, see the "CSRC Installation Procedure (first CSRC software package)" section, beginning with Step 5 of that procedure in which the installer displays the following prompt:
Enter pathname of Perl executable [/usr/bin/perl]:
As the upgrade installation continues, the installer might display the following message:
Checking for conflicts with packages already installed.
If 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 3 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 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'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 Stop the Netscape Application Server (NAS). To do this, enter the following command line:
# NASHOME/bin/KIVAes.sh stop
where NASHOME is the directory in which NAS is installed.
Enter the following command to confirm that NAS has indeed stopped:
# /usr/bin/ps -ef | grep -i nas
Step 7 Restart NDS.
Step 8 After you have upgraded the CSCOcsrcw package, restart NAS.
For more information about extending the CSRC schema, see the User Registrar User's Guide.
Step 4 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_1/CSRC/Solaris packages
where 1_0_1 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 NAS and the TFTP server. If not, enter no or quit at the prompt and the upgrade installation terminates. The default answer is no.
Have the CSRC servers been stopped? yes
NAS must not be running when you install CSRC. The CSRC installer starts NAS at the appropriate time. You must stop NAS and verify that it has stopped before you install CSRC. For more information, see the "Step 1Stop the CSRC Servers" section.
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 "Step 2Upgrade 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:
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.
As the installation continues, the installer might display the following message:
Checking for conflicts with packages already installed.
If 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
Step 8 Replace the index.html file with the ur-redirect.html file. For Apache Web servers, the index.html file is typically located in the /opt/csrc/apache/htdocs directory. The ur-redirect.html file is located in the /opt/csrc/html directory. Be sure to save the current index.html file. For more information, see the "What to Do After You Install the CSCOcsrcw Package" section.
Step 5 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 restoring your previous file customizations.
For more information, see the "Saving Previous File Modifications" section and the "The CSRC Installer Log File" section.
Step 6 of the upgrade process is to start the CSRC servers: the Netscape Application Server (NAS) and the Cisco Network Registrar TFTP server.
The CSRC installer automatically starts the NAS. However, you must start the TFTP server.
To start the TFTP server from the nrcmd command line interface, enter the following command:
tftp start
Step 7 of the upgrade process is to verify the installation. For more information, see the "Step 7Verifying the CSRC Installation" section.
Step 8 of the upgrade process is to configure your cable network for CSRC before you begin using the CSRC software. For more information, see "Configuring Your Network for CSRC."
Posted: Wed Oct 27 14:11:42 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.