Chapter 5 Post-installation Activities

Table Of Contents

Post-Installation Activities

Enabling a Network Registrar Spoofing DNS Server

Configuring the Syslog Utility to Receive Alerts from BACC

Uninstalling Broadband Access Center

Uninstalling BACC from the Graphical User Interface

Uninstalling BACC from the Console Mode

Post-Installation Activities

This chapter describes activities you can perform after installing BACC:

• Enabling a Network Registrar Spoofing DNS Server

• Configuring the Syslog Utility to Receive Alerts from BACC

• Uninstalling Broadband Access Center

Enabling a Network Registrar Spoofing DNS Server

A spoofing DNS server redirects all DNS requests to the same IP address. This can be used to enforce a self-provisioning flow for a new subscriber.

For example, assume that a DNS host is dns.acme.com, and has an IP address of 10.10.10.5. Assume also, that the Web server with the self-provisioning flow is 10.10.10.6.

On the DNS server, set the following in Network Registrar:

nrcmd> zone . delete
nrcmd> zone . create primary dns.acme.com postmaster.dns.acme.com
nrcmd> zone . addrr * a 10.10.10.6
nrcmd> save
nrcmd> dns reload

When DNS reloads, the changes will take effect.

On the DHCP server, set the following in Network Registrar:

nrcmd> policy unprovisioned setoption domain-name-servers 10.10.10.5
nrcmd> policy unprovisioned setoption domain-name acme.com
nrcmd> save
nrcmd> dhcp reload

Configuring the Syslog Utility to Receive Alerts from BACC

This section describes how to configure the syslog utility on both the Network Registrar extension points and RDU server to receive alerts and debugging information from BACC.

Step 1 Log in as root on the Network Registrar server.

Step 2 At the command line, create the log file. For example:

touch /var/log/bpr.log
Step 3 Open the /etc/syslog.conf file with a text editor.

Step 4 Add this line to the /etc/syslog.conf file:

local6.info /var/log/bpr.log

Note You must insert one or more tabs between the local6:info and /var/log/bpr.log information.

Step 5 Save and close the /etc/syslog.conf file.

Step 6 To force the syslog utility to take the new configuration, at the command line enter these commands:

ps -ef | grep syslogd
root 217 1 0 Nov 26 ? 0:00 /usr/sbin/syslogd

kill -HUP 217

Note The pid in this example is 217, but may change when you run ps -ef | grep syslogd. Use the correct output, from that command, as the input to kill -HUP.

Syslog is now ready to receive alerts from BACC.

Uninstalling Broadband Access Center

The program described in this section uninstalls the RDU, Network Registrar extensions, the DPE, and the KDC, but it does not uninstall the Network Registrar application. Prior to removing BACC you must manually remove the BACC configuration on Network Registrar.

The uninstallation program removes all files located under the installation directory (the default installation directory is /opt/CSCObpr). If the database is found under the installation directory, as is the case in the lab installation program, the program displays a warning message that it is deleting the database. You can exit from the uninstallation program at that time, or you can choose to proceed.

The uninstallation program also shuts down and removes these processes if they are detected: RDU, KDC, SNMP Agent, JRun, BACC agent, and the DPE.

The uninstallation program does not remove files that were placed outside the installation directory. For example, a component installation places the database and database transaction logs directories under /var/CSCObpr. So theses files are not removed. The uninstallation program also does not remove any files that are located under the Network Registrar directory.

Caution If you uninstall BACC after configuring your Network Registrar servers to use BACC extensions, your network will no longer function correctly. You must uninstall BACC extensions in Network Registrar to completely uninstall the BACC program.

There are two ways to remove BACC:

• Uninstalling BACC from the Graphical User Interface

• Uninstalling BACC from the Console Mode

Uninstalling BACC from the Graphical User Interface

To uninstall BACC using the graphical user interface:

Step 1 Log in as root.

Step 2 Manually remove the configuration of the BACC extensions on the Network Registrar server. You can do this from any server that has nrcmd installed and connectivity with Network Registrar.

Follow these steps:

a. To uninstall the BACC extensions from your Network Registrar configuration, use these commands:

<NR_HOME>/usrbin/nrcmd -N admin -P changeme -b <
<BACC_HOME>/cnr_ep/bin/bpr_cnr_disable_extpts.nrcmd
b. To reload your DHCP server, use these commands:

/etc/init.d/nwreglocal stop
/etc/init.d/nwreglocal start

Alternatively, enter this command:

<NR_HOME>/usrbin/nrcmd -N admin -P changeme "dhcp reload"
c. To remove the BACC extensions from the Network Registrar extensions directory, use this command:

rm -f <NR_HOME>/extensions/dhcp/dex/libbprextensions.so
Step 3 At the CLI prompt, enter:

<BACC_HOME>/_uninst/uninstall.bin

The uninstallation program's Welcome screen appears.

Step 4 Click Next. The uninstallation program begins removing BACC files.

When the uninstallation is complete, the Cisco Broadband Provisioning Registrar was Uninstalled screen appears.

Step 5 To exit the uninstallation program, click Finish.

Note Should the uninstallation program fail to successfully uninstall BACC, error messages will appear on screen.

Uninstalling BACC from the Console Mode

To uninstall BACC from the console mode:

Note If you are uninstalling BACC from a lab installation, the database is automatically deleted based on your confirmation. To prevent the accidental or unplanned deletion of the database, copy or back up the database files and log files as instructed in the Cisco Broadband Access Center for Cable Administrator's Guide.

Step 1 Log in as root.

Step 2 Manually remove the configuration of the BACC extensions on the Network Registrar server. You can do this from any server that has nrcmd installed and connectivity with Network Registrar. Follow these steps:

a. To uninstall the BACC extensions from your Network Registrar configuration, use these commands:

<NR_HOME>/usrbin/nrcmd -N admin -P changeme -b <
<BACC_HOME>/cnr_ep/bin/bpr_cnr_disable_extpts.nrcmd
b. To reload your DHCP server, use these commands:

/etc/init.d/nwreglocal stop
/etc/init.d/nwreglocal start

Alternatively, enter this command:

<NR_HOME>/usrbin/nrcmd -N admin -P changeme "dhcp reload"
c. To remove the BACC extensions from the Network Registrar extensions directory, use this command:

rm -f <NR_HOME>/extensions/dhcp/dex/libbprextensions.so
Step 3 At the CLI prompt, enter:

<BACC_HOME>/_uninst/uninstall.bin -console

The following is displayed:

Welcome to the Uninstallation Program

Press Enter to uninstall Cisco Broadband Provisioning Registrar from your system.

Press Enter to Continue or 'q' to Quit:

Step 4 Press Enter to start the removal process. When uninstallation is complete these messages appear:

Cisco Broadband Provisioning Registrar was Uninstalled

Cisco Broadband Provisioning Registrar files were uninstalled successfully.

Press Enter to finish:

Step 5 Press Enter to exit the program.