cc/td/doc/product/rtrmgmt/csrc/102/install
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Installing the Software Packages

Installing the Software Packages

This chapter provides installation-specific information you will need to install CNR and the CSRC software packages for the first time. If a previous version of CSRC is already installed and you want to upgrade to version 1.0(2), see "Upgrading CSRC."

A full installation of CSRC requires the following software packages to operate properly:

For information about installing the directory server, see "Netscape Directory Server."

What You Will Need

In addition to a copy of the "CSRC Installation Worksheet" (see Figure 2-1), Table 3-1 lists the software packages you need to complete a full installation of CSRC.


Table 3-1:
Software Package What You Need

Cisco Network Registrar (CNR)

CNR installation kit, included on the CSRC distribution media.

Getting Started with Network Registrar for CNR installation instructions.

LDAP directory server

LDAP directory server software.

Note For more information, see "Netscape Directory Server."

CSRC

CSRC software packages on the CSRC distribution media. For more information, see the "CSRC Installation" section.

CSRC license key, located in the CSRC installation kit.

Installing the Required Software Packages

Cisco Network Registrar Installation

Step 1 of the CSRC installation process is to install Cisco Network Registrar (CNR). The following sections describe the installation requirements for CNR and how to configure CNR for CSRC. Cisco recommends that you review these sections before you install CNR as described in the "Cisco Network Registrar Installation Procedure" section.

CNR Installation Requirements

All of the CSRC software packages require CNR version 3.0(1)T or higher version, except the LDAP data package. This package does not require CNR.

As you install CNR, be sure you do the following:

For more information about the CSRC software packages, see the "CSRC Installation" section.

Using the CSRC Installation Worksheet for CNR

As you install CNR, be sure to indicate the following information on the "CSRC Installation Worksheet" (see Figure 2-1):

What to Do if CNR is Already Installed

If you already have CNR installed, check the version number of the installed graphical user interface (GUI) and the CNR servers to ensure that they meet the CSRC requirement. To check the GUI version number, do the following:

Step 1 Start the CNR GUI by clicking Start on the taskbar and selecting Programs, Network Registrar version, and Network Registrar version again (where version is the version of Network Registrar currently installed).

Step 2 In the Help menu, select About Network Registrar. The version of CNR currently installed displays in a window.

To check the CNR servers version number, do the following:

Step 1 Open a DOS window by clicking Start on the taskbar and selecting Programs, then MS DOS Prompt.

Step 2 Enter the following command line to display the version number of the CNR servers. Be sure you enter the quotes indicated in the command line.

> "C:\Program Files\Network Registrar\BIN\dns" -v
 

The information that displays is similar to the following:

Copyright (C) 1994-1999 by Cisco Systems, Inc.
product: 3.0(2)T nightly build #140287
program: version 1; built 10/21/99@02:24 by aicbuild@build3
aiclib: version 1; built 10/21/99@02:15 by aicbuild@build3
mcdlib: version 1; built 10/21/99@02:15 by aicbuild@build3
mcddblib: version 1; built 10/21/99@02:15 by aicbuild@build3

Cisco Network Registrar Installation Procedure

The following procedure describes how to install Cisco Network Registrar (CNR). You must install the CNR graphical user interface component (GUI component) on the same host(s) as the CSRC Web user interface and Utilities packages. You must install the CNR servers component on the same host as the CSRC CNR integration package.

To install CNR, do the following:

Step 1 Insert the CNR CD-ROM into the drive.

Step 2 In the Explorer window, open the CD-ROM drive and double-click the CNR setup.exe program.

Step 3 Follow the CNR installer until installation completes. Be sure you do the following:

Step 4 Configure a cluster and set the CNR license key for that cluster. For more information, see the "What to Do After You Install CNR" section.

Step 5 Restart your system after installation completes.

What to Do After You Install CNR

After you install the proper version of CNR, you must configure at least one cluster and set the CNR license key for that cluster. If you do not do this before you begin installing the CSRC software packages, CSRC will not install successfully.

The CNR license key is located on the back of the CNR distribution media. You must enter the license key the first time you configure a cluster.


Note If you downloaded CNR, an evaluation license key is available on the CNR software download site.

To configure one cluster and set the license key, do the following:

