Instruction/ maintenance manual of the product OL-27172-01 Cisco Systems
Go to page of 322
Americas Headquarters Cisco Systems, In c. 170 West Tasman Drive San Jose, CA 951 34-1706 USA http://www.ci sco.com Tel: 408 526-4000 800 553-NETS (638 7) Fax: 408 527-0883 Cisco Br oadband A ccess Center 3.
THE SPECIFICATION S AND INFORMATION REGARDING TH E PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITH OUT NOTICE. ALL STATEMENTS , INFORMATION, AND RECOMMENDATI ONS IN THI S MANUAL ARE BE LIEVED TO BE A CCURATE BUT ARE PRESENTED WI THOUT WARRANTY OF ANY KIND, EX PRESS OR IMPLIED.
iii Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 CONTENTS Preface xv Audience xv Organization xvi Conventi ons xvii Product Documentation xviii Related Documentation xviii Obtain.
Contents iv Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 CHAPTER 3 Configuration Workfl ows and Checklists 3-1 Component Workflows 3-1 RDU Checklist 3-1 DPE Checklist 3-2 Technolo.
Contents v Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 Device Diagnostics 4-21 Configuring SNMP Trap for CPEs 4-21 CHAPTER 5 Configuration Template s Management 5-1 Overview 5-1.
Contents vi Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Expression and Regular Expr ession 6-7 Internal Firmware File vs. External Firmware File 6-10 InternalFirmwareFile 6-10 Ex.
Contents vii Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 CHAPTER 9 Managing Cisco Broadban d Access Center 9-1 Cisco BAC Process Watchd og 9-1 Using Cisco BAC Process Watchdog f.
Contents viii Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Deleting a Host 11-7 Adding an SNMP Agent Community 11-8 Deleting an SNMP Agent Community 11-9 Starting the SNMP Agent 1.
Contents ix Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 Local Redundancy 12-16 Regional Redun dancy 12-16 DPE Load-Balancing 12-17 Using DNS Round Robin 12-17 Using a Hardware L.
Contents x Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 CHAPTER 14 CWMP Device Operations 14-1 Overview 14-1 Connection Modes for De vice Operations 14-2 Immediate Mode 14-2 On-Co.
Contents xi Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 Performing Operations on Devices 16-14 Group Management 16-18 Managing Group Types 16-18 Adding a Group Type 16-19 Modify.
Contents xii Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Writing a New Class for DPE Feature Pack Extensions 17-22 Managing RDU Extens ions 17-23 Writing a New Class for RDU 17-2.
Contents xiii Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 CHAPTER 21 Troubleshooting Broadband Access Center 21-1 Troubleshooting Checklist 21-1 Logging 21-2 Log Levels and Structures 21-3 Configuring Log Levels 21-4 Rotating Log Files 21-4 RDU Logs 21-5 Viewing the rdu.
Contents xiv Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01.
xv Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 Preface The Cisco Br oadband Access Center 3.8 Administra tor Guide descr ibes concepts and config urations related to Cisco Broadband Acce ss Center , which is called Cisco B AC th roughout this guide.
xvi Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Preface Organization This guide includes th e follo wing chapters: Chapter T itle Description Chapter 1 Broadband Access Center Overvie w Describes Cisco BA C, its features a nd benefits.
xvii Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 Preface Conventions This document uses the f ollo wing con ventions: Note Means reader take note . Caution Means reader be car eful . In this situation, you might perform an actio n that could result in equipment damage or loss of data.
xviii Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Preface Product Documentation Note W e sometimes update the prin ted and electronic documentation after o riginal publication. Therefore, you should also re view the documentati on on Cisco.
CH A P T E R 1-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 1 Broadband Access Center Overview This chapter provides an overvie w of Cisco Broa dband Access C enter (Cisco BA C). Cisco B A C automates the tasks of pro visioning and managing custo mer premises equipment (CPE) in a broadband service pr ovider netw ork.
1-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 B roadband Access Center Overvie w Features and Benefits • Config uration management: V astly simplif ied in Cisco B A C through conf iguration templates, which provide an easy , yet flexible mechanism to a ssign configurations fo r CPE.
1-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 Broadband Access Center Overview Supported Technology • Dev ice diagnostics and troubleshootin g: Y ou use this feature to focus on a single device an d collect diagnostics information for further analysis.
1-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 B roadband Access Center Overvie w Supported Technolog y The Cisco B A C template-based mechani sm to assign config urations for de vices is enhanced to support the TR-196 de vices in the service pro vider's network.
CH A P T E R 2-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 2 Broadband Access Center Architecture This chapter describes the system architecture implemented in this Cisco Broadband Acces s Center (Cisco B A C) release.
2-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadban d Access Center Architec ture Architecture Figur e 2-1 CWMP Deplo yment in Cisco BAC Architecture This section .
2-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadband Access Center Arch itecture Architectu re • STUN server: – Supports a UDP based conn ection request mechan ism def ined in TR069 Anne x G to allo w Cisco B A C to initiate a session with a CPE t hat is operating behind a N A T Gatew ay .
2-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadban d Access Center Architec ture Architecture • An administrator user i nterface that pro vides: – Support for adding, del eting, and modi fying CWMP devices; searching fo r de vices, retrieving dev ice details, and running de vice operations.
2-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadband Access Center Arch itecture Architectu re The DPE manages these activities: • Synchronization with RDU to retrie ve the latest set of instructions for caching .
2-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadban d Access Center Architec ture Architecture Cisco B A C no w provides a mechanism to license DPE e x tension fe ature packs. Th e feature pack lice nses indicate the count of the dev ices that can be proce ssed by t he feature pack extension.
2-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadband Access Center Arch itecture Architectu re • By discov ering the URL via DHCP . This A CS URL is returned in response to a DHCP Discov er , a DHCP Request, or a DHCP Inform.
2-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadban d Access Center Architec ture Architecture Y ou can compress the f iles for easier e-mailing to the Cisco T echnical Assist ance Center or sys tem integrators for troubleshooting and fault resolution.
2-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadband Access Center Arch itecture Architectu re LeaseQuery The LeaseQuery feature allows you to request le ase information from the Network Re gistrar DHCP servers.
2-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 2 Broadban d Access Center Architec ture Architecture.
CH A P T E R 3-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 3 Configuration Workflows and Checklists This chapter is di vided into two major sections that def ine the processes to follo w when configuring Cisco Broadband Access Center (Cisco B A C) components to support v arious technologies.
3-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configuration Wo rkflows and Checklists Component Workflows DPE Checklist Y ou must perform the tasks describe d in Ta b l e 3 - 2 after those described in Ta b l e 3 - 1 .
3-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configur ation Workflows and Checklists Technology Workflows Technology Workflows This section describes the tasks that you must perform when conf iguring Cisco B A C to support specif ic technologies; in this case, CWMP .
3-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configuration Wo rkflows and Checklists Technology Work flows Preregistering Device Data in Cisco BAC Preregisteri ng adds the de vice record to the RDU befor e the devi ce ma kes ini tial contact with th e DPE.
3-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configur ation Workflows and Checklists Technology Workflows Step 2 V erify whet her the de vice record is prereg istered.
3-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configuration Wo rkflows and Checklists Technology Work flows Configuring CWMP Service on the DPE Ta b l e 3 - 4 identifies the conf iguration tasks that you must perform to conf igure the CWMP services o n the DPE.
3-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configur ation Workflows and Checklists Technology Workflows Configuring HTTP File Service on the DPE Ta b l e 3 - 5 identifies the conf iguration tasks that you must perform to conf igure the HTTP f ile services running on the DPE.
3-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configuration Wo rkflows and Checklists Technology Work flows Configuring HTTP Auth Service on the DPE Ta b l e 3 - 6 below identif ies the configuratio n tasks that yo u must perform to conf igure the A U TH services on the DPE.
3-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configur ation Workflows and Checklists Technology Workflows T o configure the A CS URL of a provisioni ng group from the admini strator user interface: Step 1 On the primary n avigation bar , click Servers > Pr ovisioning Gr oups .
3-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 3 Configuration Wo rkflows and Checklists Technology Work flows.
CH A P T E R 4-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 4 CPE Management Overview This chapter describes the management of customer premises equip ment (CPE) b y using the CPE W AN Management Prot ocol for Cisco Broa dband Access Cent er (B A C).
4-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Cisco BAC Device Ob ject Model Cisco BAC Device Object Model The Cisco B A C de vice object model is crucial in controllin g the confi guration and f irmware rules th at are generated as instructions for the DPE to manage devices.
4-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Cisco BAC Device Object Mode l Ta b l e 4 - 1 describes the attributes and relatio nships unique to each object in the data model.
4-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Discovering CPE Parame ters If the registered Class of Service for a de vice is ch anged, it re.
4-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Multi-Instance Object Suppo rt This instruction can be used to k eep the RDU up-to-da te on su ch ke y parameters as the softw are version and the model name.
4-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Multi-Instance Ob ject Support Configuration Template Earlier to this release of B A C, the scope of confi guration template rep resented only the possible set parameter v alues and set parameter attrib utes that could be performed.
4-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Multi-Instance Object Suppo rt • Index - This option can be used for direct indexing and accepts a v alid positiv e integer . This is the index in to the returned instance names.
4-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Multi-Instance Ob ject Support </ObjectInstance> </ObjectInstance> </ObjectInsta.
4-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Multi-Instance Object Suppo rt The behavior of BA C to push the above template configuration d uring configuration sync is explained below: 1. B A C discovers the i nstances in the object De vice.
4-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Multi-Instance Ob ject Support 2. Next, B A C validates the e xpression. Since the e xpression parameters are conf igured with multi-instance object par ameters, B A C f irst discov ers and identify th e instances to e v aluate the expression.
4-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Multi-Instance Object Suppo rt Y ou can specify multi-instance parameter name in the e xpression, and the discov er mechanism of these objects can be conf igured using the ne wly intr od uce template element InstanceConfiguration.
4-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Multi-Instance Ob ject Support </Instance> <Instance> <Path>Device.
4-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Multi-Instance Object Suppo rt Parameter Discovery Multi-instance object parameters can no w be specif ied in the data disco very . This support is extended for preregist ered and unregistered devices.
4-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Instruction Generation and Processing Instruction Generation and Processing Instruction gener ation is the process of generating specif ic instruction sets fo r CWMP de vices.
4-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Instruction Generation and Processing • Data Synchronization Instru ction (DataSyncRecord)—K e eps the RDU up-to-date on v arious CPE parameters, such as the software v ersion and the mod el name.
4-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Device Deployment in Cisco BAC During the pr ocess of configuration sync hronization: 1. The DPE receives a Pa r a m e t e r K e y from the device.
4-17 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Device Depl oyment in Cisco BA C Cisco B A C pro vides two de vice deployment options, which c.
4-18 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Initial Provisioning Flows Note W ith no preregiste red device data av ailable, the ch ances of a Denial of Service attack increase, as unknown de vices are not authentic ated.
4-19 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Initial Provisioning Flows d. The de vice instruction set is forwarded to the DPE and cached there. Now , the DPE is programmed to handle sub sequent CPE protocol interactions for thi s dev ice autonomously from t he RDU.
4-20 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Assigning Devic es to Provisioning Groups Assigning Devices to Provisioning Groups Devices can be assigned to a pr ovisioning group in thr ee ways: explicitly , automaticall y , or using a combination of both.
4-21 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Device Diagnostics Device Diagnostics CWMP supports de vice troubleshoot ing and diagnostics fe atures that you use to focus on a sin gle device and collect diagnostics inform ation for further analysi s.
4-22 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Configuring SNMP Trap for CPEs The follo wing components are conf igured in Cisco BA C for SNM.
4-23 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Overvie w Configuri ng SNMP Trap fo r CPEs • ManagedObjectInstance • EventT ype • ProbableCause • Specif icProblem • Perceiv edSe verity • AdditionalT ext • AdditionalInfor mation These SNMP alarm property values can be conf igur ed in dpe.
4-24 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 4 CPE Management Over view Configuring SNMP Trap for CPEs For det ails on ho w to add these proper tie s in the device property hierarchy , see Modifying Dev ice Records, page 16-11 .
CH A P T E R 5-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 5 Configuration Templates Management This chapter det ails the templates that Ci sco Br oadband Access Center (B A C) supports for device configuration and device management .
5-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Overview The syntax and content of the processed conf iguration te mplate is vali dated when it is added to the Cisco B A C system, ensuri ng that the XML templa te is well-f ormed.
5-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Overview Cisco B A C supports multip le instance object which is a v ailable in the confi guration template.
5-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Features of Cisco BAC Templates Features of Cisco BAC Templates A conf iguration template is a collecti on of Objects and Pa rameters.
5-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Features of Cisco BAC Templates A conf iguration template comprises t he follo wing components: • ObjectInstance —Represents an instan ce of a TR-069 CPE node.
5-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Features of Cisco BAC Templates Parameters This section describes the schema associated with parameter objects in the co nfiguratio n templates (see Figure 5-2 ).
5-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Features of Cisco BAC Templates Example 5-1 illustrates h ow you can configu re v alues for a parameter: Example 5-1 Con figuring P arameter V alues <tc:Template xmlns:xsi="http://www.
5-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Features of Cisco BAC Templates Notification By using the Ci sco B A C Notif ication attrib ute, a de vice can no tify the DPE of parameter v alue changes.
5-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Features of Cisco BAC Templates <Value>www.
5-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Features of Cisco BAC Templates Figure 5-3 illustrates the schema of t he prerequi.
5-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Features of Cisco BAC Templates Expressions Expressions are conditionals that use information from de vice properties. They may u se Parameters, InformParameters or rpcAr guments.
5-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Features of Cisco BAC Templates Example 5-3 Configuring M aintenanceWindo w In the following e xample, the values of the StartT ime , Durat ion, and DayOfW eek tags define the period when this rule is in ef fect.
5-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Features of Cisco BAC Templates For detailed information on PeriodicInformI nterval , see the Broadb and Forum’ s T echnical Report on TR-069.
5-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Authoring Configuration Templates Authoring Configuration Templates Y ou can use Cisc o B A C to gene rate instructio ns for custom ized configurations for many devices from a single template by using template constructs.
5-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Authoring Co nfiguratio n Templat es Config uration templates support: • Paramete.
5-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Authoring Configuration Templates </ObjectInstance> </ObjectInstance> .
5-17 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Authoring Co nfiguratio n Templat es Note The API constant for /IPDevi ce/connectionRequestPath is IPDeviceKeys .CONNECTION_R EQUEST_PATH .
5-18 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Authoring Configuration Templates </Parameter> <Parameter> <Name>.
5-19 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Authoring Co nfiguratio n Templat es </Configuration> </tc:Template> Using Conditionals Cisco B A C supports po werful conditional expression s in template constructs to provide ulti mate configuration customization.
5-20 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Authoring Configuration Templates XML does not support t he left angle bracket (<) an d the ampersand (&). Inst ead, use the predefined entities (described in Ta b l e 5 - 3 ) for these characters.
5-21 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Authoring Co nfiguratio n Templat es <tc:if test="contains(VAR(name=/cpe/Us.
5-22 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Using the Configuration Utility <tc:choose> <tc:if test="contains(VA.
5-23 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Using the Configuration Utility Running the Configuration Utility In subsequent procedures and examples, the phrase running the configur ation utility means to enter t he runCfgUtil.
5-24 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Using the Configuration Utility If the template uses VAR() constructs to reference a de vice property , use the de vice option to generate a sample template.
5-25 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Using the Configuration Utility • -cwmp —Identif ies the input f ile to be processed as a CWMP template f ile. • -a sc —Specifies a syntax check.
5-26 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Using the Configuration Utility Step 3 Run the conf iguration utilit y by using thi s command: ./opt/CSCObac/rdu/bin/runCfgUtil.sh -cwmp -a gc -l sample-cwmp-config.
5-27 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Configur ation Templates Management Using the Configuration Utility Testing Template Processing for a Cisco BAC Template File and a Device Use the runCfgUtil.sh command to test the template processing for a file st ored in the RDU database and associated with a device.
5-28 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 5 Co nfiguration Templates Manage ment Using the Configuration Utility Note Y ou can open the output.xml f ile to view the configuration . The VAR(name=/IP Device/connec tionRequestUse rname, defaul tValue=test) st atement will be replaced with testUser .
CH A P T E R 6-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 6 Firmware Management This chapter describes f irmware management for TR-069 compliant devices in Cisco Broa dband Access Center (Cisco B A C).
6-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Firmware Management Mechanisms This do wnload can be initiated in v arious modes: • Firmware-r ule based, in which f irmware rules may or may not allo w the do wnload of the f ile requested b y a de vice, or ma y down load a dif feren t file.
6-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Mana gement Firmware Manageme nt Mechanisms In this model, you can make con venient updates to the def inition of th e rules, which apply to a lar ge number of de vices.
6-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Firmware Management Mechanisms Direct Firmware Management The Cisco B A C de vice operations API allo ws the OSS to execute op erations on indi vidual de vices.
6-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Mana gement Managing Firmware File s File Service In the process of firmw are management and regardle ss of which managemen t method is used, the devi ce is instructed to obtain a ne w firmware f ile from a fi le server .
6-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Authoring Firmware Rules Templates Authoring Firmware Rules Templates Firmware rule templates in Cisco B A C are based on an XML schema f ile located at <BPR_HOME> /rdu/templates/ cwmp/schema/Firmwa reT emplateSchema.
6-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Mana gement Authorin g Firmware Rules Templat es – Expression—Zero or more e xpression for e valuating this r ule; has the same syntax and def inition as the Expression def ined for the Fi r m w a re R u l e element.
6-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Authoring Firmware Rules Templates <Value>3 SCHEDULED</Value> <Operator>match</Operator> </Expression> Cisco B A C supports the follo wing parame ter names in the Inf ormParameter tag: • Inform.
6-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Mana gement Authorin g Firmware Rules Templat es • noMatch—Specifies that the de vice parameter va lue must not match an y of the v alues in a case-sensitiv e comparison.
6-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Authoring Firmware Rules Templates <Value>1.
6-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Mana gement Authorin g Firmware Rules Templat es • F ileSize —Specifies the size of the f ile. This is mandatory when the location is File System. The FileSize can also be set to 0.
6-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Authoring Firmware Rules Templates <MaintenanceWindow> <StartTime>01:00:00</StartTime> <Duration>5:00</Duration> </MaintenanceWindow> <Expression> <InformParameterName>Device.
6-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Mana gement Using Template Constructs wi th Fir mware Rule T emplates <Expression> <InformParameterName>Device.DeviceInfo.SoftwareVersion</InformParameterName> <Value>5.
6-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Using Template Constructs w ith Firmware Rule Templates • <BPR_HOME>/rdu/templates/cwmp/sch ema/FirmwareT emplateSchema.xsd • <BPR_HOME>/rdu/templates/cwmp/sch ema/CommonT emplateConstructs.
6-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Mana gement Using Template Constructs wi th Fir mware Rule T emplates Using Conditionals Cisco B A C supports po werful conditional expression s in template constructs to enable ul timate configuration custom ization.
6-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Using Template Constructs w ith Firmware Rule Templates.
CH A P T E R 7-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 7 Parameter Dictionaries This chapter describes P arameter Dictionaries w hich are used in the process of conf iguring and managing customer p remises equipment (CPE) for CWMP .
7-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 7 Parameter Dictionaries Using Default Dictionaries Figure 7-1 illustrates the schema of a parameter di ctionary .
7-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 7 Pa rameter Dictionaries Custom Dictionaries These default dictionaries are located at: • <BPR_HOM E>/rdu/tem plates/cwm p/dictio nary/tr069 -cwmp-dic tionary .x ml • <BPR_HOM E>/rdu/tem plates/cwm p/dictio nary/tr104 -cwmp-dic tionary .
7-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 7 Parameter Dictionaries Parameter Dictionary Syntax Cisco B A C supports all data types that are defi ned i n the TR-069 and TR-196 specif ication.
7-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 7 Pa rameter Dictionaries Managing Parameter Dictiona ries through User In terface <Object name="DeviceInfo"&.
7-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 7 Parameter Dictionaries Managing Parameter D ictionaries through Use r Interface Viewing Parameter Dictionaries T o view the content of a f ile in the Cisco B AC RDU d atabase: Step 1 Choose Conf iguration on the Primary Na vigation b ar .
7-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 7 Pa rameter Dictionaries Managing Parameter Dictiona ries through User In terface Step 5 Click Submit.
7-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 7 Parameter Dictionaries Managing Parameter D ictionaries through Use r Interface.
CH A P T E R 8-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 8 CPE History and Troubleshooting This chapter describes ho w to troubleshoot the de vice using de vice informatio n.
8-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troublesho oting Device H istory UpdatedV iaAPI Recorded when a device record stored at the RDU was modi fied using th e client API. time : Device record was updated re a s o n by u se r username .
8-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troub leshooting Device History ReportedNe wConf ig Recorded when a de vice reports using a ne w conf iguration using the Pa r a m e t e r K e y contained in the Inform message.
8-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troublesho oting Device H istory Configuring Device History Y ou use the De vice History feature to record signif icant e vents in a de vice-provisioning lifecycle.
8-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troub leshooting Device History Configuring Device History Size T o configure the maxi mum number of de vice history ent ries from the administrator user interface, choose Conf iguration > Defaults > System Defaults .
8-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troublesho oting Device Faults Step 3 Click the radio b uttons corresponding t o the operation you w ant.
8-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troub leshooting Device Faults The follo wing operations monit or de vice faults on the RDU and the DPE: The RDU and the DPE maintain a li st of recurring f a ults.
8-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troublesho oting Device Faults • Servers > DPEs > Manage De vice Pro visioning Engines > V iew Device Pr ovisioning Engin es Details —Displays the number of de vices with faults, if an y .
8-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troub leshooting Device Troubleshooting Managing Chatty Clients In this release of Cisco B A C, you can use t he Chatty client feature to detect devi ces that make an excessi ve number of TR-069 or HTTP f ile server ca lls.
8-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troublesho oting Device Tr oubleshooting T roubleshoot ing information is stored centrally at the RDU and is maintained for each device. The DPEs do not store this data.
8-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troub leshooting Device Troubleshooting Step 3 Click the Identif ier link correspon ding to the de vice that yo u want to track . The Modify De vice page appears, li sting v arious de vice parameters.
8-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 8 CPE History and Troublesho oting Device Tr oubleshooting Viewing Device Troubleshooting Log Y ou can vie w the troubleshootin g log fil e of a specifi c device in o ne of two ways.
CH A P T E R 9-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 9 Managing Cisco Broadband Access Center This chapter describe s the various subcomponents wi thin Cisco Broa dband Access Ce nter (B A C) that you can use to manage the system .
9-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 9 Ma naging Cisco Broadband Access Center Cisco BAC Proce ss Watchdog For e xample: • Process A fails. • The Cisco B A C process wa tchdog server sends an SNMP trap informing the critical condit ion associated with the process A.
9-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 9 Managing Cisco Br oadband Acce ss Center Cisco BAC Process Watchdog When the operating syst em (Solaris and Linux) is rebooted, the Cisco B AC process w atchdog is f irst stopped, allo wing Cisco B AC serv ers to shut do wn properly .
9-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 9 Ma naging Cisco Broadband Access Center Administrator U ser Interface T o enable SNMP trap for Cisco B A C process watchdog : Step 1 Log into Cisco BA C host as root. Step 2 Set the follo wing parameters in CbsServerT able.
9-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 9 Managing Cisco Br oadband Acce ss Center Command Line Interface Command Line Interface The Cisco B AC CLI is an IOS-lik e command line inte rface which you use to conf igure as well as view the status of the DPE b y using T elnet.
9-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 9 Ma naging Cisco Broadband Access Center SNMP Agent Accessing the DPE CLI from a Local Host T o a ccess the CLI from a lo.
9-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 9 Managing Cisco Br oadband Acce ss Center Cisco BAC Tools Cisco BAC Tools Cisco B A C pro vides automated tools that you use to p erform certain functions more ef f iciently .
9-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 9 Ma naging Cisco Broadband Access Center Cisco BAC Tools.
CH A P T E R 10-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 10 Database Management This chapter con tains informatio n on RDU da tabase manage ment and main tenance. The RD U database is the Broadband Access Center (B A C) central data base.
10-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 10 Data base Management Database Files Write-ahead logging requires these cond itions to work pr operly: • Y ou must set up the f ile system an d physical storage so that they gu arantee that the data is flushed to physical storage when requested.
10-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 10 Database Management Disk Space Requirements Automatic Log Management Database transaction logs f iles are used to store transa ction d ata until that data is co mpletely written into the database.
10-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 10 Data base Management Backup and Re covery Handling Out of Disk Space Conditions When the RDU server runs out of di sk space, it genera tes an alert th rough the syslog facil ity and the RDU log.
10-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 10 Database Management Backup and Recovery • As illustrated in the follo wing example, this tool autom atically creates a time stamped subdirectory , under the directory you speci fy and places the backups there.
10-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 10 Data base Management Backup and Re covery Examples Here is an example of using the r ecove rDb.
10-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 10 Database Management Changing Database Location Changing Database Location Y ou can mo ve the d atabase from one partition o r disk to another on the sam e system. Y ou might sometimes want to do this for admi nistrativ e reasons.
10-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 10 Data base Management Changing Database Loca tion.
CH A P T E R 11-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 11 Monitoring Cisco Br oadband Access Center This chapter describes ho w you can monitor the cen tral RDU se rvers a nd the DPE ser vers i n a Cisco Broadband Access Center ( B A C) deplo yment.
11-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Syslog Alert Messages • Messag e —Provides th e alert text or message. RDU Alerts T able 11-1 identif ies the RDU alerts. DPE Alerts Whene ver a DPE syslog alert is sent, you can find additional details in the DPE logs.
11-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Syslog Alert Messages T able 11-2 identif ies the DPE alerts. T able 1 1 -2 DPE Aler ts Alert Description DPE-1-102: DPE ran out of di sk space The st orage partition that the DPE serv er uses ran out of space.
11-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Syslog Alert Messages Watchdog Agent Alerts Whene ver the watchdog process sends a syslog aler t, you can f ind error details (if an y) in the <BPR_D A T A>/agent/logs/ag ent_console.
11-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Monitoring Servers by Using SNMP • stun • tomcat • cli • snmpAgent .
11-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Monitoring Servers by Usin g SNMP SNMP Agent The Cisco B A C SNMP agents suppor t SNMP informs and trap s, collec tiv ely called as no tifications hereafter .
11-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Monitoring Servers by Using SNMP Note The default port number of an SNMP agent is 8001.
11-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Monitoring Servers by Usin g SNMP Examples # ./snmpAgentCfgUtil.sh delete host test.cisco.com OK Please restart [stop and start] SNMP agent.
11-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Monitoring Servers by Using SNMP Deleting an SNMP Agent Community Y ou use this command to delete an SNMP community string to prevent access to the SNMP agent.
11-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Monitoring Servers by Usin g SNMP Examples # .
11-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Monitoring Servers by Using SNMP Examples In this example, the contact name is Ace Duffy and the tele phone extension i s 1234 : # .
11-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Monitoring Server Status Notification Timeout : 1000 Notification Recipient.
11-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Monitori ng Server St atus BAC Agent is running Process dpe is not running This result occurs wh en the DPE is not running. dpe# show dpe BAC Agent is running Process dpe is running Broadband Access Center [BAC 3.
11-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Monitoring Performance Statistics service http 2 enabled false service http.
11-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Monitoring Performance Statistics Understanding perfstat.log Y ou can monitor performance statistics b y using the data recorded in th e perfstat.
11-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Monitoring Performance Statistics • component —Specif ies the Cisco BA C component for which you w ant to analyze stat istics.
11-17 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Monitoring STUN Statistics 2006-04-11:13:09 PACE statistics last 5 minutes.
11-18 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Traffic Profiling Number of UDP Connection Request Failure (Binding Mapping.
11-19 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisco Br oadband Acce ss Center Traffic Profiling • AddObject • DeleteOb ject • Download • Reboot .
11-20 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 11 Monitoring Cisc o Broadband Access Center Traffic Profiling.
CH A P T E R 12-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 12 Configuring CWMP Service This chapter describes how to conf igure the CWMP service in Cisco Broadband Access Center (BA C).
12-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Connection Request Service Configuring Service Ports on the DPE Y ou can conf igure the po rts on which the CWMP services communicate with a device.
12-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Connection Request Service Figure 12-1 Connection Req uest in BAC Configuring Connection Requ.
12-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Connection Request Service If you do no t specify a Connection Request passw ord, a Connection Request password is automatical ly generated for the de vice using the connection request master secret .
12-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Connection Request Service • If the username and password are present o nly on the conf iguration template (and not i n the device record), this password is used inst ea d of the auto-gen erated pas sword.
12-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Connection Request Service Y ou can also specify these properties on the administrator user inte rface: Step 1 Choose De vices > Manage Devices .
12-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Connection Request Service b. Click the Identif ier link correspon ding to the desired de vice.
12-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Connection Request Service Configuring STUN Parame ters (Annex G) Cisco B A C now includes the TR-069 Annex G suppor t for remotely managing CPE de vices which are connected thro ugh a NA T gateway .
12-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Connection Request Service When RDU receives the conn ection request message, it sends the me ssage to the CMHS serv er that is configured in the B AC properties hierarchy .
12-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Connection Request Service This Custom Propert y is not pre-defi ned by B AC. It needs to be created and populated with comma separated v alues of CMHS groups names.
12-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Connection Request Service Configuring Reachability Reachability plays an import ant role in conf iguring connection requests.
12-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Connection Request Service Y ou can co nfigure data d iscovery at the RDU.
12-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Connection Request Service • Inform.DeviceId.Manufacturer • Inform.DeviceId.ManufacturerOUI • Inform.De viceId.ProductClass • InternetGate wayDe vice.
12-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Connection Request Service V iew de vice log dpe# show log dpe# show log last 100 dpe# show log run Note Y ou can use any of the three listed commands.
12-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Connection Request Service Note Y ou can use the pro visioning API to ex ecute many of t he operations that are possible from th e administrator user int erface.
12-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Provisioning Group Scalability and Failover Provisioning Group Scalability and Failover This section descri bes the scalability and f ailov er f eatures pro vided in this release of Cisco B A C.
12-17 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 12 Configuring CWMP Service Provisioning Group Scalability a nd Failover T ypically , you can config ure regional redun dancy b y using DNS techniq ues.
12-18 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 1 2 Configu ring CWM P Service Provisioning Group Scalability and Failover Adding DPE to a Provisioning Group This section describes ho w to add a DPE to a ne w provisi oning group.
CH A P T E R 13-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 13 Configuring CWMP Service Security This chapter describes security options for Cisc o Broadb and Access Center’ s (B A C) CWMP services, including authentication and encryptio n.
13-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Key and Certificate Manageme nt in Cisco BAC Cisco B A C supports a unique option of performi ng client -certif icate authentication at a hardware lo ad balancer and SSL accelerator s uch as Cisco A CE 4710.
13-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring SSL Service As defined in the TR-069 speci fi cat ion, the A CS URL must be identical to the Commo n Name (CN) v alue of the server certif icate, which is imported int o the keysto re.
13-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring SSL Service T o configure a server certif icate: Step 1 Create a new serv er ke ystore with a ne w priv ate ke y by using k eytool.
13-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring SSL Service • ke ystor e -passwor d —Identif ies the pri vate k ey passw ord and the ke ystore password that you used when you created your k eystore f ile.
13-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring SSL Service Note For additional inform ation on keytool and genera l certificate-management concepts, refer to Sun Microsystems documentation.
13-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring SSL Service [Unknown]: MA What is the two-letter country code for this unit? [Unknown]: US Is CN=train-1.bac.test, OU=BAC Training, O="Acme Device, Inc.
13-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring SSL Service The keytool -certreq command parameter generates a certif icat e-signing request (CSR). This command generate s the CRS in the indus try standard PKCS #10 format.
13-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring SSL Service Note The cacerts f ile b undled with Ci sco B A C ships with se veral root certif icate common third-party sig ning authorities.
13-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring SSL Service Importing Certificates fo r Client Authentication This step i s required only if you ha ve configu red client authenti cation b y using client certif icates on the DPE.
13-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring Security fo r DPE Services Configuring Security for DPE Services This section describes h ow to configu re authentication options and conf igure SSL on the DPE services.
13-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring Security for DPE Services % OK (Basic authentication was enabled.
13-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring Security fo r DPE Services dpe# dpe reload Process dpe has been restarted. % OK Note For detailed in formation , see the Cisco Br oadband Access Center 3.
13-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring Security for DPE Services T o configure authen tication in the Basic o.
13-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring Security fo r DPE Services Figur e 13-1 Change P assw ord Flo w After the pa ssword is changed on the d evic e object in the RDU, t he change password instruction is included in the de vice configuration.
13-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring Security for DPE Services Step 5 Click Submit . The password is no w changed on the de vice record in the RDU; no change of passwor d on the actual de vice is initiated after this pr ocedure.
13-17 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring Security fo r DPE Services Authentication Options in Cisco BAC This s.
13-18 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Configuring Security for RDU Services Configuring Security for RDU Services Cisco B A C supports local authentication as well as T A CA CS+ authentication.
13-19 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Configuring Security for RDU Service s Y ou can select one of the auth entication modes by usi ng the administrator user interface. Local authentication optio n is the default.
13-20 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Signed Configur ation for Devices Signed Configuration for Devices Cisco B A C use.
13-21 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Config ur ing CWMP Service Security Signed Configuration for Device s These properties can be configured using the CWMP Defaults page in the administrator user interface or by using t he IPDevice .
13-22 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 13 Configuring CWM P Service Security Signed Configur ation for Devices – Incompatible de vice.
CH A P T E R 14-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 14 CWMP Device Operations This chapter describes the device operations mechanism in Cisco Br oadband Access Center (BA C).
14-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CW MP Device Operations Connection Modes for Device Operations All de vice operations are e xecuted before other conf ig uration services, such as data synchronizati on, confi guration synchronizati on, and f irmware rules do wnload.
14-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CWMP Device Operatio ns Connection Modes for Device Operations Note Before attempting to run immediate operations ag ains t a device, ensure that th e device is reachable and that Cisco B A C is configured to perfor m connection requests to the de vice.
14-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CW MP Device Operations Connection Modes for Device Operations Figure 14-2 ill ustrates the high-le vel fl o w for on-connect operations.
14-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CWMP Device Operatio ns Connection Modes for Device Operations Asynchronous Mode Asynchronous mode facili tates the RDU to ex ecute the asynchronous immediat e operation without reserving a P A CE thread for the complete operation.
14-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CW MP Device Operations Managing a Device’s Provisionin g Group Note Y ou must use the batch mode flag , ASYNC_A UTOMA TIC durin g the asynchronous operation mode. The API command Configuration.
14-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CWMP Device Operatio ns Managing a Device ’s Provisioning Group • Correcting a De vice’ s Provisioning Group, page 14- 8 .
14-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CW MP Device Operations Managing a Device’s Provisionin g Group Figur e 14-4 Redirecting CPE t o Home Pr ovisioning Gr oup 1. The CPE attempts to establish a session wit h DPE 1 in provis ioning group 1 (PG 1).
14-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CWMP Device Operatio ns Managing a Device ’s Provisioning Group The Manage De vices page appears. Step 2 Click the Identif ier link correspon ding to the correct de vice.
14-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 14 CW MP Device Operations Managing a Device’s Provisionin g Group.
CH A P T E R 15-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 15 Understanding the Administrator User Interface This chapter describes how to access the Cisco Br oadband Access Center (BA C) administrator user interface and explains the interf ace.
15-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 15 Understanding the Administrator User Interface Accessing the Administrator Us er Interface • /adminui/maxRetu rned—Specifies th e maximum number of search results. This n umber is, by defaul t, 1000.
15-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 15 Understanding the Administra tor User Interface Accessing the Administrator User Inte rface Complete this procedure to access the administrator user interface: Step 1 Launch your web bro wser .
15-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 15 Understanding the Administrator User Interface Understanding the Administrator User Interfa ce Icons Logging Out T o log out of Cisco B AC: Step 1 Click Logout at the top ri ght corner of an y page.
CH A P T E R 16-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 16 Using the Administrator User Interface This chapter describes the admin istration tasks performed from the Cisco Broadb and Access Center (B A C ) administrator user i nterface.
16-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface User Management Read/Write User As a Read/Write user, you can perfo rm th e same functions as the administrator e xcept creating other users, changing the use r types of others, or changing their passwords.
16-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface User Management Step 4 Confir m the ne w user’ s password, an d select whether the ne w user’ s role is to be read only or read/write.
16-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Deleting Users Only the administrator can delete an y other user th at ap pears in the Manage Users page. Y ou cannot delete th e default user, called bacadmin .
16-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Figure 16-2 Manage Devices P age Searching for Devices By using Cisco B AC, you can search fo r devi ce information in a n umber of dif ferent ways.
16-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Some searches that you can perform allow the use of a wildcard character (* ) to enhance the search function. Cisco B AC p rovides specif ic wi ldcards for each search, as described in T able 16-1 .
16-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Device Management Controls These buttons are located di rectly belo w the search fu nction fields and are generally used in conj unction with the search funct ion.
16-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Figure 16-3 pro vides a sample De vice Details page. Figure 16-3 Device Details P age T able 16-2 identif ies the f ields sho wn in Figure 16-3 .
16-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Home Pro visioning Group Identif ies the provisioning group t o which the de vice should belong. Old Provi sioning Group Identif ies the provisi oning group to which t he devi ce was earlier belonging.
16-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Managing Devices The Devices menu lets you add de vices to the RDU databases and update prep ro visioned data.
16-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t – Request Connection – Fac t or y R es e t – Display .
16-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Note See Database Rest ore, page 10-6 , for additional information if r estoration of a backed-up database becomes necessary .
16-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Some instruc tions cannot be automati cally regenerate d because th e Cisco BA C system cannot dete rmine if the change impacts device instructions.
16-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Step 1 From the Manage De vices page, locate the de vice which you want to unrelate from a group. Step 2 Check the check box corresponding to the device Identif ier , a nd click the Unrelate bu tton.
16-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Note For all of the abov e operations , if the de vice is not reachabl e, an error message appears.
16-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t Performing a Factory Reset T o reset device setti ngs to its original f actory settings: Step 1 From the Devi ces > Manage Devices page, lo cate the correct de vice.
16-17 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Device Managemen t • Device operation timeou t (in seconds)—Specifies the duration after wh ich the Ping operation times out.
16-18 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Group Managemen t Setting Device Operations Timeout Y ou can set the duratio n within which an operation i s to be ex ecuted on de vice.
16-19 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Group Management Figure 16-4 Manage Gr oups P ag e Adding a Group Type T o add a new gro up type: Step 1 Click the Groups tab to open the Manage Groups page.
16-20 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Group Managemen t If two member groups ha ve the same priority v alue, the group type names are sor ted in alphabetical order to decide the priority .
16-21 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Group Management Figure 16-6 Add Gr oup P age Step 3 Enter the name for the n ew gr oup. Group name can cont ain alphanumeric characters and o t her charac ters such as, underscore (_), hyphen (-) , period (.
16-22 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Serve rs Relating/Unrelating Groups to Groups The relate and unrelate functions are used to establ ish a relationship between group objects.
16-23 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Servers Figure 16-7 View Device Pr ovisioning Engine Details Pag e T able 16-3 identif ies the f ields and b uttons sho wn in Figure 16-7 .
16-24 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Serve rs State Identif ies whethe r the DPE is ready for op erations.
16-25 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Servers Viewing Network Registrar Extension Point Details The NRs option, from the Servers menu, di splays the current v alues for the network re gistrar e xtension points.
16-26 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Serve rs Viewing Provisioning Groups The Manage Provisi oning Groups page lets you mon itor all current provi sioning groups.
16-27 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Servers Viewing Regional Distribution Unit Details The RDU option, from the Serv ers menu, displays details of the RDU. Figu re 16-10 illustrates a sample RDU details page.
16-28 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Serve rs T able 16-6 View RDU Detail s P age Field or Button D escription Regional Distribution Unit Details Host Name Identifies the host name of the system that is running the r egional distrib ution unit.
16-29 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Servers Regeneration rate Identif ies the cumulati ve rate of de vice instructions regenerated since the regeneration proc ess started.
16-30 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 16 Using the Administrator User Interface Viewing Serve rs.
CH A P T E R 17-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 17 Configuring Broadband Access Center This chapter describes the Cisco Broadband A ccess Ce nter (B A C) conf iguration tasks that you perform by selecting the opt ions in the Conf iguration menu.
17-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring the Class of Service T able 17-1 identif ies the f ields and b uttons sho wn in Figure 17-1 . T able 17-2 identif ies the f ields and b uttons sho wn in the Add Class of Service page.
17-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Configuring the Class of Service Adding a Class of Service T o add a specific Class of Service: Step 1 Choose Conf iguration on the Primary Navigation bar .
17-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring the Class of Service Note Changes to the Class of Service object trigger th e Instruction Generation Ser v ice (IGS) to regenerate instructions for all affected de vices and send instructions to the DPEs .
17-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Configuring Custom Properties Ti p Where there are large numbers of de vi ces ass.
17-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring Defaults • Device T ype • System defau lts Group priorit ies in the property hierarchy (see Pr operty Hierarchy , page 4-4 ) are handled through group types.
17-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Configuring Defaults Step 3 Choose the correct defaul t type from the list to the left of the screen. The appropriate default s page appears.
17-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring Defaults Default Class of Serv ice C hanges to the de fault Class of Service ca use regeneration of instructions for all devices associated with the d efault Class of Service.
17-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Configuring Defaults STUN Enabled Check this box if you wan t the STUN server to b e enabled for the de vice. STUN Server Address Specifies the STUN server address.
17-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring Defaults RDU Defaults When you click the RDU default s link, the RDU Defaults page (see Figu re 17-3 ) appears. Use this page to conf igure settings af fecting RDU operations.
17-11 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Configuring Defaults System Defaults When you click the Systems Defaults li nk, the System Defaults page (see Figure 17-4 ) ap pears.
17-12 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring Defaults De vice History Identifies if logg ing de vice record and de vice conf igurations is enabled or disabled.
17-13 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Configuring Defaults TACACS+ Defaults When you click the T A CACS+ Def aults link, the T A CACS+ Def aults page appears.
17-14 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring Defaults T A CA CS Server 1 Specifies the IP address or the hostname of t he T A CA CS+ server that has the highest priority and serves as the f irst choice for the T A CA CS+ clients.
17-15 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Managing Files If you remov e one T A CA CS+ server and replace i t with another server , the newly ad ded server will ha ve the same priority as the remo ved serv er .
17-16 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Managing Files Figure 1 7-6 Manage Files P age T able 17-7 identif ies the f ields and b uttons sho wn in Figure 17-6 . T able 17 -7 Manage Files P age Field or Button Description File T ype File T ype Identifies the f ile type.
17-17 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Managing Files Adding Files T o add an existing f ile to the RDU database: Step 1 Choose Conf iguration on the Primary Navigation bar .
17-18 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Managing Files Viewing Files T o view the contents of a file: Step 1 Choose Conf iguration on the Primary Na vigation b ar . Step 2 Choose Files on the Secondary Na vigation bar .
17-19 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Managing Files Exporting Files Y ou can cop y files to you r local hard dri ve b y using the e xport function. Note The procedure described belo w assumes that you are using Internet Explorer .
17-20 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Managing License Keys Managing License Keys Software licenses are used to activ ate specific fe atures or to increase the f unctionality of y our installatio n.
17-21 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Managing DPE Feature Pack Extension s Adding and Modifying a License T o add, modify , or upgrade a license: Step 1 Choose Conf iguration on the Primary Navigation bar .
17-22 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Managing DPE Featur e Pack Extensions Writing a New Class for DPE Feature Pack Extensions This procedure illustrat es how to writ e a new cl ass for DPE feature pack extension.
17-23 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Managing DPE Feature Pack Extension s C:> Note Y ou can give the J AR file any name. The name can b e descriptive, b ut do not dup licate anothe r existi ng J AR filename.
17-24 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Managing DPE Featur e Pack Extensions Managing e xtensions includes: • Writin.
17-25 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Managing DPE Feature Pack Extension s Jav a J AR file manifests contain attrib utes that are formatted as name-v alue pairs and support a group of attributes that prov ide pack age versioning information.
17-26 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Publishing Provisioning Data Viewing RDU Extensions Y ou can vie w the attributes of all RDU e xtensions directly fro m the V iew Re gional Distrib ution Unit Details pag e.
17-27 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configuring Broadband Access Cente r Configuring Lease Query T able 17-9 identif ies the f ields sho wn in the Modify Publishing Plug-Ins p age. Step 4 Enter the required v alues in the Serv er , Port, IP Address, User , Password, and Conf irm Pa ssword fi elds.
17-28 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 17 Configu ring Broadband Acce ss Center Configuring Lease Qu ery.
CH A P T E R 18-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 18 Scripting Framework This chapter describes t he Scripting frame work i n Cisco B A C that in volv es conf iguring ja v a script based DPE extensions .
18-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 18 Scripting Fr amework Extension Script By default th e follo wing frequently used Ja v a packages are imported into th e Script's Shared Scope: java.lang.*; java.util.
18-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 18 Scripting Framewor k Integrating Extension Scripts in B AC // With continuation support, the script gets the // respon.
18-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 18 Scripting Fr amework Configuring Extension s for Unknown Devices T o add scriptable extensions at CWMP Def aults le vel: Step 1 Choose Conf iguration on either the p rimary nav igation bar or main menu pag e.
18-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 18 Scripting Framewor k Verifying Extension Scripts Availability in DPE Cache Verifying Extension Scripts Availability in.
18-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 18 Scripting Fr amework Verifying Status of the Extensio ns in DPE.
CH A P T E R 19-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 19 RDU and DPE Connection Management This chapter deals with RDU TCP Connection Ma nagement, RDU B atch Concurrency and RDU D PE synchronization .
19-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 19 RDU and DPE Conn ection Management RDU Batch Concur rency RDU Batch Concurrency In the Cisco BA C system , a provisioning client submits API re quests to the RD U in the form of ba tches containing single o r multiple commands.
19-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 19 RDU and DPE Con nection Management DPE-RDU Synchronization IPDevice Interface • addDeviceT ype • changeDefaults • deleteDeviceT ype • regenConf igs • IPDe vice.
19-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 19 RDU and DPE Conn ection Management DPE-RDU Synchronizatio n The DPE-RDU synchron ization is a process of au tomatically updat ing the DPE cache to be consist ent with the RDU.
CH A P T E R 20-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 20 Cisco BAC Support Tools and Advanced Concepts This chapter contains i nformation on, and e xplains th e use of, t.
20-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Sup port Tools and Advance d Concepts Using the deviceExpor t.sh Tool Y ou can generate the li st of properties predef ined in Cisco B A C and av ailable for export b y running the deviceExport.
20-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Support Tools and Advanced Conce pts Using the deviceExport.sh Too l <CONTROLFILE> <!--Start of field list(REQUIRED) The field list specifies the device properties that will be exported.
20-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Sup port Tools and Advance d Concepts Using the disk_monitor.
20-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Support Tools and Advanced Conce pts Using the resetAdminPassword.sh Tool Using the resetAdminPassword.sh Tool Cisco B A C supports both l ocal authentication and T A CACS+ aut hentication and you can u se the resetAdminP assword.
20-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Sup port Tools and Advance d Concepts Using the runE ventMonitor.
20-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Support Tools and Advanced Conce pts Using the runEventMonitor.sh Tool Syntax Description T o run the ev ent monitor , enter: # /opt/CSCObac/rdu/internal/bin/runEventMonitor.
20-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Sup port Tools and Advance d Concepts Using the chang eARProperties.sh Tool source=BPR Provisioning API:BPR Regional Distribution Unit:AddIPDevice command IP=null FQDN=null group=null Using the changeARProperties.
20-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Support Tools and Advanced Conce pts Using the changeNRPrope rties.
20-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 20 Cisco BAC Sup port Tools and Advance d Concepts Using the changeN RProperties.
CH A P T E R 21-1 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 21 Troubleshooting Bro adband Access Center This chapter pro vides the informati on on ho w to observe th e RDU and DPE logs, and troubleshoot Cisco BAC .
21-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troublesho oting Broadband Access Ce nter Logging Logging Logging of e v ents is performed at both the DPE and RDU, and i n some unique situations, DPE e vents are logged at the RDU to gi v e them higher visibility .
21-3 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troubleshooting Broadb and Access Center Logging Log Levels and Structures The log f ile structure is descr ibed here, and illustrated in Example 21-1 , and includ es: • Domain Name—This i s the name of the computer generating the log f iles.
21-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troublesho oting Broadband Access Ce nter Logging Configuring Log Levels Y ou can conf igure logging le vels for both the RDU and the DPE to su it your specif ic requirements.
21-5 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troubleshooting Broadb and Access Center Logging RDU Logs The RDU has two logs that it maintain s in the BPR_D A T A/r du/logs directory: • rd u . l og —Records all RDU ev ents according to the conf igured logg ing se verity le vel.
21-6 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troublesho oting Broadband Access Ce nter Logging W e recommend that you keep the RDU loggi ng le vel at th e W arning lev el to help maintain a st eady operations state.
21-7 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troubleshooting Broadb and Access Center Logging Step 3 Enter the RDU username at the pr ompt.
21-8 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troublesho oting Broadband Access Ce nter Logging DPE Logs The DPE maintains its logs at the BPR_D A T A/dpe/logs directory . • dpe.log —Records all e vents ha ving the configured def ault le vel.
21-9 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troubleshooting Broadb and Access Center Logging The syntax for setting the trace le vel is: trace [ server ] [level ] Ta b l e 2 1 - 3 Tr a c e L e v e l s Log Level Description 0 No trace performed.
21-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 21 Troublesho oting Broadband Access Ce nter Logging.
GL-1 Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 GLOSSARY A alert A syslog or SNMP message notify ing an operator or administrator o f a problem. API Application prog ramming interface. Specifi cation of functio n-call con ventions th at def ines an interface to a service.
Glossary GL-2 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 D device p rovisioni ng engine (DPE) DPE servers cache device instructions and perfo rm CWMP services. These di stributed ser ves automatically synchronize wit h the RDU to obtain the latest instruct ions and prov ide Cisco B A C scalability .
Glossar y GL-3 Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 P provisioning API A series of Cisco B A C functions that pr ograms can use to make th e operating system perform v arious functions.
Glossary GL-4 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 V Voice over IP (VoIP) Mechanism to make teleph one calls and send fax es ov er IP-based data ne tworks with a su itable quality of service (QoS) and su perior cost/benefit.
IN-1 Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 INDEX A ACS definition GL-1 URL, configuring 3-9 URL, discovery 2-6 administrator user int erface accessing 15-2 ACS URL, config.
Index IN-2 Cisco Broadband Access Cen ter 3.8 Administrator Guide OL-27172-01 B backup and recov ery of database 10-4 to 10-6 C caching, definition GL-1 cautions regarding custom properties, deleting .
Index IN-3 Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 CWMP 17-7 RDU 17-10 system 17-11 device history enabling, disabling 8-4 number of entries 8-5 viewing 8-4 discovering devi.
Index IN-4 Cisco Broadband Access Cen ter 3.8 Administrator Guide OL-27172-01 self-signed certificate, displaying 13-7 server certificate and private key, genera ting 13-6 signed certificate, verifyin.
Index IN-5 Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 relationships (table) 4-3 device operat ions about 14-1 conditional executi on 14-6 connection modes asynchronous 14-5 asy.
Index IN-6 Cisco Broadband Access Cen ter 3.8 Administrator Guide OL-27172-01 file service 6-5 firmware image 6-5 firmware rules template 6-5 firmware rules template authoring 6-6 constructs 6-13 expr.
Index IN-7 Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 log file, sample 21-3 log files, rotating 21-4 log leve ls, configuri ng 21-4 log levels an d structures 21-3 log leve l tool 21-5 current log lev el, viewing 21-7 setting 21-6 using 21-6 viewing log files audit.
Index IN-8 Cisco Broadband Access Cen ter 3.8 Administrator Guide OL-27172-01 redundancy 12-16 DNS round robin, usin g 12-17 hardware load balancer, using 12-17 local 12-16 regional 12-16 technology w.
Index IN-9 Cisco Broadband Access Center 3. 8 Administrator Guide OL-27172-01 contacts, setting up 11-10 hosts, adding 11-7 hosts, deleting 11-7 listening po rt, identifying 11-10 location, changing 1.
Index IN-10 Cisco Broadband Access Cen ter 3.8 Administrator Guide OL-27172-01 devices configuration history, viewin g 8-4 data discov ery 12-13 in troubleshootin g mode 8-9 recurring faults, viewing 8-7 performance statistics collection monitoring 11-14 perfstat.
An important point after buying a device Cisco Systems OL-27172-01 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Cisco Systems OL-27172-01 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Cisco Systems OL-27172-01 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Cisco Systems OL-27172-01 you will learn all the available features of the product, as well as information on its operation. The information that you get Cisco Systems OL-27172-01 will certainly help you make a decision on the purchase.
If you already are a holder of Cisco Systems OL-27172-01, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Cisco Systems OL-27172-01.
However, one of the most important roles played by the user manual is to help in solving problems with Cisco Systems OL-27172-01. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Cisco Systems OL-27172-01 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center