|
|
Table Of Contents
Release Notes for Cisco Broadband Access Center for Broadband Aggregation Release 2.6
Hardware and Software Supported
Obtaining Technical Assistance
Obtaining Additional Publications and Information
Release Notes for Cisco Broadband Access Center for Broadband Aggregation Release 2.6
October 14, 2004
These release notes are for the Cisco Broadband Access Center for Broadband Aggregation (BAC BA), 2.6, software.
Contents
These release notes cover the following topics:
•
Introduction 2
•
•
•
•
•
•
•
•
•
Introduction
Cisco Broadband Access Center for Broadband Aggregation (BAC BA) provides network management support for broadband access and aggregation environments by enabling you to provision devices, resources, services, and subscribers. You can implement BAC BA 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.
What's New in This Release
The BAC BA 2.6 software enhances the product in these areas:
•
•
–
–
–
•
–
–
–
–
System Requirements
BAC BA has the following system requirements:
•
•
•
•
–
–
–
–
You may also apply any later patches that supersede those listed.
Hardware and Software Supported
BAC BA was tested and validated on the hardware, Cisco IOS software, and network cards described in Table 1.
Web Server Notes
When you install the BAC BA 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 1
Step 2
Step 3
Step 4
Java (Sun): Use Java <some version number> for <applet> (requires restart)Step 5
Step 6
Step 7
Step 8
http://<web_servername>:8888/bac
Limitations and Restrictions
The following are limitations and restrictions with BAC BA:
•
In the following example, a router encounters a duplicate VLAN ID and generates the following message:
"%Configureation of multiple subinterfaces of the same main interface with the same VID (xx) is not permitted. This VID is already configured on interface FastEthernet0/0.xx"BAC BA 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 IOSParser.config file in /opt/CSCObacss/common directory. In the VLAN ID example, the update would appear as follows:
TG_PARSER=ON TG_SUCCESS_MESSAGE_EXPRESSION=config terminal TG_SUCCESS_MESSAGE_EXPRESSION=ip multicast-routing TG_SUCCESS_MESSAGE_EXPRESSION=Not all config TG_WARNING_MESSAGE_EXPRESSION=Invalid port TG_WARNING_MESSAGE_EXPRESSION=Invalid ip TG_WARNING_MESSAGE_EXPRESSION=already exist TG_ERROR_MESSAGE_EXPRESSION=wrong TG_ERROR_MESSAGE_EXPRESSION=Incomplete TG_ERROR_MESSAGE_EXPRESSION=Must remove priority TG_ERROR_MESSAGE_EXPRESSION=Invalid input TG_ERROR_MESSAGE_EXPRESSION=Configuring vc TG_ERROR_MESSAGE_EXPRESSION=Bad mask TG_ERROR_MESSAGE_EXPRESSION=Inconsistent address and mask TG_ERROR_MESSAGE_EXPRESSION=Overlaps TG_ERROR_MESSAGE_EXPRESSION=already in group TG_ERROR_MESSAGE_EXPRESSION=using old map-list TG_ERROR_MESSAGE_EXPRESSION=cannot delete TG_ERROR_MESSAGE_EXPRESSION=No matching route TG_ERROR_MESSAGE_EXPRESSION=Invalid access list name TG_ERROR_MESSAGE_EXPRESSION=VID is already configured ---> define keyword treated it as failure!!•
–
–
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.
Caution
To refresh servers, follow these steps:
Step 1
Step 2
./serverControl.shStep 3
Step 4
Step 5
Enter a data for refresh (empty ok):
Caveats
This section highlights the major bugs unresolved and resolved in Broadband Access Center, with a brief description of each one. The complete list of resolved and unresolved bugs is available at the Cisco.com software download site for BAC BA. The list is also available on the product distribution in HTML format.
Known Bugs in This Release
This section presents some of the known bugs in this release. For the full list of known bugs in BACBA 2.6, see the Cisco.com software download site for Broadband Access Center 2.6 or the BACBA26_Bug_List.html on the distribution media.
CSCdz11362—If you enter Configuration Engine resources in BACBA and they are not named sequentially in the cdm.properties file, BAC BA returns the following error:
status code: 2029Failed to create initial config entry for router [172.29.145.93] in rain maker[IE2100_5].For example, if one Configuration Engine resource has the hostname IE2100_0, you cannot enter as the next resource one with the hostname IE2100_5. The cdm.properties file requires that these resources be numbered named in unbroken sequence.
CSCea68676— When you restart BAC BA servers are restarted, you must restart any remote web servers associated with the BAC BA servers. If you do not restart the web servers, they receive authentication errors. This caveat applies to SPE servers as well. This applies particularly to the SPE component of BAC BA because it does not support persistent connections.
CSCeb37878—If you manually add a single PVC that requires the private lan ip route command to a router and you omit that command, you cannot later delete the PVC from BAC BA. The upload and synchronization utility adds the PVC to BAC using the information configured with the CPE IP route command, but to delete the PVC requires a work around. To work around this issue, configure both the LAN IP route and the CPE IP route on the router. Used the Deployed download method to delete the PVCs, then resynchronize the router with the BAC BA server.
CSCed13686— When you provision a point-to-point single PVC from BAC BA and download it to the router successfully, you will receive a download error if you later try to provision a multipoint single PVC on the same subinterface. The subinterface is already configured for point-to-point. However, some multipoint single PVC commands will override the point-to-point already provisioned. To work around this issue, use the BAC BA Template Manager to add validation logic.
CSCed67217— You can successfully manually add an unnumbered single PVC service feature to the BAC BA database by providing values for the PVC and VCClass fields even if you do not give a value for the unnumbered interface. The BAC BA upload and synchronization utility only validates the PVC and VCClass values. If you attempt to unprovision this service feature later, it fails with an error such as:
interface $ATM point-to-pointno description ....no pvc $VPI/$VCIno ip address $system_ip_address ..... // router complains "invalid cli" here.This occurs because the running configuration file incomplete. To workaround this issue, delete the PVC from the BAC BA database using the Deployed_Only download method. Then correct the running configuration on the router.
CSCed96093—If you are installing BAC BA 2.6 using a different user ID than during a previous BAC BA installation, you receive the following warning message
chmod: WARNING: can't change /tmp/Installation.data" is seen when installing BACBA 2.6Ignore this message and continue with the installation.
CSCee17129—When you remove a physical interface from a Cisco 10000 series router, the physical inventory in the BAC BA database is not updated. This occurs because BAC BA uses the SNMP ifTable to update interface configurations. The Cisco 10000 router does not update the SNMP ifTable when an interface is removed, so this information is not transmitted to the BAC BA database.
CSCef11779—When you use the Bulk Provisioning tool to add PVCS with the Deployed download method, BAC BA correctly adds the PVCs to its database. However, the addition of these PVCs generates error codes. Ignore these error codes.
CSCef26854—On rare occasions, the Configuration Delivery Manager (CDM) may timeout when you are provisioning PVCs using the HTTP download method. To work around this issue, reissue the provisioning request.
CSCef49989—Migrating data from BAC BA 2.5T(x) to 2.6 removes all existing synchronization reports. If you want to retain these reports, back them up before running the migration utility.
CSCef51510—During device provisioning, the Web UI might fail to display one or more expected images. Instead, it displays an X where the image should appear and text that says Next and Back in place of navigational buttons. To display the images, click the Next or Back text to refresh the browser.
CSCef56570—When you are provisioning or unprovisioning devices using the API, you might receive an error code (1517) indicating an authentication failure even though you entered the correct surname and password. This error happens intermittently. To work around this issue, retry the provisioning or unprovisioning request. To work around this issue, resubmit the request.
CSCef61233—Intermittently, in a provisioning operation, you might receive a "minorCode=0" message without receiving any result of operation message. This might happen when multiple provisioning tasks are running at the same time.
CSCef71080—The ProfileAdmin.idl in BAC BA 2.6 lists a rename_profile() call. This call is not supported. If a client invokes this call, the API displays the following exception:
org.omg.CORBA.UNKNOWNCSCef75012— Under very heavy load, the BAC BA Web server sometimes returns an HTTP 500 error. It displays the following message:
the server encountered an unexpected condition which prevented it from fulfilling the request.To workaround this issue, resubmit the page.
CSCef82001—When you have migrated data from BAC BA 2.5T to 2.6, and then you attempt to delete all service features from a device, you might still see a role for that device displayed. This occurs if the device had PVCs configured in 2.5T.
CSCef88558—In rare circumstances when you are provisioning an interface from the Web UI, the Interface Selection pop up might display "Session time out" on the tree for modules and ports under the cards rather than the interface endpoints. To work around this issue, follow these steps:
Step 1
Step 2
Step 3
Step 4
Step 5
CSCef91422—If the PATH environment variable is incorrectly configured in your user profile, the BAC BA installation script displays this error message: whoami command not found. The script proceeds normally, however. To work around this issue, make sure that the path /usr/ucb is in your PATH environment variable. For example, in the C Shell, set the environment variable as follows:
setenv PATH /usr/ucb:$PATHCSCef92903—The BAC BA Bulk Provisioning tool uses a different template for point-to-point PVC provisioning and unprovisioning than the Web UI and API. The WEB UI and API do not allow a subinterface and a virutal path identifiers (VPI) to have the same value. As a result, if you use the Bulk Provisioning tool to add PVCs, you must use the Bulk Provisioning tool to remove PVCs. This applies only to point-to-point template.
Related Documentation
The BAC BA documentation consists of the following:
•
•
•
Obtaining Documentation
Cisco provides several ways to obtain documentation, technical assistance, and other technical resources. These sections explain how to obtain technical information from Cisco Systems.
Cisco.com
You can access the most current Cisco documentation on the World Wide Web at this URL:
http://www.cisco.com/univercd/home/home.htm
You can access the Cisco website at this URL:
International Cisco websites can be accessed from this URL:
http://www.cisco.com/public/countries_languages.shtml
Documentation CD-ROM
Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which may have shipped with your product. The Documentation CD-ROM is updated regularly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual or quarterly subscription.
Registered Cisco.com users can order a single Documentation CD-ROM (product number DOC-CONDOCCD=) through the Cisco Ordering tool:
http://www.cisco.com/en/US/partner/ordering/ordering_place_order_ordering_tool_launch.html
All users can order annual or quarterly subscriptions through the online Subscription Store:
http://www.cisco.com/go/subscription
Ordering Documentation
You can find instructions for ordering documentation at this URL:
http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm
You can order Cisco documentation in these ways:
•
http://www.cisco.com/en/US/partner/ordering/index.shtml
•
Documentation Feedback
You can submit comments electronically on Cisco.com. On the Cisco Documentation home page, click Feedback at the top of the page.
You can send your comments in e-mail to bug-doc@cisco.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:
Cisco Systems
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883We appreciate your comments.
Obtaining Technical Assistance
For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, the Cisco Technical Assistance Center (TAC) provides 24-hour, award-winning technical support services, online and over the phone. Cisco.com features the Cisco TAC website as an online starting point for technical assistance.
Cisco TAC Website
The Cisco TAC website ( http://www.cisco.com/tac) provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The Cisco TAC website is available 24 hours a day, 365 days a year.
Accessing all the tools on the Cisco TAC website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a login ID or password, register at this URL:
http://tools.cisco.com/RPF/register/register.do
Opening a TAC Case
The online TAC Case Open Tool ( http://www.cisco.com/tac/caseopen) is the fastest way to open P3 and P4 cases. (Your network is minimally impaired or you require product information). After you describe your situation, the TAC Case Open Tool automatically recommends resources for an immediate solution. If your issue is not resolved using these recommendations, your case will be assigned to a Cisco TAC engineer.
For P1 or P2 cases (your production network is down or severely degraded) or if you do not have Internet access, contact Cisco TAC by telephone. Cisco TAC engineers are assigned immediately to P1 and P2 cases to help keep your business operations running smoothly.
To open a case 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-2447For a complete listing of Cisco TAC contacts, go to this URL:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
TAC Case Priority Definitions
To ensure that all cases are reported in a standard format, Cisco has established case priority definitions.
Priority 1 (P1)—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.
Priority 2 (P2)—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.
Priority 3 (P3)—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.
Priority 4 (P4)—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.
•
http://www.cisco.com/en/US/products/products_catalog_links_launch.html
•
•
http://www.cisco.com/go/packet
•
http://www.cisco.com/go/iqmagazine
•
http://www.cisco.com/en/US/about/ac123/ac147/about_cisco_the_internet_protocol_journal.html
•
http://www.cisco.com/en/US/learning/index.html
CCSP, the Cisco Square Bridge logo, 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, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, Registrar, ScriptShare, SlideCast, SMARTnet, StrataView Plus, 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 United States and certain other countries.
All other trademarks mentioned in this document or Website 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. (0406R)
Copyright © 2004 Cisco Systems, Inc. All rights reserved.
Posted: Mon Jan 17 10:55:53 PST 2005
All contents are Copyright © 1992--2005 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