Step 1 Start the CNR GUI by clicking Start on the taskbar and selecting Programs, Network Registrar version, then Network Registrar version again (where version is the version of CNR currently installed).

Step 2 From the Admin menu, select Clusters.

Step 3 In the Cluster dialog box, click Add Cluster.

Step 4 In the Add Cluster dialog box, enter the cluster name. The cluster name must be the name of the host on which the database runs. This is usually the name of the DNS server.

Step 5 Select the Connect to this cluster checkbox. You must connect to the cluster to set the license key.

Step 6 Click OK.

Step 7 In the Login for Cluster dialog box for that cluster, enter the username and password.

Step 8 Click OK.

Step 9 From the License dialog box, click New Key.

Step 10 From the Cluster Properties dialog box, select Edit License Key.

Step 11 Enter the 16-character license.

Step 12 Click OK.

For more information, see Getting Started with Network Registrar.

LDAP Directory Server Installation

Step 2 of the CSRC installation process is to install an LDAP version 3 compliant server, such as the Netscape Directory Server (NDS). For information about installing NDS, see "Netscape Directory Server" and the NDS documentation.

CSRC Installation

Step 3 of the CSRC installation process is to install the CSRC software packages. Table 3-2 lists the CSRC packages included on the CSRC distribution media. You can install each of these packages separately or all at once. You can choose to install the packages on the same host or on different hosts (see the "Installation Worksheet" section). Regardless of how many hosts you install the CSRC packages on, you must always install the LDAP Data package first. If you install the remaining packages on the same host, you must install them in the same order as they are listed in Table 3-2.

.
Table 3-2: CSRC Software Packages
Description Contents

LDAP data

The components that provide CSRC LDAP schema and initial data. You must install this package on the same host as the LDAP server to provide CSRC LDAP schema and sample data.

CNR integration

The components that enable the Cisco Network Registrar's TFTP server to interoperate with CSRC and to dynamically generate DOCSIS configuration files. You must install this package on the system on which the Cisco Network Registrar servers are installed. If, however, DNS is supported on a different host than DHCP, CNR integration is not required on the host supporting DNS.

Web user interface

The components that provide the Web-based user interface to CSRC. You must install this package on the system on which the CSRC Web server is running.

Utilities

The components that provide CSRC command-line utilities (for example, csrc_dbtool).

The following sections discuss the installation of the CSRC software packages.

CSRC Installation Requirements

You can install the CSRC packages on multiple hosts with different operating systems, based on the CSRC data center you design. The order in which you install the CSRC packages is important if you install the packages on the same host. You must install the CSRC packages in the following order:

You can select one or more packages to install. As you install the CSRC software packages, do the following:

If you install multiple CSRC packages on the same host, you only need to install the required software for each package once on that host. For example, the Web user interface and CSRC utilities packages each require that you install the CNR user interface on the host on which the package is installed. If you install the Web user interface and CSRC utilities packages on the same host, you only need to install the CNR user interface once on that host.

Using the CSRC Installation Worksheet for CSRC

The CSRC installer requires you to enter values that pertain to the installation of a previously installed required component (for example, the LDAP administrator password entered during the directory server installation). To ensure that you enter consistent values, refer to the appropriate boxes on the "CSRC Installation Worksheet" (see Figure 2-1) as you answer the CSRC installer's questions.

As you install CSRC, be sure to indicate the root distinguished name for CSRC data on the "CSRC Installation Worksheet" (box 11). This is the path in the directory server's hierarchy where CSRC data will be stored. The default is o=NetscapeRoot.

CSRC Installation from Distribution Media

You can install CSRC from the CSRC distribution CD-ROM. To do this, do the following:

Step 1 Insert the CD-ROM into the drive.

Step 2 Click Start on the taskbar and then select Run.

Step 3 Click Browse and navigate to the CD-ROM drive (for example, D:\).

Step 4 Navigate to the CSRC\NT folder on the CD-ROM drive and select the setup.exe program.

Step 5 Click Open.

Step 6 In the Run window, click OK to begin executing the setup.exe program.

CSRC Installation from the Electronic Distribution Image

You can also install CSRC from the CSRC electronic distribution image. To do this, do the following:

