Cisco Systems OL-27172-01 manuel d'utilisation

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.8 A dministrator Guide April 02, 20 1 3 Text Part Number: OL -27172-01[...]

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. USERS MUST TAKE FULL RESPO NSIBILITY FOR THEIR APPLICATION OF ANY PRO[...]

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 Obtaining Documentation and Submitting a Serv ice Request xviii xviii CHAPTER 1 Broadband Access Center Ove rview 1-1 Features and Benefits 1-1 Supported Te[...]

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 Technology Wo rkflows 3-3 RDU Configuration Workflow 3-3 Preregistering Device Data in Cisco BAC 3-4 DPE Configuration Workflow 3-5 Configuring CWMP Service o[...]

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 Features of Cisco BAC Templates 5-4 Parameters 5-6 Parameter List for Single Instance Obje ct 5-7 Parameter List for Multiple Instance Objects 5-7 No[...]

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 ExternalFirmwareFile 6-11 Sample Firmware Rules Template 6-11 Using Template Constructs with Firmware Rule Templates 6-13 Using Parameter Substitution 6[...]

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 from the Command Line 9-2 Enabling SNMP Trap for Cisco BAC Process Watchdog 9-3 Administrator User Interface 9-4 Command Line Interface 9-5 Accessing t[...]

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 11-9 Stopping the SNMP Age nt 11-9 Configuring an SNMP Agent Listening Port 11-1 0 Changing the SNMP Ag ent Location 11-10 Setting Up SNMP Contac ts 11[...]

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 Load Balancer 12-17 Adding DPE to a Provisioning Group 12-18 CHAPTER 13 Configuring CWMP Service Sec urity 13-1 Overview 13-1 Key and Certificate Manag[...]

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-Connect Mode 14-3 Asynchronous Mode 14-5 Conditional Execution 14-6 Managing a Dev ice’s Provisioning Group 14-6 Redirecting CPE to Home Provision ing[...]

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 Modifying Group Types 16-2 0 Deleting Group Types 16-20 Managing Groups 16-2 0 Adding a New Group 16-20 Modifying a Group 16-21 Deleting Groups 16-21 Relati[...]

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-24 Installing RDU Cu stom Extensions 17-25 Viewing RDU Ex tensions 17-26 Publishing Provisioning Data 17-26 Publishing Datastore Chan ges 17-26 Modifyi[...]

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.log File 21-5 Viewing the audit.log File 21-5 The RDU Lo[...]

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. This chapter pr ovides an outline of th e other chapte rs in this guide, deta[...]

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. Chapter 2 Broadband Access Center Architecture Describes the systems ar chitecture implement[...]

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. Chapter 19 RDU and DPE Connection Managem[...]

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.com for any u pdates. Y ou can vie w the marketing and user documents for Cisco Br oadba[...]

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. W ith th[...]

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. Y ou can use the template-proc[...]

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. Ci sco B AC pro vides sev eral features to assist diagnosis: [...]

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. Cisco B A C provides t wo additional paramet er [...]

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. This chapte r includes the fol lo wing sections: • Cisco B A C Deployment , page 2-1 • Architecture, pa[...]

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 describes the basic Cisco B A C architecture including: • Regional Distr ibuti on Unit (RDU) that pro vides: – The authoritati ve d ata store of t[...]

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 . • Cisco Manageme[...]

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. – Support for [...]

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 . • Communication with CPE using HTTP and HTTPS for f ile download service. • Authentication an[...]

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. The f eature pack l[...]

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. This mechanis m is limited to deplo yments of primary Internet gate way de vices, bec[...]

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. Y ou can also acce ss the RDU and the DPE logs from the admi[...]

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. In this release, the LeaseQuery featur e is being used by Connection Request and Femto Authorization [...]

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. This chapte r includes the fol lo[...]

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 . Note Items marked with an asterisk (*) are mandat ory tasks or procedures. 5. Conf igure the RDU [...]

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 . These configurat ion tasks are performed after [...]

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. The DPE is also known as the autoconf iguration server (A [...]

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. T o do this: • Examine the Device Details. T o do this: From the Devi ces > Manage Devices page, click the V iew Details icon ( ) correspondin[...]

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. T able 3-4 DPE Configur ation W ork flow - CW MP Manag[...]

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. T able 3-5 DPE Configur ation W orkfl[...]

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. Provisioning Group Configuration Workflo[...]

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 . The Manage Provisi oning Groups pa[...]

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). This chapte r includes the fol lo wing sections: • CWMP Overvie w , page 4[...]

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. This process o[...]

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. Class of Service Class of Service is an RDU abstract ion that represents the con figuration to be handed to the de[...]

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 generates instructions for the g enerated dev ice conf iguration e ven if it is not the selected Class of Service, since it coul d impose a policy th[...]

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. These parameters may , in turn, be used to generate other instructions, su ch as confi[...]

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. There was no[...]

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. For ex ample, index v alue 1 returns the first instance. In conf[...]

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> </ObjectInstance> </ObjectInstance> </ObjectInstance> </ObjectInstance> </ObjectInstance> </ObjectInstance> </ObjectInstance>[...]

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.Services.F APService. by issuing GetParameterName[...]

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. Example 4-5 M[...]

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.Services.FAPService.</Path> <Value>last()</Value> </Instance> <MatchCondition>OR</MatchCondition> </InstanceConfiguratio[...]

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. Preregistered Devices For prere gistered d[...]

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. By using technology e xtensions, through wh ich dev ice technologies[...]

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. Thes e parameters may , in turn, be used in[...]

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. I f the v alue of this Pa r a m e t e r K e y matches the one stored in the DPE, no synchronizat[...]

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 can also be used in combination: • Preregistered—Th e de vice record is added to the RDU before the devi ce makes initial contact with the DPE, als[...]

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. Initial Provisioning Flows This section describes the conf iguratio[...]

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. After the de vice is a[...]

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. Explicit Assignment Y ou can e xpl[...]

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. This feature enables you to query de vi[...]

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 SNMP Trap f acility: • RDU, see Configuration at RD U Lev el, page 4-22 • DPE and T rap Receiv er , see Conf iguration at DPE Le vel, page 4-22 • D[...]

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 . Step 2 Config ure these properties to be a v ailable in /IPDevice/ properties/a vailabl[...]

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 . This chapte r includes the fol lo wing sections: • Overvie w , page 5-1 • Features of C[...]

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. This validation a lso ensures t hat parameter names[...]

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. This facili tates discov ering and updating parameters for the selectiv e object i nstances wit hout specif ying the object i[...]

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. In a TR-069 de vice, InternetGatewayDe vice is the root object, while in TR-106 device, De vice is[...]

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. Y ou must specify the object’ s ‘name. ’ An object may includ e [...]

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 ). Figure 5-2 P arameter Sc hema The CPE parameter contains a name- value[...]

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.w3.org/2001/XMLSchema-instance" xmlns[...]

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. Notifi cations, by def ault, are turned of f. If Notif ication is enabled, it[...]

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.sbc.com</Value> </Parameter> </ObjectInstance> </ObjectInstance> Access Control Access control in Cisco BA C is enabled through the AccessContr ol attrib ute of [...]

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 prerequisites option: Fi g u re 5 - 3 Pre re q u i s i te S ch e ma Y ou use prerequisites to manip ulate confi guration generation through : • Expressions [...]

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. Expressions are used within prer equisites and firmwa[...]

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. This template take [...]

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. Y ou can initiate a f irmwa re upgrade in a similar fashio n. Firmware upgrades are typi[...]

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. Parameter [...]

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: • Parameter substi tution—Substitutes v alues from the Cisco B A C property hierarchy int o XML element content and element attrib utes by using the VAR() con[...]

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> </Configuration> </tc:Template> T o configure custom pro perties from the administrator user interface, choose the Conf iguration > Cus[...]

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 . Example 5-12 Using a defaultValue With a Comma <Value>VAR(token=;;name=/cpe/usrStr; def[...]

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>PeriodicInformInterval</Name> <Value>30</Value> </Parameter> </ObjectInstance> </ObjectInstance> </Configurati[...]

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. Y ou[...]

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. The follo wing e xamples il[...]

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/UsrStr, defaultValue=linksys), 'cwmp')"> <Parameter> <Name>Enable</Name> <Value>false</Value> </Param[...]

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(VAR(name=FC-ACTIVATED-INFORM-ENABLE, defaultValue=false), 'true')"> <Parameter> <Name>PeriodicInformInterval</Name> [...]

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.sh command from the direct ory specified. T o run t[...]

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. Step 4 After all tests succeed, configure a Cl ass of Service to use the t[...]

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. • -r f ile —Identif ies the input f ile as a file that has been added to th[...]

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.xml -o output.xml • sample-cwmp-conf ig.xml —Identifies the inp[...]

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). This chapte r includes the fol lo wing sections: • Overvie w , page 6-1 • Firmware Management Mech anisms, page 6-2 •[...]

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. Fir m[...]

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. When the rules template is upda ted, CPE th at are indi rectly associate d with the templat[...]

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. Among other operation s, Cisco B A C provides standard CWMP RPC operations. Managing f ir[...]

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 . Cisco B A C provides a f ile service in[...]

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.xsd. Firmware rules e xecut[...]

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. For detailed information, see Expression[...]

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.DeviceId.Manufacturer ?[...]

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. • noMatchIgnoreCase—Specifies that the de vice parameter v alue must not match any[...]

