|
These release notes are for the Cisco Broadband Access Center (BAC) for Broadband Aggregation, Release 2.5, software. This document describes system requirements, software features, implementation notes, caveats, and related documentation.
These release notes cover the following topics:
Cisco Broadband Access Center (BAC) enables you to provision devices, resources, services, and subscribers easily. You can implement BAC in small to very large scale deployments. The distributed nature of the software supports its deployment in a variety of environments and with a variety of services and technologies.
BAC has the following system requirements:
Note BAC requires that you install the current patches to the Solaris 8 operating system from Sun Microsystems and patch 112438. |
BAC supports the hardware described in Table 1.
Supported Device | Cisco IOS Version |
---|---|
BAC integrates with the network servers described in Table 2, although these servers are not bundled with BAC.
Table 2 Supported Network Servers
Server | Hardware Platform | Software Version |
---|---|---|
With Broadband Access Center Release 2.5, you can:
The procedure for installing BAC is documented in the Broadband Access Center Installation and Configuration Guide. This section describes the special circumstance s of extracting the installation script from the Cisco e-kit abd for accessing the Web UI.
If you are using the Cisco e-kit, you need to extract the installation script as follows:
The system displays the following message:
The script checks to see if you have sufficient space for the expanded installer and tar archive.
Step 2 Follow the instructions that the script provides, as show in this example:
Step 3 Enter the installation path for the product; for example:
Step 4 Refer to the Broadband Access Center Installation and Configuration Guide for the installation procedure.
When you install the BAC server, you are also installing a Web server. The server starts automatically when you run ./bacStartup all. Before you can access the Web UI, however, if you have installed the Java Virtual Machine, you might need to reconfigure Internet Explorer as follows:
Step 2 From the Tools menu, select Internet Options. The browser displays the Internet Options dialog box.
Step 3 Click Advanced. The browser displays a list of advanced settings.
Step 4 Scroll through the list to determine if this setting is checked:
Step 5 If it is checked, then click to disable this setting.
Step 6 Click Apply and OK.
Step 7 Close Internet Explorer and then re-open it.
Step 8 To access the Web UI, in the Address field of the browser enter the URL for BAC; for example, enter the following:
The following are limitations and restrictions with BAC:
In the following example, a router encounters a duplicate VLAN ID and generates the following message:
BAC receives this as a warning and treats the operation as a success, but the VLAN ID was not configured on the router. Thus, the operation failed. To fix the problem, update the keyword in the /opt/CSCObacss/common/IOSParser.config file. In the VLAN ID example, the update would appear as follows:
The VcSystemProperties.xml file affects the following:
The VcSupportedDeviceList.xml file contains all information related to device creation. The model list field and subtype field obtain their values from this file. This file also determines whether a device supports SSH or discovery.
To refresh servers, follow these steps:
Step 2 Click Refresh Servers.
CSCdx59874The BAC API does not support implementing multiple instances of network address translation (NAT) on the same interfaces, whether they are inside or outside interfaces. While you can add multiple NATs (with different names and ranges) to an interface, you cannot remove them.
The workaround for this situation is to do one of the following:
CSCdx63539If you download a configuration to a router that contains an incorrect ATM subinterface, then the download configuration pattern through Telnet is wrong. Ultimately, Telnet times out, returning a message that it could not connect to the router.
CSCdy09364A problem occurs if different roles share the same virtual private dial-up network (VPDN) template. For the PTA-PPPoEoA, PTA-PPPoEoE and PTA-PPPoEoVLAN roles, you can select IPPool or DHCP. For the LAC-PPPoEoA, LAC-PPPoEoE, LAC-PPPoEoVLAN roles, these features are not available, but are still displayed. The same problem exists when you add a virtual template service feature.
You can have only one VPDN on a router regardless of the number roles that you add. Since the router can act as either a PTA or a LAC, VPDN prompts the user to select one of three options:
You should carefully plan the number of roles you add to a router. For example, you might start with LAC-PPPoEoA. When you create the VPDN, you do not need to provide an IP address. However, you can still select either local pool or DHCP because the IP address might be required later for PTA.
CSCdy19994When you select the console method of downloading device configuration, the Service Provisioning Manager component of the BAC software clears the console port before performing the download. When you log in to the router, the console displays a considerable amount of garbage characters before displaying the new running configuration.
This is most likely to occur when your terminal server is configured for modem callout. To turn off modem callout, do the following:
Step 2 At the command line, enter the following:
CSCdy20943The Service Provisioning Manager (SPM) component of BAC rolls back download transactions when either the router returns an error or the IE2100 syntax checker returns an error. This is due to a limitation of the CNS Agent, which cannot distinguish between an IE2100 syntax error and a router error.
CSCdy24503If you create a new profile, be sure to create it in the /Default/ServiceProfiles directory. If you create a profile in a different directory, you cannot see the profile in the Web UI.
CSCdy25967When you view a service, you need to expand the role folder and then select the service features it contains.
CSCdy40442When you attempt to download a VLAN range using HTTP, Cisco IOS reports an error. The other download methods operate properly.
CSCdy72787To use SSH security to communicate with a router, make sure that, when you add the device using the BAC Web UI, the hostname you enter matches the hostname of an SSH-enabled router. SSH uses the hostname to generate an encryption key. If the hostnames do not match, SSH will not authenticate transmissions to the router.
CSCdy88590The BAC Web UI has a paging feature that enables you to choose whether to display 10 or 20 records at time. You can also pick the column of data BAC uses to sort these records for display. When you choose the column of data that you want to use for the sort, BAC displays it in alphanumeric order; for example:
user1
user10
user11
user12
user2
user3
user4
CSCdz40721When you are setting up quality of service features, BAC checks the following dependencies:
The BACAdmin user can assign different ISPs to each of these resources. For example, the policy map might be associated with ISP1 and the service might be associated with ISP2. If a user belonging to a group at ISP2 logs in, the policy map field for the service is empty. To avoid this situation, make sure that the same ISP is associated with the service, policy map, class map, and access list.
CSCea01239The BAC Web UI provides a default value for QoS Rate that is not valid for all device types. You may encounter a download error if the QoS rate is out of range for a particular device. Review the QoS rate ranges for your routers.
CSCea28696Data files are not required for the templates associated with Cisco and IETF tunnels. When you are working with these templates, however, you might encounter an error message such as :
You can ignore these messages.
CSCea45024In the following scenario, a user logged in as a CustomerOperator can provision and unprovision devices and subscribers:
1. You create a new user and add the user to these groups:
2. You assign all devices to sp_jc1.
3. The new user logs in as a CustomerOperator at sp-jc1 and can provision devices and subscribers.
CSCea66254When you first run bacStartUp and then call IE2100 setup, you might encounter the following message:
CSCea79133If an aggregator is configured with the AAA authentication as local and then a subscriber is provisioned, the subscriber's username and password are not configured on the router during the provisioning process. To correctly authenticate the CPE of the subscriber, add the subscriber's username and password needs to be added manually.
CSCea80432When you create a service under the Network Services tab, the Session-Timeout and Idle-Timeout fields are mandatory fields. These settings are associated with a subscriber when the service profile is connected to the service and saved in the AAA server. When the subscriber's CPE is brought up, these two settings are sent by the RADIUS server to the aggregator and used to set the session and idle timeout for the subscriber. You can see these settings on the aggregator by entering: >show caller timeouts.
The workaround for this situation is as follows:
Step 2 Find the Session and Idle Timeout areas which are as follows:
Step 3 Change surrounding <IntegerField> and </IntegerField> tags to <TextField> and </TextField>, respectively.
Step 4 Save the file.
Step 5 Create a service under the Network Services and make the Session-Timeout and Idle-Timeout fields empty.
Step 6 Save the service profile.
Step 7 Provision the subscriber's service profile so it is associated with the service profile you just created.
CSCea65867If you create a device using the BAC northbound API, BAC does not validate the useSSH variable. Set the useSSH variable to true if device is created using NBAPI even if the property file sets supportsSSH to false.
CSCea81793When using the Search function to select devices, interfaces, or subscribers, filtering based upon role does not function as expected. For example, if a subscriber is attempting to add a service feature in role ABC, then the device selector only lists devices that have the role ABC provisioned on them. But, the search function lists all devices that match the search criteria whether or not the role is correct.
CSCea86069If you intend to install BAC using the silent option, before you run the installation make sure the window is allowed to setup connections to the X server. Otherwise, the installation process exits, and you cannot bring up servers when you run the bacStartUp initial command. To avoid the problem, simply run the xhost + command.
CSCea86159When adding service features, you may encounter an error message that says BAC could not connect to the log server. The log server is not included in this release of the software. BAC moves on and completes adding service features without audit logging.
CSCea86868BAC does not validate the type of RADIUS servers that you add to a RADIUS group. For example you can add radius1, which might be an Access Registrar server, and radius2, an Interlink Merit server, to the same group. For load balancing purposes, this mixing of servers is unlikely. Make sure all RADIUS servers in a RADIUS group are of the same type.
CSCea87190You can create multiple Cisco CNS Notification Engine servers using the same IP address. If there are multiple Notification Engine servers with the same IP address, BAC generates an error when you try to add the Basic Service feature. Make sure that all Notification Engine servers have unique IP addresses.
The BAC documentation consists of the following:
These sections explain how to obtain documentation from Cisco Systems.
You can access the most current Cisco documentation on the World Wide Web at this URL:
Translated documentation is available at this URL:
http://www.cisco.com/public/countries_languages.shtml
Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which is shipped with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual subscription.
You can order Cisco documentation in these ways:
http://www.cisco.com/cgi-bin/order/order_root.pl
http://www.cisco.com/go/subscription
You can submit comments electronically on Cisco.com. In the Cisco Documentation home page, click the Fax or Email option in the "Leave Feedback" section at the bottom of the page.
You can e-mail your comments to bug-doc@cisco.com.
You can submit your comments by mail by using the response card behind the front cover of your document or by writing to the following address:
Cisco Systems
Attn: Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883
Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain online documentation, troubleshooting tips, and sample configurations from online tools by using the Cisco Technical Assistance Center (TAC) Web Site. Cisco.com registered users have complete access to the technical support resources on the Cisco TAC Web Site.
Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information, networking solutions, services, programs, and resources at any time, from anywhere in the world.
Cisco.com is a highly integrated Internet application and a powerful, easy-to-use tool that provides a broad range of features and services to help you with these tasks:
If you want to obtain customized information and service, you can self-register on Cisco.com. To access Cisco.com, go to this URL:
The Cisco Technical Assistance Center (TAC) is available to all customers who need technical assistance with a Cisco product, technology, or solution. Two levels of support are available: the Cisco TAC Web Site and the Cisco TAC Escalation Center.
Cisco TAC inquiries are categorized according to the urgency of the issue:
The Cisco TAC resource that you choose is based on the priority of the problem and the conditions of service contracts, when applicable.
You can use the Cisco TAC Web Site to resolve P3 and P4 issues yourself, saving both cost and time. The site provides around-the-clock access to online tools, knowledge bases, and software. To access the Cisco TAC Web Site, go to this URL:
All customers, partners, and resellers who have a valid Cisco service contract have complete access to the technical support resources on the Cisco TAC Web Site. The Cisco TAC Web Site requires a Cisco.com login ID and password. If you have a valid service contract but do not have a login ID or password, go to this URL to register:
http://www.cisco.com/register/
If you are a Cisco.com registered user, and you cannot resolve your technical issues by using the Cisco TAC Web Site, you can open a case online by using the TAC Case Open tool at this URL:
http://www.cisco.com/tac/caseopen
If you have Internet access, we recommend that you open P3 and P4 cases through the Cisco TAC Web Site.
The Cisco TAC Escalation Center addresses priority level 1 or priority level 2 issues. These classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer automatically opens a case.
To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to this URL:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
Before calling, please check with your network operations center to determine the level of Cisco support services to which your company is entitled: for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). When you call the center, please have available your service agreement number and your product serial number.
This document is to be used in conjunction with the documents listed in the "Related Documentation" section.
CCIP, CCSP, the Cisco Arrow logo, the Cisco Powered Network mark, Cisco Unity, Follow Me Browsing, FormShare, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, the Cisco IOS logo, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherSwitch, Fast Step, GigaStack, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, MGX, MICA, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, RateMUX, Registrar, ScriptShare, SlideCast, SMARTnet, StrataView Plus, Stratm, SwitchProbe, TeleRouter, The Fastest Way to Increase Your Internet Quotient, TransPath, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and certain other countries.
All other trademarks mentioned in this document or Web site are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0304R)
Copyright © 2003, Cisco Systems, Inc.
All rights reserved.
Posted: Wed Jun 4 11:50:55 PDT 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.