Step 1 Extract the files from the csrc_1_0_2-nt.exe archive file into a folder you specify. The default is C:\TEMP.

Step 2 Click Start on the taskbar and then select Run.

Step 3 Click Browse and navigate to the folder containing the CSRC files (for example, the C:\TEMP\csrc_1_0_2 folder).

Step 4 Select the setup.exe program and click Open.

Step 5 In the Run window, click OK to begin executing the setup.exe program.

Before You Begin Installing CSRC

Before you begin installing the CSRC software packages, you must confirm that the directory server is running. The directory server must be running for the LDAP data package to install correctly.

To confirm that the Netscape Directory Server (NDS) is running, 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 Services.

Step 3 In the list of services, locate the NDS service and check the status of the service in the Status column. Click Start if it is not running.

For more information, see the NDS documentation.

CSRC Software Package Installation Procedure

You must have administrative privileges when installing CSRC. The following procedure describes how to install the CSRC packages. The steps indicated in the procedure refer to the parameters listed on the "CSRC Installation Worksheet" (see Figure 2-1).

To install the CSRC packages, do the following:

Step 1 Start the CSRC installer from the CSRC CD-ROM or from the CSRC electronic distribution. For example, to install CSRC from the CD-ROM, do the following:

Step 2 Wait for CSRC Setup to finish preparing the wizard to guide you through the installation.

Step 3 In the Welcome window (see Figure 3-1), click Next to continue.


Figure 3-1: Welcome Window


Step 4 In the Choose Destination Location window (see Figure 3-2), select the folder to which you want the installer to copy the CSRC files by doing one of the following:


Figure 3-2: Choose Destination Location Window


Step 5 In the Select Components window (see Figure 3-3), select the name of the CSRC package(s) you want to install and click Next to continue. By default, all packages are selected.

To select or deselect a component, do the following:


Figure 3-3: Select Components Window


Step 6 In the Enter 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.


Figure 3-4: Enter CSRC License Key Window


Step 7 In the Enter LDAP directory window (see Figure 3-5), enter the full path of the folder in which you installed the LDAP directory server (box 5) and then click Next. For Netscape Directory Server, the folder is typically C:\Netscape\Server4. The default is the value (if it exists) in the UninstallString parameter in the following Windows NT registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\ Net Server Family 4.1

Figure 3-5: Enter LDAP directory Window


Step 8 In the Enter LDAP host window (see Figure 3-6), enter the name of the host on which the LDAP server is installed (box 6) and then click Next. The default is the value in the Hostname parameter in the following Windows NT registry key:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters

Figure 3-6: Enter LDAP host Window


Step 9 In the Enter LDAP server identifier window (see Figure 3-7), enter the LDAP server identifier (box 7) and click Next to continue. This is the unique identifier you specified when you installed the Netscape Directory Server (NDS). The default is the LDAP server host name you previously specified.


Figure 3-7:
Enter LDAP server identifier Window


Step 10 In the Enter LDAP port window (see Figure 3-8), enter the port number on which the LDAP server listens for queries (box 8) and click Next to continue. This is the server port you specified when you installed the Netscape Directory Server. The default is the value (if it exists) of the Port parameter in the slapd.conf file, located in the LDAP-server-root\slapd-identifier\config folder.


Figure 3-8:
Enter LDAP port Window


Step 11 In the Enter CSRC root DN window (see Figure 3-9), enter the root distinguished name (DN) for CSRC data (box 11) and click Next to continue. The root DN you specify must already exist. If it does not, you must create it before you install CSRC. The default for the Netscape Directory Server is o=NetscapeRoot.

To prevent CSRC data from conflicting with the data of other applications, a specific location is allocated in the directory server's hierarchy for CSRC data. The root DN for CSRC data is the path to this location. If you specify a DN that does not contain the substring o=, the installer prompts you again for the information.

For example, you can enter a DN, such as o=yourcompany.com, or you can enter a more detailed DN, such as ou=csrc,o=yourcompany.com.

The installer prepends csrcprogramname=csrc, (including the trailing comma) to the DN you enter.


Figure 3-9:
Enter CSRC root DN Window


