Table Of Contents
Release Notes for Broadband Access Center for Cable Release 2.6.1
June 17, 2004
These release notes for release 2.6.1 of Cisco Broadband Access Center for Cable (BACC), describe fixes to certain software issues, provide descriptions of the Solaris based software Device Provisioning Engine (DPE) and the CableHome technology, and introduce the model DPE-2115 Device Provisioning Engine.
The Broadband Access Center for Cable (BACC) product is a high-speed provisioning application that is easy to install, configure, and maintain. It provides a simple and easy way to deploy high-speed data, voice technology, and home networking technology services.
The BACC Java provisioning API allows easy integration into an existing operations support system (OSS) environment.
This release note provides information for the BACC 2.6.1 release and includes a summary of the complete set of fixes incorporated into the product since the BACC 2.6 release.
This patch release provides:
•Bug fixes for PacketCable RDU extension chaining.
•Other bug fixes related to RDU extensions and troubleshooting.
•Support for the new device provisioning engine, model DPE-2115.
This release of the BACC product is supported by these related documents:
•Broadband Access Center for Cable Administrator's Guide (Release 2.6)
•Broadband Access Center for Cable Installation Guide (Release 2.5)
•To support the DPE-590:
–Device Provisioning Engine 590 Recovery CD-ROM Release Notes
–Cisco Content Engine 500 Series Hardware Installation Guide. You can locate this at:
•To support the DPE-2115:
–Device Provisioning Engine 2115 Recovery CD-ROM Release Notes
–Installation and Setup Guide for the Cisco 1102 VLAN Policy Server. You can locate this at:
Caution Refer to this guide for port and connector identification and to perform hardware installation only. Do not attempt to perform any of the configuration instructions found in that guide.
•Cisco Network Registrar User's Guide (Release 6.0)
•Cisco Network Registrar CLI Reference (Release 6.0)
The BACC product comprises these major components:
•The regional distribution unit (RDU), which is software that you install on your server.
•The device provisioning engine (DPE), which is available in two versions:
–A software DPE that is installed on a Solaris Sparc computer.
–Software that comes pre-installed on rack mountable hardware. Two such devices are currently in use: the original DPE-590 and its replacement the DPE-2115.
•Extension points, which must be installed on the Network Registrar DHCP servers.
•An application programming interface (API) with which you can integrate BACC with other OSS and billing systems.
•An administrator's user interface from which you can monitor and manage BACC.
•A sample user interface (SUI) with which you can demonstrate BACC's power and flexibility.
You must have the Solaris 9 operating system and Network Registrar installed on your system to successfully use the BACC software.
Note The minimum Network Registrar version required to install BACC 2.6.1 is Network Registrar 6.1.
The minimum hardware requirements needed to support both a lab and a fully deployed network are completely described in the Cisco Broadband Access Center for Cable Installation Guide.
Note Processing capacity, disk storage, and memory requirements depend on the size of the network deployment and the amount of log information needed.
Device Provisioning Engine 590
All installation and connection issues are discussed in the Cisco Content Engine 500 Series Hardware Installation Guide that accompanies this product.
Device Provisioning Engine 2115
All installation and connection issues are discussed in the Installation and Setup Guide for the Cisco 1102 VLAN Policy Server. You should refer to that guide to identify various ports and connectors, and whenever installing the device.
The BACC 2.6.1 release removes a previous situation whereby BACC 2.6 would not permit the chaining of RDU extensions for each supported technology. BACC 2.6.1 now supports the chaining of PacketCable voice technology configuration generation extensions.
In addition, BACC 2.6.1 provides fixes for a number of prior software limitations related to RDU extensions and the troubleshooting of RDU extensions. See the "Resolved Issues" section for specific details.
These limitations apply to the use of the BACC 2.6.1 release.
RDU Upgrade From Prior BACC Installations
This release does not include an automated RDU upgrade capability. To use the BACC 2.6.1 RDU component on top of an existing BACC 2.6 installation, you must manually perform the steps described in the Installation section of this document.
Hardware DPE Upgrade From Prior Installations
Although hardware DPEs can simply be re-imaged, it is recommended that the hardware DPE be updated through the BACC patch mechanism. This will preserve the DPE configuration. However, re-imaging the DPE forces it to completely re-synchronize itself with the RDU.
Note See the "Installation" section for additional related information.
Solaris DPE Upgrade From Prior Installations
It is recommended that Solaris DPEs be updated using the BACC installation procedures outlined in this release note. See the "Component Installation of a Solaris Device Provisioning Engine" section for specific installation details.
Network Registrar DHCP Extensions Upgrade
The release of BACC 2.6.1 has not introduced any functional changes to the Network Registrar extensions. Consequently, these extensions are not automatically upgraded by BACC 2.6.1.
As with previous versions of this product, BACC 2.6 has two forms of installation: Lab and component installations. While the differences are clearly described in the Cisco Broadband Access Center for Cable Installation Guide for release 2.5, the introduction of the new Solaris DPE affects the installation process.
This section describes:
Note Prior to installing the BACC product, refer to the SunSolve web site, from Sun Microsystems, Inc., to download and install the latest Solaris Patch Cluster.
BACC 2.6.1 Installation
The BACC 2.6.1 installation instructions in this section, assume that these conditions have been met:
•BACC 2.6 is currently installed and operating correctly.
•You have fetched the BACC 2.6.1 update file from CCO and decompressed its contents to a folder such as /opt/CSCObpr/patch261.
Note Please refer to the Cisco Broadband Access Center for Cable Installation Guide for release 2.5 for basic installation instructions.
Components Upgrade Order
The BACC upgrade procedure requires that the components be updated in the exact order described here. Performing the upgrade in any other order may result in errors during provisioning.
Note The BACC 2.6.1 release now supports both the DPE-590 and the DPE-2115. See the "DPE-2115 Installation" section for information specific to this device. Installation of the DPE-590 is not affected by this release although this device can be upgraded to BACC release 2.6.1, as described in the "Installing the DPE-590 Patch Software" section.
3. CNR extensions
Note Installing BACC 2.6.1 may not, depending on your deployment, require that all components be upgraded.
The DPE-2115 installation is described in the Installation and Setup Guide for the Cisco 1102 VLAN Policy Server. From an operations perspective, the DPE-2115 looks and operates similarly to the DPE-590. However, after running the reload command, when using the DPE-2115 in conjunction with a Catalyst switch, the Ethernet link is temporarily dropped until the Catalyst Fast Path feature starts to pass traffic.
The effects of this are that:
•The console port login is displayed, although there is a short delay imposed before you can Telnet to the DPE-2115. The console port login prompt is:(Hit Enter to Login)
•The DPE-2115 log files may show the DPE process stopping and restarting until the Ethernet port begins to pass traffic. This activity may cycle a few times before the DPE process successfully restarts. As a result of this situation, you may see error messages, similar to that shown below, in the log files.bacc_dpe.bacc.net: 2004 10 21 14:39:18 GMT: %BACC-DPE-5-0236:[Device Provisioning Engine] starting upbacc_dpe.bacc.net: 2004 10 21 14:39:34 GMT:%BACC-DPE-0-STACK_TRACE: com.cisco.provisioning.cpe.PACEConnectionException:Specified RDU host [bacc_dpe.bacc.net] is unknown
Upgrading the RDU
There is no migration path from earlier BACC releases to BACC 2.6.1. Release 2.6.1 must be installed directly over the BACC 2.6 release. A script is provided, as part of the BACC 2.6.1 release, to simplify upgrading the RDU component. It is strongly recommended that you use this script when upgrading the BACC 2.6 RDU component.
Step 1 Untar the release package (261upgrade.tar) onto the computer on which the BACC 2.6 RDU resides. For example, you would enter:tar xvf 261upgrade.tar
Step 2 Run this script from the upgrade folder:cd patch261/bin ./261-upgrade-rdu.sh
Note You must manually restart the BPR Agent to finish the upgrade process.
An output similar to this displays.BPR LocatedBPR Home directory is /opt/CSCObprCurrent version is 2.6RDU Component InstalledStopping the BPR AgentBPR Agent for BPR Provisioning Engine is stopped.BPR Agent stoppedCopying the Upgrade FilesUpgrading Package InformationUpgrade for BPR 2.6.1 Completed SuccessfullyPlease start your BPR Agent to finish the upgrade Process
Step 3 Run this command to verify that the output indicates it is BACC release 2.6.1:# pkgparam CSCObpr VERSION
The version information returned should be 2.6.1.
Step 4 Check the installed list of files. An output similar to this displays.
Note The previous version of the file bpr.jar is renamed as bpr-26.jar.
Upgrading the Solaris DPE
Release 2.6.1 must be installed directly over the BACC 2.6 release. A script is provided, as part of the BACC 2.6.1 release, to simplify upgrading the Solaris DPE component. It is strongly recommended that you use this script when upgrading the BACC 2.6 Solaris DPE.
Step 1 Untar the release package (261upgrade.tar) onto the computer on which the Solaris DPE resides.For example, you would enter:tar xvf 261upgrade.tar
Step 2 Run this script from the upgrade folder:cd patch261/bin ./261-upgrade-dpe.sh
Step 3 You must manually restart the BPR Agent to finish the upgrade process.
An output similar to this displays.BPR LocatedBPR Home directory is /opt/CSCObprCurrent version is 2.6DPE Component InstalledStopping the BPR AgentBPR Agent for BPR Provisioning Engine is stopped.BPR Agent stoppedCopying the Upgrade FilesUpgrading Package InformationUpgrade for BPR 2.6.1 Completed SuccessfullyPlease start your BPR Agent to finish the upgrade Process
Step 4 Run this command to verify that the output indicates it is BACC release 2.6.1:# pkgparam CSCObpr VERSION
The version information returned should be 2.6.1.
Step 5 Check the installed list of files. An output similar to this displays.
Note The previous version of the bpr.jar file is renamed as bpr-26.jar.
Upgrading the Hardware DPE
You can remotely patch your DPE-590 devices, or if you have local access to these devices, you can fully re-image them.
Note The DPE-2115 currently ships with the BACC release 2.6.1 and should not, therefore, require upgrading.
Installing the DPE-590 Patch Software
This section describes how to install the software patch required to upgrade the DPE-590 from release 2.6 to release 2.6.1. Complete these instructions to install the DPE software patch bundle called dpe-590-261-upgrade.bpr.
Warning If the hardware DPE is rebooted or powered off, while a patch is being applied, the hardware DPE is left in an unknown state and must be completely re-imaged.
Step 1 Untar the release package onto a computer that has access to the DPEs being upgraded. This computer must also have FTP enabled.
Step 2 Open an FTP connection to each DPE to be patched and upload the patch bundle to the DPE.
Note When opening the FTP connection, you must enter the username admin and the password chosen for the selected DPE.
Step 3 Once an FTP connection is established, change directory to incoming using this command at the FTP prompt:cd incoming
This will locate the patch file so that the DPE can easily find it.
Step 4 FTP the dpe-590-261-upgrade.bpr file to the DPE by issuing the following commands.binput dpe-590-261-upgrade.bpr
Step 5 Log into each DPE, in the enable mode, and run the upgrade command. This prompts you to select the 2.6.1 patch bundle and apply it.
Step 6 Restart the DPE after the patch process completes.
Warning If the DPE appliance is rebooted or powered off, while a patch is being applied, the appliance will be left in an unknown state, and must be completely re-imaged using the instructions in the next section.
Re-imaging the DPE
Using the dpe-590.gz file, found in the BACC 2.6.1 release package, re-image the DPE-590 following the instructions found in the Release Notes for the Broadband Access Center for Cable Device Provisioning Engine Recovery CD-ROM. When referring to that release note, you must substitute all references to the folder "/cdrom/DPE-590" with the folder into which the BACC 2.6.1 update file was decompressed.
Component Installation of a Solaris Device Provisioning Engine
During a component installation, you are prompted to select the components you want to install. With this BACC release, you can now install a DPE component.
Within the Lab Installation process, there are no differences to the installation. In the component installation however, you must select the DPE.
If, during DPE installation, the installation program detects the presence of a TFTP server running on the same computer that the DPE being installed on, the installation is immediately terminated and an error message appears on screen.
During the DPE installation, you are prompted to provide the locations of these directories:
Once you enter this information, refer to chapter 5 of the Cisco Broadband Access Center for Cable Installation Guide and perform the Configuring a Device Provisioning Engine for Data procedure, starting with step 2.
Caution After Solaris DPE installation is complete, you must configure the DPE using the command line interface (CLI). Refer to the Cisco Broadband Access Center for Cable Administrator's Guide for these configuration instructions. Do not attempt to start the DPE until after you have completed this configuration.
Upgrading Network Registrar Extensions
As mentioned in the "Network Registrar DHCP Extensions Upgrade" section, there have been no functional changes to BACC 2.6.1 and there is therefore, no specific reason to upgrade Network Registrar extensions from BACC 2.6 to BACC 2.6.1.
However, if you wish to upgrade these extensions:
Step 1 Stop the Network Registrar DHCP server.
Step 2 Uninstall the BACC Network Registrar extensions. At this time you should also uninstall any custom extensions.
Step 3 Use the BACC installation program to place the BACC 2.6.1 Network Registrar extensions onto the required computer(s).
Step 4 Use the nrcmd command to install the BACC 2.6.1 Network Registrar extensions. See the Cisco Broadband Access Center for Cable Installation Guide for specific instructions.
Step 5 Re-attach any custom chained Network Registrar extensions.
Removal of the API Installation Component
The installation programs for previous BACC releases provided for the installation of an API component. The installation of this component has been removed in the BACC 2.6 release although the API is still available as in previous releases. See the Cisco Broadband Access Center for Cable Installation Guide for specific instructions.
RDU Migration From Previous Releases
This release does not support migration of the RDU database from prior BACC releases. If a previous BACC version is detected during installation, the installation program prompts you to uninstall that version and remove the RDU database.
For information on BACC bugs, see the BACC26_BugList.html file in the docs/ subdirectory of the BACC CD-ROM or electronic distribution.
Table 1 identifies software issues that have been resolved in the BACC 2.6.1 release.
Known Software Problems
Table 2 identifies software issues that are known to exist in this release of BACC.
Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.
You can access the most current Cisco documentation at this URL:
You can access the Cisco website at this URL:
You can access international Cisco websites at this URL:
You can find instructions for ordering documentation at this URL:
You can order Cisco documentation in these ways:
•Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool:
•Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).
You can send comments about technical documentation to email@example.com.
You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.
Obtaining Technical Assistance
For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, Cisco Technical Support provides 24-hour-a-day, award-winning technical assistance. The Cisco Technical Support Website on Cisco.com features extensive online support resources. In addition, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not hold a valid Cisco service contract, contact your reseller.
Cisco Technical Support Website
The Cisco Technical Support Website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, 365 days a year at this URL:
Access to all tools on the Cisco Technical Support Website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:
Submitting a Service Request
Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool automatically provides recommended solutions. If your issue is not resolved using the recommended resources, your service request will be assigned to a Cisco TAC engineer. The TAC Service Request Tool is located at this URL:
For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco TAC engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.
To open a service request by telephone, use one of the following numbers:
Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553 2447
For a complete list of Cisco TAC contacts, go to this URL:
Definitions of Service Request Severity
To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.
Severity 1 (S1)—Your network is "down," or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.
Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.
Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.
Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.
Obtaining Additional Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
•Cisco Marketplace provides a variety of Cisco books, reference guides, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL:
•The Cisco Product Catalog describes the networking products offered by Cisco Systems, as well as ordering and customer support services. Access the Cisco Product Catalog at this URL:
•Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:
•Packet magazine is the Cisco Systems technical user magazine for maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL:
•iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at this URL:
•Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:
•World-class networking training is available from Cisco. You can view current offerings at this URL:
Copyright © 2004 Cisco Systems, Inc. All rights reserved.