|
|
After you install the software packages required for CSRC to work properly, you are ready to install the CSRC components.
Table 4-1 lists the CSRC software 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 CSCOcsrcd 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 4-1.
This chapter first provides background information you need to know about installing the CSRC packages. It then describes how to install the CSRC software packages, verify the installation, and references "Configuring Your Network for CSRC" for information on integrating CSRC into your cable network.
The following sections describe installation requirements and how to install CSRC.
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 specify one or more packages on the pkgadd command line; however, when specifying multiple packages you must enter the packages on the command line in the order specified above.
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 CSCOcsrcn and CSCOcsrcw packages each require that you install Perl on the host on which the package is installed. If you install CSCOcsrcn and CSCOcsrcw on the same host, you only need to install Perl once on that host.
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 20). This is the path in the directory server's hierarchy where CSRC data will be stored. The default is o=NetscapeRoot.
You can install CSRC from the CSRC distribution CD-ROM. To do this, the command line has the following syntax:
pkgadd -d /cdrom/csrc_1_0_1/CSRC/Solaris [-r response-file] [packages]
You can also install CSRC from the CSRC electronic distribution image. To do this, you must unpack the distribution image into a directory and then specify that directory in the command line. For example, if you unpack the distribution image into the /opt/CSRCdist directory, the command line has the following syntax:
pkgadd -d /opt/CSRCdist/csrc_1_0_1/CSRC/Solaris [-r response-file] [packages]
Before you begin installing the CSRC software packages, you must confirm that the directory server is running and that the Netscape Application Server (NAS) can start without loading errors.
The directory server must be running for the CSCOcsrcd software package to install correctly. To confirm that the Netscape Directory Server (NDS) is running, see the NDS documentation.
To confirm that NAS can start without loading errors, do the following:
Step 1 Enter the following command to determine if NAS is already started:
# /usr/bin/ps -ef | grep -i nas
Step 2 If NAS is started, check the log files (particularly the kjs_1_CCSO log file) to ensure that the NAS internal processes and extension services registered and loaded properly.
If NAS is not started, enter the following command to start it and check the log files to ensure that NAS started without loading errors.
# NASHOME/bin/KIVAes.sh start
where NASHOME is the directory in which NAS is installed.
Step 3 After NAS starts without any loading errors, you must stop it before you begin installing the CSRC software packages. To do this, enter the following command:
# NASHOME/bin/KIVAes.sh stop
After stopping the NAS, enter the following command to ensure that NAS did stop:
# /usr/bin/ps -ef | grep -i nas
If NAS is stopped, no NAS processes display as the output of the ps command.
NAS must not be running when you begin installing CSRC. The CSRC installer starts NAS at the appropriate time.
Step 6 of the CSRC installation process is to install the CSRC software packages that operate with the software packages you previously installed.
You must install CSRC as root. The following procedure describes how to install the first CSRC software package on a host. The steps in the procedure indicate the number of the box on the "CSRC Installation Worksheet" that contains the information requested. In this procedure, the first package installed on the host is CSCOcsrcd. If the first package you install on the host is another CSRC package, substitute the other package name on the command line. All other steps remain the same.
To install the first CSRC 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:
cdrom specifies the CD-ROM directory containing the CSRC installer.
1_0_1 is the version number of CSRC. If you are installing another CSRC package, substitute the other package name for CSCOcsrcd.
Step 4 Enter yes to indicate that you want the installer to prompt you for all CSRC installation parameters. This allows you to create a response file that you can use later to install additional CSRC packages.
Prompt for all CSRC installation parameters now? [no]: yes
Step 5 Enter the full pathname of the Perl executable (box 1).
Enter pathname of Perl executable [/usr/bin/perl]:
If the /usr/bin/perl default does not exist, a default value does not appear in the prompt.
If you specify a pathname that does not exist, the installer displays the prompt again.
Step 6 Enter the full path of the directory in which you installed the Netscape Application Server (box 17). The default is /usr/local/nas21, if it exists.
Enter the NAS installation root directory [/usr/local/nas21]:
If you enter a directory that does not exist, the installer displays the prompt again.
Step 7 Enter the name of the user under which the Netscape Application Server processes execute (box 18). The default displays the owner of the NAS installation root directory.
Enter user name of the NAS owner:
While installing the CSCOcsrcw package, if you enter a username that the operating system does not recognize, the installer displays the prompt again.
While installing CSRC packages other than CSCOcsrcw, if the operating system does not recognize the username, a warning message appears indicating that the installation is continuing with the assumption that the NAS is installed on another host on which the username you specified is valid.
Step 8 Enter the full path of the directory in which you installed the LDAP directory server (box 11). The default is /usr/netscape/server4, if it exists. Otherwise, the default is none.
Enter the LDAP server installation root directory:
Step 9 Enter the name of the host on which the LDAP server is installed (box 12). The default is the output of the hostname command.
Enter the LDAP server host name:
Step 10 Enter the unique identifier for the LDAP server (box 13). The default is the LDAP server host name with its domain removed, if the corresponding server directory LDAP-server-root/slapd-host-name exists. Otherwise, there is no default.
Enter directory server identifier:
Step 11 Enter the port number on which the LDAP server listens for queries (box 14). The default is the value of the Port parameter in the slapd.conf file, if it exists. Otherwise, there is no default.
Enter the LDAP port number:
Step 12 Enter the root distinguished name (DN) for CSRC data (box 20). The root DN you specify must already exist. If it does not, you must create it before you install CSRC. For Netscape Directory Server, the default is o=NetscapeRoot. You can use the default.
Enter the root distinguished name for CSRC data [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 displays the prompt again.
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 ou=csrcprogramname, (including the trailing comma) to the DN you enter .
Step 13 Enter the administrator ID for the LDAP directory server (box 15). The default is admin.
Enter the directory server administrator ID [admin]:
Step 14 Enter the password for the directory server administrator ID you specified in the previous step (box 16). You must enter the password twice identically.
Enter the directory server administrator password: Enter the directory server administrator password (again):
Step 15 Enter the name of the host on which the Cisco Network Registrar servers are installed (box 2). This is 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).
Enter Cisco Network Registrar host name:
Step 16 Enter the username for the Cisco Network Registrar administrator who has access to the Cisco Network Registrar database (box 3). The default is admin.
Enter Cisco Network Registrar user name:
Step 17 Enter the password for the CNR administrator you specified in the previous step (box 4), and then enter the password again to confirm it.
Enter password for Cisco Network Registrar "username" user: Again:
Step 18 Review the information the installer displays to confirm the values you entered. The installer does not display the actual value you entered for a password. Instead, it displays <not displayed>. The installer stores the passwords you entered in encoded form in both the Solaris package database and the csrc.cfg file.
If the values displayed are correct, press Enter to accept the prompt's default answer and continue installing CSRC, or enter no or quit to terminate the installation.
Proceed with the installation of Cisco Subscriber Registration Center version [Y]?
At this point, the installer saves the parameter values you entered, if you previously indicated that you wanted to create a response file when the installer prompted you. The installer saves the parameter values in the /tmp/csrc_install_defaults file and displays a message indicating how to invoke the pkgadd utility to use the response file when installing additional CSRC packages.
pkgadd -d /cdrom/csrc_1_0_1/CSRC/Solaris -r /tmp/csrc_install_defaults CSCOcsrcn CSCOcsrcw CSCOcsrcu
The installer uses the information in the response file to gather the remaining needed information.
The installer uses the information in the response file to gather the remaining needed information. If you want to install CSRC packages on a different host, using the response file, copy the response file to that host and invoke pkgadd as described in the above example.
As the installation of CSRC continues, the installer does the following:
Cisco recommends that you 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.
To replace the index.html file, do the following:
Step 1 Enter the following command to change to the /opt/csrc/apache/htdocs directory:
# cd /opt/csrc/apache/htdocs
Step 2 Enter the following command to save the current index.html file:
# mv index.html index_old.html
Step 3 Enter the following command to copy the ur-redirect.html file to the /opt/csrc/apache/htdocs directory and rename it:
# cp /opt/csrc/html/ur-redirect.html index.html
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 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 Administrator Login to User Registrar page (see Figure 4-1):
Log in to User Registrar Administrator
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 4-2) appears.
Step 5 On the Home Page, click Administrators. The Manage Administrators page (see Figure 4-3) appears.
Step 6 On the Manage Administrators page, click Add Administrator. The Add Administrator page (see Figure 4-4) appears.
Step 7 On the Add Administrator page, enter the following username in the Administrator username field:
Administrator username: testuser
Step 8 Enter a description in the Description field to further identify the administrator.
Step 9 Enter the following password in the Administrator password and Confirm password fields:
Administrator password: 1234 Confirm password: 1234
Step 10 Select all of the Administrator privileges checkboxes.
Step 11 Click Add Administrator. The Confirm Addition of Administrator page (see Figure 4-5) appears.
Step 12 On the Confirm Addition of Administrator page, click Add Administrator to add the new administrator. The Manage Administrators page (see Figure 4-3) appears.
Step 13 On the Manage Administrators page, enter the testuser username in the Username field and click Search to display the new administrator.
Step 14 Click Logout. The Administrator Logout from User Registrar page (see Figure 4-6) appears.
Step 15 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 4-1) appears.
Proceed to the "Verifying Modem Registrar" section to continue verifying the CSRC installation.
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 4-7) page:
Log in to Modem Registrar
Step 3 On the Login page, enter the following username and password in the Username and Password fields to log in as the default administrator:
Username: admin Password: changeme
Step 4 Click Login. The Main Menu page (see Figure 4-8) appears.
Step 5 On the Main Menu page, click Administrators. The Manage Administrators page (see Figure 4-9) appears.
Step 6 On the Manage Administrators page, enter the testuser username 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 4-10) appears.
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 4-9), click Logout to exit the Modem Registrar application.
Step 8 of the installation 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:12:18 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.