Step 12 In the Enter LDAP administrator ID window (see Figure 3-10), enter the administrator ID for the LDAP directory server (box 9) and click Next to continue. This is the configuration folder administrator ID you specified when you installed the Netscape Directory Server. The default is admin.


Figure 3-10: Enter LDAP administrator ID Window


Step 13 In the Enter LDAP administrator password window (see Figure 3-11), enter the unique password (box 10) for the directory server administrator ID you specified in the previous step and then click Next to continue. You must identically enter the password in both the Password and Again fields. If you do not, the installer prompts you for the information again.


Figure 3-11: Enter LDAP administrator password Window


Step 14 In the Enter CNR host name window (see Figure 3-12), enter the name of the host on which you installed the CNR servers (box 1) and click Next to continue. This is the name of the host on which the TFTP server is running. The default is the name of the current host (the host on which you are running the installation).


Figure 3-12:
Enter CNR host name Window


Step 15 In the Enter CNR user name window (see Figure 3-13), enter the username for the CNR administrator who has access to the CNR database (box 2) and click Next to continue. The default is admin.


Figure 3-13:
Enter CNR user name Window


Step 16 In the Enter CNR administrator password window (see Figure 3-14), enter the password (box 3) for the administrator you specified in the previous step and click Next to continue. You must identically enter the password in both the Password and Again fields. If you do not, the installer prompts you for the information again.


Figure 3-14: Enter CNR administrator password Window


Step 17 In the Start copying files window (see Figure 3-15), review the settings you specified and do one of the following:


Figure 3-15: Start copying files Window


The installer does the following:

If the installer fails to perform a step, it terminates the installation. If this occurs, the installer does not remove the files previously copied from the distribution media to the target folder.

After the installer successfully installs the CSRC components, it displays the Setup Complete window. If the installer determines that you must restart Windows NT (for example, you installed the Web user interface and/or the Utilities components), the Setup Complete window contains information about restarting your computer (see Figure 3-16). You can choose to restart your computer immediately or at a later time by clicking the Yes or No radio button, and then Finish.

If the Startup Complete window, does not instruct you to restart your computer, click Finish to complete setup.


Figure 3-16: Setup Complete Window


Installing and Starting the Time-of-Day Server

Step 4 of the installation process is to install and start the Time-of-Day server if you are using a host running Windows NT as your time server and the host does not already have a time server installed. The broadband modems CSRC provisions must have access to a time server to determine the current time.

A host on the network must be running the time server. Windows NT does not have a time server built into it. If you want to use a host running Windows NT as your time server, you must intall the Time-of-Day server provided in the CSRC Utilities package.

To determine if a Windows NT host has a time server installed, do the following:

Step 1 Open an MS-DOS window by clicking Start on the taskbar and selecting Programs, then MS-DOS Prompt.

Step 2 Enter the following command:

 > telnet hostname 37 
 

where hostname is the server hostname.

The following message indicates that the host is running a time server:

Connection to host lost
 

The following message indicates that the host is not running a time server:

Connect Failed!
 

To install the Time-of-Day Server as an NT service, do the following. The Time-of-Day Server installs into the C:\Program Files\CSRC folder.


Note If you installed CSRC in a folder other than C:\Program Files\CSRC, install the Time-of-Day Server into the CSRC installation folder.

Step 1 Open an MS-DOS window by clicking Start on the taskbar and selecting Programs, then MS-DOS Prompt.

Step 2 Enter the following command line to install the Time-of-Day Server. Be sure you enter the quotes indicated in the command line.

> "C:\Program Files\CSRC\bin\csrctime" /i
 

To start the Time-of-Day Server, do the following:

Step 1 Open the Control Panel window by clicking Start on the taskbar and selecting Settings and Control Panel.

Step 2 In the Control Panel window, double-click Services.

Step 3 In the Services window (see Figure 3-17), select the Time Server service and click Start.


Figure 3-17: Services Window (Time Server Service)


Uninstalling the Time-of-Day Server Service

To uninstall the Time-of-Day Server as a Windows NT service, do the following:

Step 1 Stop the Time-of-Day Server by doing the following:

Step 2 Open an MS-DOS window by clicking Start on the taskbar and selecting Programs, then MS-DOS Prompt.

Step 3 Enter the following command line to uninstall the Time-of-Day Server. Be sure you enter the quotes indicated in the command line.

