|
|
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 the Windows NT Registry to determine 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 C:\Program Files\CSRC\conf folder. 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 C:\Program Files\CSRC folder. 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 C:\Program Files\CSRC folder. 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 installer uses the parameter values stored in the csrc.cfg file and in the Windows NT Registry to upgrade previously installed CSRC packages. The "CSRC Installation Worksheet" (see Figure 2-1) lists these parameters.
For information on upgrading CSRC from the CSRC distribution CD-ROM or from the CSRC electronic distribution image, see the "CSRC Installation from 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 CSRC versions 1.0(1) or lower did. To upgrade CSRC to version 1.0(2) from 1.0(1) or lower, Cisco recommends that you first remove the NAS using the NAS uninstallation program.
To uninstall NAS, do the following:
Step 1 Open the Control Panel by clicking Start on the taskbar and selecting Settings and Control Panel.
Step 2 In the Control Panel window, double-click Add/Remove Programs.
Step 3 In the Add/Remove Programs Properties window, scroll down the list of programs until you locate the Netscape Application Server 2.1. Select the program.
Step 4 Click the Add/Remove... button.
Step 5 Click Yes in the message that appears to confirm that you do want to remove the program.
Are you sure you want to completely remove the selected application and all of its components?
Step 6 Follow the uninstallation program until the program completes. Be sure you do the following:
Remove Shared File?
Shut down your computer?
Step 7 Do the following to manually delete the remaining NAS files:
Step 8 Restart your computer to ensure that the NAS uninstallation is complete.
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 package. You must upgrade this package before you upgrade any of the other CSRC packages (Web user interface, CNR integration, Utilities) if the LDAP Data package is installed on a host separate from the other CSRC packages.
To upgrade the LDAP Data package, do the following:
Step 1 Start the CSRC setup.exe program from the CSRC CD-ROM by doing the following:
(a) Insert the CD-ROM into the drive.
(b) Click Start on the taskbar and select Run.
(c) Click Browse, navigate to the CD-ROM drive (for example, D:\), and then to the CSRC\NT folder on the CD-ROM drive.
(d) Click the setup.exe program and then click Open.
(e) In the Run window, click OK to begin executing the setup program.
Step 2 In the Welcome window (see Figure 3-1), click Next to continue.
Step 3 In the Select upgrade mode window (see Figure 4-1), click the Upgrade installed components radio button to upgrade the LDAP Data package and then click Next to continue. The installer upgrades all previously installed components listed in the window. You must upgrade all components previously installed on the host.
Step 4 Click OK in the CSRC servers must be stopped window to indicate that you stopped the TFTP server (see the "Stop the TFTP Server" section).
Step 5 In the Start copying files window (see Figure 3-15), review the settings the installer found and click Next to begin installing the files.
As the upgrade installation continues, the installer checks for pre-existing CSRC data in the LDAP directory server database. If it finds the data, it does one of the following:
Step 6 Enter yes when the installer asks you if you want to install the conflicting files it found when it checked for conflicts with packages already installed.
Step 7 In the Upgrade information window, review the information about the upgrade installation and click Next to continue.
Step 8 In the Setup Complete window, click Finish to complete the upgrade installation.
Step 4 of the CSRC upgrade process is to restore the LDAP schema extensions. If you installed the LDAP Data package on a different host than the one on which you installed the remaining CSRC packages, you must restore LDAP schema extensions before you install the remaining 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 C:\Program Files\CSRC\conf folder 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 Do the following to stop the Netscape Directory Server (NDS) service when the csrc_schema_add.pl script asks you to do so:
Step 6 Restart NDS by following the directions in the previous step to select the NDS service in the list of services and then click Start.
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.
The installer upgrades all CSRC packages installed on a host. When you upgraded the LDAP Data package, the installer upgraded any other CSRC packages installed on that host. If you previously installed CSRC packages on other host(s), you must perform the following procedure to upgrade the remaining CSRC packages.
To upgrade the remaining CSRC packages on a host, do the following:
Step 1 Start the CSRC setup.exe program (see the "Upgrade the LDAP Data CSRC Package" section or the "CSRC Installation from the Electronic Distribution Image" section).
A progress bar displays in the Setup window as the installer prepares the upgrade wizard. The installer checks the Windows NT Registry for previously installed CSRC components and displays the Welcome window.
Step 2 In the Welcome window (see Figure 3-1), click Next to continue.
Step 3 In the Select upgrade mode window (see Figure 4-1), do one of the following and then click Next to continue. You must upgrade all previously installed components on a host.
Step 4 Click OK in the CSRC servers must be stopped window to indicate that you stopped the TFTP server (see the "Stop the TFTP Server" section).
Step 5 Click OK in the LDAP data must be upgraded window to indicate that you have already upgraded the LDAP Data package.
Step 6 In the CSRC License Key window (see Figure 3-4), enter the license key provided in the CSRC installation kit and then click Next. If you do not enter a license key, the installer installs a 30-day evaluation license key. The default is the license key you specified when you installed the previous version of CSRC.
Step 7 In the Start copying files window (see Figure 3-4), review the settings the installer found and click Next to begin installing the files.
As the upgrade installation continues, the installer checks for pre-existing CSRC data in the LDAP directory server database and either leaves the data intact or displays a message indicating that your LDAP data and schema have been upgraded for compatibility with CSRC version 1.0(2). It then provides information about adding your previous schema extensions to the upgraded schema.
Step 8 Enter yes when the installer asks you if you want to install the conflicting files it found when it checked for conflicts with packages already installed.
Step 9 In the Upgrade information window, review the information about the upgrade installation and click Next to continue.
Step 10 In the Setup Complete window, click Finish to complete the upgrade installation. If the Setup Complete window indicates that you must restart your computer, click the Yes or No radio button as appropriate and then click Finish.
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 C:\Program Files\CSRC folder 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 CSRC servers, do the following:
Step 1 Open the Control Panel and double-click Services.
Step 2 In the Services window (see Figure 3-18), select the appropriate service (CSRC Apache Web server, CSRC JRUN Servlet Engine) and click 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 Jan 17 08:07:11 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.