6-10 Cisco Broadband Access Center 3.8 Administrator Guide OL-27172-01 Chapter 6 Firmware Management Authoring Firmware Rules Templates <Value>1.02</Value> <Operator>noMatch</Operator> </Expression> While specifying th e Rege x pattern, the operat or tag may be one of the foll owin g: • rege xMatch—Indicates a cond[...]

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. Examples <InternalFirmwareFile> <FileName>sample-firmware-imag[...]

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.DeviceInfo.EventCode</I[...]

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.4.1</Value> <Operator>match</Operator> </Expre[...]

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.xsd Note The XML namespace of the Cisco B A[...]

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. Y ou can u se these condi t ional ex press[...]

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 . This chapte r includes the fol lo wing sections: • Overvie w , page 7-1 • Using Defau[...]

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 . Figur e 7 -1 P aramet er Dictionary Schema Config uration or f irmware rules template processing f ails during instructi on generation if there are errors in[...]

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 .x ml • <BPR_H[...]

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. The Parameter Dictionary specif ies the data types that th is Cisco B A C release supports, as li sted in Ta b l e 7 - 1 : [...]

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"> <Writable>false</Writable> <Parameter> <Name>Manufacturer</Name> <Type>string(64)</Type> <Readable>[...]

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 . Step 2 Choose Files on the Seco[...]

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. After submitting the rep lacement file, a con firmation p age appears to indicate that, after replacement, Cisco B A C will re generate instru ctions for the af fected [...]

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. This chapte r includes the fol lo wing sections: • Device History , page 8 -1 • Dev ice Faults, page 8-6 • Device T roubleshooting , page 8-9 D[...]

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 . Example: T ue Jul 11 18:41:42 EDT 2006: Device record wa[...]

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. time : Device repo rted ne w configuration vers ion: configuration r evision[...]

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. This section describes how to enable or disable this feature. Enabling Device History Dev[...]

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 . Enter a v alue in the field co[...]

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 to enable or disable: • T o enable recording the history of immediate o perations, click the Enabled radio button corresponding to Immediate Operat[...]

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. Each f ault contains the date an d time of occurrence, the ID of the devi ce, and a fault[...]

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 . Against De vice with Faults, cli ck the Vi e w D e t[...]

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. Y ou can use this feat ure to [...]

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. Instead, t he DPE forwards this information to the RDU whi ch writes it to the de v[...]

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. Step 4 Click the Enabled radio b utton corresponding[...]

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. • Complete the procedure described in V ie wing List of De vices in T roubleshooting M[...]

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 . This chapte r includes the fol lo wing sections: • Cisco B A C Process W atchdog, page[...]

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. • The Cisco B A C process wa tchdog [...]

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 . T o shut down or rebo ot the operat[...]

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.xml f ile located at <BPR_HOME> /snmp/xml[...]

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. The CLI supports built-i n command help[...]

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 local host, you can use: # telnet localhost 2323 or # telnet 0 2323 Accessing the DPE CLI from a Remote Host T o a ccess the CLI from a remote host, ent[...]

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 . Ta b l e 9 - 2 lists the various tool s that this Cisco B A C release supports: T able 9-2 List[...]

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. The Cisco BA C RDU requires virtually no maintenance other than to ensure av ailabil[...]

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. For e xampl e, a stor[...]

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. After that, the transaction log dat a be comes redundant and the f iles[...]

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. The RDU serv er then tries to restart automatically . When attempting to [...]

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. Examples Here is an example of using the backupDb .sh to[...]

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.sh to ol: # recoverDb.sh /var/backup/rdu-backup-20060427-130345 In this ex ample, the snapshot located in the /v ar/backup/rdu-backup-20060427-1303 45 directory will be reco[...]

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. This process requ ires stopping the RD[...]

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. This chapte r includes the fol lo wing sections: • Syslog Alert Messa[...]

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. Y [...]

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. Y ou have thre[...]

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.log f ile an d the log files correspo[...]

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 Access Registrar Extension Point Alerts Whene ver a Cisco B A C Access Registrar extension poin t syslog alert is sent, you can f ind additi onal deta[...]

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 . Y ou can configure the SNMP agent on the DPE b y using snmp-serv er[...]

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. Y ou can use th e snmpAgentCfgUtil.sh tool for: • Adding a Host, page 11-7 • Deleting a Host, page 11-7 • Adding an SNMP Agent Co m[...]

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. Note The changes that you introduce throu gh this command do not t ake ef fect until [...]

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. Syntax Descripti on snmpAgentCfgUtil.sh delete communi ty string [...]

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 # ./snmpAgentCfgUtil.sh stop Process snmpAgent has stopped Configuring an SNMP Agent Listening Port Y ou use this command to sp ecify the port number to which t he SNMP agent will li[...]

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 : # . /snmpAgentCfgUtil.sh contact “Ace Duffy - ext 1234” Displaying SNMP Agent Settings Y ou[...]

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 Table : [ Host IP address, Community, UDP Port ] Access Control Table : Read Only Communities bacread Read Write Communities bacwrite Monitoring Serv[...]

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.8 <SOL_B[...]

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 2 port 7550 service http 2 ssl cipher all-cipher-suites service http 2 ssl client-auth none service http 2 ssl enabled true service http 2 ssl keysto[...]

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.log f ile, in which statistics data is logged at specif ic intervals; th is ti[...]

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. Y ou can choose to specify all componen ts (by using the all option) or specify from th e foll[...]

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- In Queue 0; Dropped 0; Dropped-Full Queue 0; Batches Received 0; Internal Batches Received 0; Succeed 0; Failed 0; Processed 0; Processing avgTime 0[...]

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 Not Found)=9, Number of UDP Connection Request Failure (Shared Secret Not Configured)=0, Number of UDP Connection Request Failure (Network Failures)=[...]

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 • Inform • T ransferComplete • AutonomousT ransferComplete • GetQueuedT ransfers • ScheduleInform • SetV ouchers • GetOptions • Upload[...]

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). This chapte r includes the fol lo wing sections: • CWMP Service Configuration, page 12 -1 • Connection Request Service, page 12-2 • P[...]

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. Y ou can independently conf igure each instance of the CWMP services—the CWMP RPC service[...]

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 Request Options Y ou can use Cisco B AC to control the behavior of c onnection requests b y conf iguring your preferen ces for: • Config uring Authentic[...]

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 . If you do not specify the Connection Re[...]

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. Configuring Connect ion Request Met[...]

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 . Step 2 Use one of these methods: • Add a de vice record. T o do this, click the Add b utt[...]

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. The Modify De vice page appears. Step 3 From the Property Name drop-d own li st, sele ct the /IPDe vice/connectionR equestPort and /IPDe vice/conne[...]

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 . An nex G uses a STUN server to identify [...]

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 . The CMHS NB API client contacts the CMHS server that the DLC is mo st[...]

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. These v alu es need to be considered while sending CMH S connection reque[...]

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. In earlier versions of Cisco B A C, connection requests were re fused if a device's reported IP address and it[...]

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. The RDU forw ards disco very pol icy inst ructions and the v alues of pa rameters, discovered for each device during the pr e vious discovery process, to th e appro[...]

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.DeviceInfo.Hardw areV ersion • InternetGate wayDe vice.DeviceInfo.Softw areV ersio[...]

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. Displays recent DPE log entries. Displays the last 100 lines of the DPE log. Displays t[...]

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. Automatic IMEI Update Cisco B A C now pro vides the capability to discov er the [...]

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. Cisco B A C’ s scalability and fa ilov er [...]

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. T o conf igure the netwo rk for region al redundancy , ensure that the Cisco B A C hostname of a giv en provision ing[...]

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. In adding a DPE to a pro visioning group, there are three po ssible options: • Adding [...]

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. It describes ho w to enable HTTP o ver SSL t ransport, called SSL in this chapter ,[...]

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. In this scenario, the A C[...]

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. The DPE ships with a def ault sampl[...]

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. See Generating Serv er Certif icate K eystore and Pri v ate K ey for a Ne w Certif icate,[...]

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. This password must be between 6 and 30 characters. • ke y[...]

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. Generating Server Ce rtificate Keystore and Privat e Key for a New Certificate[...]

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.", L=Boxborough, ST=MA, C=US correct? [no]: yes Enter key [...]

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. Example 13-3 Keyt ool -cer treq The follo wing[...]

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. Y ou can manage the cacerts keys tore by using the key tool utility . The defau[...]

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. If you ha ve enabled client authenticat[...]

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. Y ou can conf igure DPE security op tions from th[...]

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. Digest authentication was disabled. Requires DPE restart "> dpe reload") dpe# service cwmp 2 port 7548 % OK (Requires DPE restart "> [...]

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.8 DPE CLI Refer e nce . Configuring CPE Authentication CPE authen[...]

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 or Digest mode from th e DPE CLI, use: # service { cwmp | http } num client-auth mode • num —Identifies an instance th e service, which could be 1 [...]

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. At this point,[...]

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. Client Certificate Authentic[...]

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 section p rovides a summar y of possible combinat ions of clien t-authentication opt ions a vailable i n Cisco B A C for the CWMP and the HTTP fi le se[...]

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. Local authentication is managed locally at the: • DPE server , for DPE CLI[...]

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. RDU Authentication Mode Settings Y ou can select eithe[...]

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 uses the Signed Confi guration feature to sign a portio n of the CPE conf iguration that is targ eted to be passed by the CPE to a third-party , such as [...]

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 .c hangeDefaults API. Y ou must also create a conf iguration template f[...]

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. T emplate contains parameters designated for signing, b ut the de vice does not report an y expected suppo rt for the Signed Conf iguration feature • T o ge t basic infor[...]

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). By using this mechanism, y ou can run CPE W AN Manag e ment Protocol (CWMP) remote procedure calls for a de vice and perform maintenan ce tasks[...]

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. Caution Y ou should not perform de[...]

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. See Connection[...]

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. Figur e 14-2 On-connect Op eration Mode Wor kfl ow The API client constructs an IPDe viceOperation specifying an on-connect e xecu[...]

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. The TR-069 IPDe vice operations like[...]

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. getRDUDetails () is enhanced to report stati stics of the follo wing as[...]

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 . In this scenario, the devi ce’ s provisioning grou p in Cisco B AC is incor rect and must be changed only in Cisco B AC; for example, the[...]

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). 2. DPE 1 in PG 1 searches its cache for the device. If [...]

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. Step 3 Select your options from the Ho me Provisioni ng Group drop-do wn list. Step 4 Click Sub[...]

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. This chapte r includes the fol lo wing sections: • Config uring the Administr[...]

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. • /adminui/pageSize—Specifies the number of search results d[...]

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 . T able 15-1 lists the browsers supported in this Cisco B AC release. Step [...]

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. A conf irmation dialog appears. Step 2 Click OK . This returns you to[...]

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. These tasks mainly in volv e monitoring the actions of v arious Cisco B A C component[...]

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. Read/Wri te users can [...]

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. See User Management, page 16-1 , for complete descriptions of each user type. Step 5 Enter[...]

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 . T o delete a user: Step 1 From the Main menu or [...]

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. T o select the search type, from the Manage Dev ices page, cl[...]

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 . In addition[...]

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. For e xample, you might search for de vices be[...]

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 . T able 16-2 Device Details Pag e Field or Button Description Dev[...]

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. CPE Pass[...]

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. Devi ce management includes: • Adding, deleting, and modifying RDU de vice records • Regenerat[...]

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 Li ve Data – Ping Diagnostic – Force Firmwa re Upgrade – Force Conf iguration Synchronization For detailed information on these operations, see [...]

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 . T o delete a device record: Step 1 From the Manage De vices page, locate th e devi[...]

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. In such cases, you must manually re generate instructions b [...]

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. The Unrel[...]

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. • Force Firmware Upgrade—Enables you to force a device to updat e its firmw are on next con tact regar dl[...]

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. Step 2 Click the Operations icon corresp[...]

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. • Name of the hostname to be pinged—I dentifies t he hostname of the CPE to be pinged. • Int[...]

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. After that period, the operation times out. Note In addition to the p rocedure described in[...]

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. Step 2 Change the Search T ype to Group T y pe. Step 3 Click Add to op[...]

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 . If this results in two member groups with th e same priority , they are sorte[...]

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 (.), colon (:), and at[...]

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. T o either relate or unrelate this relatio nship: Step 1 Click Relate or Unr el[...]

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 . T able 16-3 V iew Device Pro visionin g Engine Details P age Field or Button Des[...]

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. Thes e states inc lude: • Regis tering • Initializing • Synchronizing • Populating • Ready • Of fline If this f ield reads Of fline, the o[...]

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. Figure 16-8 illustrates a sample NR detail s pa[...]

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. Each provisi oning group appearing in this l ist is a link to its o wn details page. Click thi[...]

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. Figur e 16-1 0 View Region al Distr ibution Uni[...]

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. Port Identif[...]

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. Requests pending Identifies the number of re generation requests in qu eue. Log File[...]

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. This chapte r includes the fol lo wing sections: • Config uring th[...]

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. T able 1 7 -1 Manage Class of Serv[...]

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 . Step 2 Choose Class of Service from the Secondary Navi gation bar . Step 3[...]

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 . IGS does th [...]

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 associated with a Class of Serv ice to be deleted, use the Cisco B A C application programmers interf ace (API) to write a pr ogram to iterate through th[...]

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. Step 1 Choose Conf iguration on the Primary Na vigation [...]

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. CWMP Defaults The CWMP Defaults pag e ( Figure 17-2 ) displays a list of CWMP tech nology[...]

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. The Instruction Generation Service (IG S) [...]

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. STUN Server Port Specifies the STUN server port. STUN HTTP Server [...]

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. Figure 1 7 -3 Configur e RDU Defaults P a[...]

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. Figur e 1 7 -4 Syst em Def aults P ag e T able 17-5 describes all fields and button s appearing [...]

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. Immediate Operation History Identif ies if logging of hist ory of de vice operation in itiated from th[...]

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. Figur e 17 -5 T ACA CS+ Def aults P ag e T able 17-6 describes all fields and button s appearing in Figure 17[...]

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. When T A CA CS+ authentication i[...]

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 . T o change the order of the T A CA CS+ servers in th e prio r[...]

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 . Step 2 Choose Files on the Secondary Na vigation bar . The V iew Files page appears. Step 3 Cl[...]

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 . The V iew Files page appears. Step 3 Search for t[...]

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 . This procedure is dif ferent if you [...]

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. Each license is av ailable as either a permanent li cense or an e va[...]

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 . Step 2 Choose License K eys on the Secondary Na vigation 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. This section also provides details ab out how to add[...]

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. Managing RDU Extensions Creating a custom e xtension p[...]

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: • Writing a Ne w Class for RDU, page 17-24 • Installing RDU Custom Extensions, page 17-25 • V iewing RDU Extensions, page 17-26 Note Y ou can specify mu l[...]

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. While Cisco B AC accepts [...]

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. This page dis plays deta ils on the inst alled extensio[...]

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. Thes[...]

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 . This chapte r includes the fol lo wing sections: • Overvie w , page 18 -1 • Script’ s Share d Scope, page [...]

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.*; com.cisco.provisioning.cpe.cwmp.main.*; com.cisco.provisioning.cpe.cwmp.soap.messages.*; com.c[...]

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 // response the in the same line as if using // a synchronous interface // sendAndReceive() sends the give message to the // device and receives the response m[...]

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. Step 2 Choose Defaults from the secondary navig ation bar .[...]

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 DPE Cache When the de vice boots, it contacts DPE and in vok e s the e xtension scripts a vailable in DPE cache based on the e xtensions confi gured [...]

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 . This chapte r includes the fol lo wing sections: • TCP Connection Management, page 19-1 • RDU Batch Concurrenc y , [...]

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. A command represen ts an operation t hat[...]

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.addNode • IPDe vice.changeNodeProperties • IPDe vice.deleteNode • IPDe vice.addNodeT ype •[...]

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. The DPE cache comprises the instructio n ca che, with instructions for de vices, and the fil[...]

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, tools t hat help you maintain Cisco Broadband Access Center (B A C) as well as speed and impro ve the i nstallation, deploym ent, and use of this produ[...]

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.sh -sampl ectrl command. (For sampl e control output, see Exampl[...]

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. All supported standard fields are listed below. Remove unwante[...]

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.sh Tool Follo wing a successful export from the Cisco B A C b ackup database, the De vice Export tool creates a de vice file, wh ich contains the list of de vice record s that are successfully expo[...]

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.sh tool to reset the passw o[...]

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.s h Tool T able 20-1 describes the types of e vents th at you can vie w from the e vent mo nitor: T able 20-1 Events that can be viewed fr om the Event Monit or Event Sub-Event Description Batc[...]

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.sh [ options ] Options are used to specify the RDU connection p arameters and amount[...]

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.sh Tool The Cisco B A C installation program [...]

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.sh Tool Using the changeNRProperties.sh Tool The Cisco B A C installation program est ablishes v alues for conf iguration properties used by Cisco B AC extensions th at are incorporated int o[...]

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.sh Tool[...]

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 . This chapte r includes the fol lo wing sections: • T roubleshoot ing Checklist, pa ge 21-1 • Logging, pa ge[...]

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 . Log files are located in their o wn log directories[...]

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. • Date and T ime—[...]

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. For exam ple, the logging le vel for the RDU could be set to W arning, and the le vel for t [...]

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. (See Setting the RDU Log Level,[...]

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. The Information le vel is recommended to be used wit h caution if you need to maintain steady sta[...]

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. In this e x ample, the default username (bacadmin) is used. Please type RDU username: bacadmin This prompt appear s: Please type RDU password: Step 4 Enter the RDU password [...]

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. In situations where the DPE underg oes catastrophic fail ure, such [...]

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. 1 Report when a packet is sent or receiv ed or when there is a chan[...]

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. audit logs A log fi le containing a summary of major [...]

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 . F fully qualified domain n[...]

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. provision ing groups Groupings of de vices with a def ined set of associat ed DPE serv ers, based on either network to pology or geogr[...]

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. W watchdog agent A watchdog agent is a daemon proc ess that is used to monitor , stop, start and[...]

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, configuring 3-9 BAC arch itecture, and 9-4 configuring 15-1 connection request 12-5 device’s provisio ning group, correcting 14-8 device fa ults, viewing [...]

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 17-5 disk space requirement figures 10-3 network deploymen t with an evaluation l icense key 17-20 template files, deleting 17-19 troubleshooting d ev[...]

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 device data about 12-11 parameters 12-12, 12-13 files, managing adding 17-17 deletin g 17-19 exporting 17-19 replacing 17-18 viewing 17-18 license ke ys 1[...]

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, verifying 13-8 signed certificate into server certificate, importing 13-9 signing authority cert ificate into cacerts, importing 13-8 DPE ports 12-2 security [...]

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 asynchronous workflow (figure) 14-5 immediate 14-2 immediate workflow (figure) 14-3 on-connect 14-3 on-connect workfl ow (figure) 14-4 device’s provisi[...]

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 expressions 6-7 internal, external files 6-10 regular expressions 6-7 sample 6-11 management mechanisms 6-1, 6-4 direct firmware 6-4 policy based 6-2 upgr[...]

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.log 21-5 dpe.log 21-8 perfstat.log 11-15 rdu.log 21-5 troubl[...]

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 workfl ow 3-8, 3-9 publishing, de finition GL-3 R RDU (Regio nal Distri bution Un it) about 2-4 alerts 11-2 component workflow check list (table) 3-1 d[...]

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 11-10 notification types, specifying 11-11 settings, displaying 11-11 starting 11-9 stopping 11-9 SSL configuring 13-3, 13-11 CWMP service, example 13-[...]

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.log 11-15 runStatAnalyzer.sh tool, us ing 11-15 U unregistered devi ces 4-16 users abo[...]