> "C:\Program Files\CSRC\bin\csrctime" /u

Start the CSRC Servers and the TFTP Server

Step 5 of the installation process is to start the CSRC servers (JRUN and Apache Web server) and the TFTP server. The CSRC installer automatically installs the JRUN and Apache servers during CSRC installation.

When you restart your computer, the CSRC servers automatically start. The CSRC installer prompts you to restart your computer if you install the CSRC Web user interface and/or the Utilities components. You can choose to restart your computer immediately or at a later time (see Figure 3-16 Setup Complete Window).

To start the CSRC servers manually, do the following:

Step 1 Open the Control Panel by clicking Start on the taskbar and then selecting Settings and Control Panel.

Step 2 In the Control Panel window, double-click Services.

Step 3 In the Services window (see Figure 3-18), select the CSRC Apache Web Server service and click Start.

Step 4 In the Services window, select the CSRC JRUN Servlet Engine service and click Start.


Figure 3-18: Services Window (JRUN and Apache Services)


To start the TFTP server from the nrcmd command line interface and to enable the server to start up automatically when the server is restarted, enter the following commands:

nrcmd> tftp start
nrcmd> tftp enable start-on-reboot
 

For more information about the nrcmd command line interface, see the Network Registrar CLI Reference Guide.

Verify the CSRC Installation

Step 6 of the installation process is to verify the CSRC installation. Use the following procedures to verify that the User Registrar Administrator and Modem Registrar applications are working properly. In these procedures, you create a new administrator using User Registrar and you remove the administrator using Modem Registrar.

Verifying User Registrar Administrator

To verify the User Registrar Administrator application, do the following:

Step 1 Start your browser and enter the following URL to open the CSRC Welcome page:

http://hostname/csrc/admin.html  
 

where hostname is the host on which you installed the Web user interface.

Step 2 On the CSRC Welcome page, click the following hypertext link to open the Administrator Login to User Registrar page (see Figure 3-19):

Log in to User Registrar Administrator
 

Figure 3-19: Administrator Login to User Registrar Page


Step 3 Enter the following default administrator username and password in the Username and Password fields.

Username    admin
Password    changeme
 

Step 4 Click Login. The User Registrar Home page (see Figure 3-20) appears.


Figure 3-20: Home Page


Step 5 On the Home Page, click Administrators. The Manage Administrators page (see Figure 3-21) appears.


Figure 3-21: Manage Administrators Page


Step 6 On the Manage Administrators page, click Add Administrator. The Add Administrator page (see Figure 3-22) appears.


Figure 3-22: Add Administrator Page


Step 7 On the Add Administrator page, enter the following username in the Administrator username field:

Administrator username: testuser
 

Step 8 Enter the following password in the Administrator password and Confirm password fields:

Administrator password: 1234
Confirm password: 1234
 

Step 9 Select all of the Administrator privileges checkboxes.

Step 10 Click Add Administrator. The Confirm Addition of Administrator page
(see
Figure 3-23) appears.


Figure 3-23: Confirm Addition of Administrator Page


Step 11 On the Confirm Addition of Adminstrator page, click Add Administrator to add the new administrator. The Manage Administrators page (see Figure 3-21) appears.

Step 12 On the Manage Administrators page, enter testuser in the Username field and click Search to display the new administrator and verify that the administrator was added.

Step 13 Click Logout. The Administrator Logout from User Registrar page
(see
Figure 3-24) appears.


Figure 3-24: Administrator Logout from User Registrar Page


Step 14 On the Administrator Logout from User Registrar page, click Logout again to exit from the User Registrar Administrator application. The Administrator Login to User Registrar page (see Figure 3-19) appears.

Verifying Modem Registrar

To verify the Modem Registrar application, do the following:

Step 1 Enter the following URL in your browser to open the CSRC Welcome page:

http://hostname/CSRC/admin.html  
 

where hostname is the actual name of the host on which the admin.html file is stored.

Step 2 On the CSRC Welcome page, click the following hypertext link to open the Modem Registrar Login (see Figure 3-25) page:

Log in to Modem Registrar
 

Figure 3-25: Login Page


Step 3 On the Login page, enter the following username and password in the Username and Password fields:

Username: testuser
Password: 1234
 

Step 4 Click Login. The Main Menu page (see Figure 3-26) appears.


Figure 3-26: Main Menu Page


Step 5 On the Main Menu page, click Administrators. The Manage Administrators page (see Figure 3-27) appears.


Figure 3-27: Manage Administrators Page


Step 6 On the Manage Administrators page, enter testuser in the Username field and click Search to list the administrator you previously added using User Registrar.

Step 7 Locate the testuser username in the list of currently defined administrators and click Delete for that administrator. The Confirm Deletion of Administrator page (see Figure 3-28) appears.


Figure 3-28: Confirm Deletion of Administrator Page


Step 8 On the Confirm Deletion of Administrator page, click Delete to remove the testuser administrator.

Step 9 On the Manage Administrators page (see Figure 3-27), click Logout to exit the Modem Registrar application.

Configure Your Network for CSRC

Step 7 of the CSRC installation process is to configure your cable network for CSRC before you begin using the software. The following sections discuss example configurations for setting up Cisco Network Registrar and the uBR IOS and describe how to change the encoded passwords in the csrc.cfg file.

Setting Up Cisco Network Registrar

The CSRC distribution media contains a Perl script and companion files that you can use to set up Cisco Network Registrar (CNR) for operation with CSRC. The
C:\Program Files\CSRC\conf folder on the CSRC distribution media contains the following components:

For more information, see the following guides:

Setting the CNR License Key

Before you run the cnrConfig.pl script, you must set the CNR license key, using the following command syntax in the nrcmd program. For more information about the nrcmd program, see the Network Registrar CLI Reference Guide.

license set key=value
 

The CNR license key is located on the back of the CNR CD-ROM. If you downloaded CNR, an evaluation key is located on the CNR software download site.

To set the license key, you must run the nrcmd program in interactive mode. For example, to set the license key to 1234 abcd 5678 efgh, enter the following:

nrcmd -C cluster1 -N admin -P aicuser
nrcmd> license set key=1234-abcd-5678-efgh
100 Ok

The cnrConfig.pl Script

The cnrConfig.pl script is used to configure CNR for use in a CSRC installation. The script has the following syntax:

#	 perl cnrConfig.pl [-dxk] [-f cnrCfgTemplate] [-O qryOutput] [-I qryInput]
 

where:

-d indicates to run in debug mode and to write program trace information to stdout.

-x creates the nrcmd batch file, but does not execute it. This option indicates on stdout what the batch command line would have been had it been executed.

-k saves the generated cnrConfig.cmd file. By default, this file is deleted after the nrcmd command executes since it contains plain text password information.

-f cnrCfgTemplate indicates the path to the cnrConfig.tmpl template file. By default, the cnrConfig.pl script assumes the cnrConfig.tmpl file resides in the current folder.

-O qryOutput indicates to write the CNR configuration information you specify interactively to the file specified in qryOutput.

-I qryInput indicates to read needed information from the file specified in qryInput instead of querying you interactively for the information.


Note For more information about the cnrConfig.pl script options, see the following sections.

-f cnrCfgTemplate

The -f cnrCfgTemplate option indicates the path to the CNR configuration data template file. The cnrCfgTemplate argument must specify the path. The default is the cnrConfig.tmpl file in the current folder.

The generated and updated template file resides in the specified folder portion of the pathname or in the default folder location if this option is not specified. In all cases, the name of the generated CNR batch file is cnrConfig.cmd.

-O qryOutput

The -O qryOutput option writes the CNR configuration information you entered to the file specified in qryOutput. This allows you to subsequently execute the cnrConfig.pl script without requiring your input. It also provides a record of the nrcmd transaction. Cisco recommends that you execute the cnrConfig.pl script with the -O option specified if you intend to interactively provide answers to the script's questions.

You can choose to simply create a file manually instead of using the -O qryOutput option. If you do, you must provide the answers in the order in which the script asks the questions. For more information, see "The cnrConfig.pl Script Operation" section.

Caution The file you specify in qryOutput will contain plain text passwords. Be sure to protect the file after it is created.

-I qryInput

The -I qryInput option reads needed information from the file specified in qryInput instead of prompting you for it. You can create this file using the -O qryOutput option when you interactively execute the cnrConfig.pl script, or you can create the file manually.

If you create the qryInput file manually, you must provide the answers to the script's questions in the following format:

The following are examples of valid tokens:

validToken

# valid data and comment

"Good Value"

# quoted valid white space

"C:\A Good\Value Combo\"

# quoted valid white space

1.2.3.4.5.6.7.8

# valid multi-valued data

The following are examples of invalid tokens:

Bad Value

# must quote tokens with valid white space

"C:\A Bad Value"

# invalid white space

C:\"Also Bad"

# must quote the entire token

The cnrConfig.pl Script Operation

The cnrConfig.pl script first prompts for the following information about your CSRC installation in the order specified:

You can choose to specify this information interactively or non-interactively using an input file. In interactive mode, you enter the needed information when the cnrConfig.pl script prompts you for it. You can enter ? to display a brief description of the desired information before you enter a value. After you finish entering the needed information, the cnrConfig.pl script displays all of the values you entered for your verification. You can then accept the values or abort the program, leaving CNR configuration unchanged.

In non-interactive mode, the cnrConfig.pl script reads the values for needed information from an input file. In this case, the cnrConfig.pl script does not allow you to verify the values or abort any changes to the CNR configuration. For more information, see the "-O qryOutput" section and the "-I qryInput" section.

After the cnrConfig.pl script gathers the needed information, it does the following:

    1. Parses the associated cnrConfig.tmpl template file (see the "The cnrConfig.tmpl Template File" section), replacing template tokens found in the cnrConfig.tmpl file with the associated values provided during the query phase.

    2. Generates a CNR batch file called cnrConfig.cmd. This file resides in the folder specified by the -f option. If the -f option is not specified, the file resides in the current folder. The cnrConfig.cmd file is deleted by default. Use the -k option to save it.

    3. Invokes the nrcmd command to run the CNR commands specified in the cnrConfig.cmd file.

    4. Redirects stdout to store the results of the batch nrcmd session in a file called cnrConfigResults.out. This file resides in the same folder as the cnrConfig.cmd file.

CnrConfig.pl Limitations

The cnrConfig.pl script has the following limitations:

The cnrConfig.tmpl Template File

The cnrConfig.tmpl template file is a companion file on which the cnrConfig.pl script operates. The cnrconfig.tmpl file is actually a collection of CNR (nrcmd) commands. The file contains template tokens with the following format:

<<keyword>>
 

where <<keyword>> is an exact match for the name field of one of the cnrData hash elements defined at the beginning of the cnrConfig.pl script. A template token must match the value of one of the hash entries in the script file. If not, the script displays an error message, indicating the template token in error and its line number in the cnrConfig.tmpl file. The cnrConfig.pl script then aborts.

You can modify the default cnrconfig.tmpl file as desired. However, if you modify, add, or delete token templates, then you must also make the associated modifications to the cnrData associative array in the cnrConfig.pl script and to the ordering of these hash nodes in the sortedData array, if necessary. For information about making these modifications, see the cnrConfig.pl script.

CnrConfig.tmpl Limitations

The cnrConfig.tmpl file has the following limitations:

For example, a library named libxxxxx.so is renamed xxxxx.dll on an Windows NT system.

uBR IOS Configuration

The CSRC distribution media contains an example configuration for the CableLab uBR. This example configuration is available in the ubr-config.txt file in the C:\Program Files\CSRC\conf folder on the distribution media.

Changing Passwords

The passwords stored in the csrc.cfg file are encoded. If you change the LDAP or Cisco Network Registrar (CNR) password for the account that CSRC uses, you must update the password in the csrc.cfg file on all CSRC server machines where it is present. To do this, you must first encode the password, using the csrcencode utility in the C:\Program Files\CSRC\bin folder.

Enter the following command line to encode a password. Be sure you enter the quotes indicated in the command line.

> "C:\Program Files\csrc\bin\csrcencode" password
 
    <encoded password>

where password is the password you want to encode and <encoded password> is the encoded password string that results from the command's execution.

After you encode the new password, you can copy the encoded password string and insert it into the csrc.cfg file in place of the previous password string.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Thu Aug 10 11:27:23 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.