Cisco Billing and Measurements Server User Guide Release 3.30 March 10, 2011 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883 Text Part Number: OL-11618-18 CCVP, the Cisco logo, and Welcome to the Human Network are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems, Inc.; and Access Registrar, Aironet, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys, MeetingPlace, MGX, Networkers, Networking Academy, Network Registrar, PIX, ProConnect, ScriptShare, SMARTnet, StackWise, The Fastest Way Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1005R) Cisco Billing and Measurements Server User Guide © 2011 Cisco Systems, Inc. All rights reserved. CONTENTS Preface xiii Who Should Use This Guide -xiii How This Guide Is Organized -xiii Understanding Document Conventions -xiv Related Documentation -xvi Obtaining Documentation -xvi World Wide Web -xvi Documentation CD-ROM -xvi Ordering Documentation -xvii Documentation Feedback -xvii Obtaining Technical Assistance -xvii Cisco.com -xvii Technical Assistance Center -xviii Cisco TAC Web Site -xviii Cisco TAC Escalation Center -xix Documentation Feedback -xix CHAPTER 1 Introduction to Cisco BAMS 1-1 Collecting Data 1-1 Data Collection 1-2 Cisco BAMS Terminology 1-2 Formatting Data 1-2 Storing Data 1-3 Trapping Errors 1-3 System Backup and Recovery 1-3 Installing the Sun Solaris 10 Operating System 1-4 BAMS 3.30 Modifications Overview 1-4 BAMS 3.30 Features and Formats 1-5 Solaris 10 Support 1-5 Continued Support for BAMS 3.20 Features and Formats 1-6 CDE Tag Length Changes 1-6 New CDE fields 1-6 New CDE Fields for Extended ASCII Output 1-7 Cisco Billing and Measurements Server User Guide OL-11618-18 iii Contents New CDE Fields for Binary 1110 Output 1-7 New Measurements 1-7 Support for BAMS Software Licensing 1-7 Support for New QoS Feed 1-8 Support for the Mode PGW Dynamic Update = True 1-8 SFTP File Transfer Support 1-8 Generic Error Handling 1-9 Background 1-9 Implementation 1-9 Alarm 1-9 Cisco BAMS Software License 1-10 Host ID Mechanism 1-10 BAMS License Validation 1-10 Periodic License Validation 1-10 Base License Management During Switchover 1-10 Exception Management 1-10 BAMS Software License Operations 1-11 License-Related Alarms 1-11 BAMS License File Types 1-11 Installing BAMS with the Licensing Mechanism 1-12 License Upgrade Procedure 1-13 Upgrading from a Temporary to a Base License 1-13 Migration 1-14 Creating Directory Structures 1-14 CHAPTER 2 Setup and Installation 2-1 Overview 2-1 Upgrading to BAMS Release 3.30 2-1 Configuring the Cisco MGC for Using BAMS 2-1 Uninstalling BAMS 2-3 Installing Cisco BAMS 2-4 Installing a Cisco BAMS Software Patch 2-6 Enabling SFTP on Cisco BAMS and the Cisco PGW 2200 2-7 Generate Public and Private Keys on the Cisco PGW 2200 2-7 Generate Public and Private Keys on the Cisco BAMS 2-8 Enabling Automatic SFTP Login 2-8 Configuring BAMS to Forward SNMP Traps 2-9 Configuring BAMS 2-10 Cisco Billing and Measurements Server User Guide iv OL-11618-18 Contents Configuring Node Parameters 2-17 Host Configuration Setup for Downstream Polling 2-17 Setting Up Disk Monitoring Thresholds 2-18 Calculating Disk Space Usage 2-18 Defining Conditions for MSC Alarms 2-19 Setting a File-Age Condition 2-19 Setting a File-Type Condition 2-19 Setting Disk Usage Thresholds 2-20 Setting the Initial PGW CDR Sequence Number 2-20 Setting the PGW Dynamic Update Mode 2-20 Processing Pre-9.4.1 Data 2-21 Processing 9.4.1 (and Newer) Data 2-21 Suppressed Measurements 2-21 CHAPTER 3 Provisioning BAMS 3-1 Overview 3-1 Provisioning Commands 3-1 System-level Provisioning 3-2 Node-level Provisioning 3-2 QoS Output Provisioning 3-3 Billing Output Provisioning 3-3 BAF Output 3-3 1110 Binary Output 3-3 NICS Output 3-4 P01 Output 3-4 Threshold Crossing Alarms (TCA) Provisioning 3-4 Deploying Node-level Provisioning 3-4 Provisioning Commands and Examples 3-5 Starting a Provisioning Session 3-6 Provisioning Multiple Records with a Single Command 3-6 Deploying Changes 3-7 Making Changes Using Batch Files 3-7 System-Level Example 3-8 One-Node Example 3-9 Multiple-Node Example 3-9 Executing the Batch File 3-10 CHAPTER 4 Using MML Commands 4-1 Introduction 4-1 Cisco Billing and Measurements Server User Guide OL-11618-18 v Contents Command Notation 4-1 Command Syntax 4-1 Starting and Stopping BAMS 4-1 Starting the System 4-1 Stopping the System or OOS 4-2 Starting an MML Session 4-2 Help—Help Command 4-2 command name:?:—Help on Tag IDs 4-5 command name:tagID:?—Help on Field Names 4-6 MML Session Logs 4-6 MML Commands 4-7 chgno—Change Number 4-7 clr-alm—Clear Alarm 4-7 dialog—Dialog 4-8 get-nodenames—Get Node Names 4-8 h—History 4-9 prov-add—Provision Add 4-9 prov-cpy—Provision Copy 4-10 prov-diff—Provision Compare 4-11 prov-dlt—Provision Delete 4-13 prov-dply—Provision Deploy 4-13 prov-ed—Provision Edit 4-14 prov-exp—Provision Export 4-15 prov-rtrv—Provision Retrieve 4-16 prov-sta—Provision Start 4-16 prov-stp—Provision Stop 4-19 prov-sync—Provision Synchronize 4-19 quit—Quit 4-19 r—Repeat 4-20 rtrv-alms—Retrieve Alarms 4-20 rtrv-circuit—Retrieve Circuits 4-21 rtrv-configs—Retrieve Configuration 4-21 rtrv-file—Retrieve File 4-22 rtrv-ne—Retrieve Network 4-22 rtrv-session—Retrieve Session 4-23 rtrv-softw—Retrieve Software 4-24 rtrv-syslog—Retrieve Syslog 4-26 set-alm—Set Alarm 4-26 set-node—Set Node 4-27 set-nodename—Set Node Name 4-27 Cisco Billing and Measurements Server User Guide vi OL-11618-18 Contents sta-softw—Start Software 4-28 stp-softw—Stop Software 4-28 sw-ovr—Switch Over 4-29 CHAPTER 5 Using BAMS Tag IDs 5-1 Introduction 5-1 Command Notation 5-1 Command Syntax 5-1 Tag IDs and Field Names 5-1 Updating the Alarm Parameters Table 5-2 ALM-PARMS Tag ID 5-2 Updating the BIN1110 Table 5-4 BIN1110 Tag ID 5-4 Updating the Country Table 5-5 COUNTRY Tag ID 5-5 Updating the Map Type Table 5-5 MAPTYPE Tag ID 5-5 Updating the Mass Storage Control Parameters Table 5-6 MSC-PARMS Tag ID 5-7 Updating the Mass Storage Control Thresholds Table 5-8 MSC-THRES Tag ID 5-9 Updating the Node Parameters Table 5-11 NODEPARMS Tag ID 5-11 Updating the NPANXX Table 5-16 NPANXX Tag ID 5-16 Updating the P01 Filter Table 5-17 PO1FILTER Tag ID 5-17 Updating the Poll Table 5-18 POLL Tag ID 5-18 Updating the Rating Exception Table 5-19 RATE-EXC Tag ID 5-20 Updating the Rating Type Table 5-20 RATING-TYPE Tag ID 5-20 Updating the Nailed Connection Table 5-21 SIGPATH Tag ID 5-21 Updating the Skip CDB Table 5-22 SKIPCDB Tag ID 5-22 Updating the Skip CDE Table 5-22 SKIPCDE Tag ID 5-23 Cisco Billing and Measurements Server User Guide OL-11618-18 vii Contents Updating the Switch Information Table 5-23 SWITCHINFO Tag ID 5-23 Updating the Threshold Crossing Alarms Table 5-24 TCA-TBL Tag ID 5-25 Updating the Tollfree Table 5-30 TOLLFREE Tag ID 5-30 Updating the Trunk Group Table 5-31 PGW Dynamic Update Mode = True 5-31 TRUNKGRP—Trunk Group Table 5-31 Updating the Trunk Group Prefix Table 5-32 TKGPREFIX—Trunk Group Prefix Table 5-33 Updating the Zone Information Table 5-33 ZONE-INFO Tag ID 5-34 CHAPTER 6 Configuring BAMS for BAF Output 6-1 Overview 6-1 Generating BAF Records 6-2 Interworking of BAMS Configuration Tables 6-2 Prerequisites for BAF Records 6-2 Identifying Call Types 6-3 Default BAF Structure Codes and Call Types 6-4 Example of BAF Structure Codes and Call Types Created from BAF Provisioning 6-4 Exception and Special Processing 6-5 Overriding Call Types 6-5 Processing 7-Digit Numbers 6-5 Processing Toll-Free Calls 6-5 Processing International Calls 6-5 Processing LNP Calls 6-6 Processing Transit/Tandem Calls 6-6 BAF Output Provisioning Example 6-6 Call Area Provisioning Example 6-7 Designing a Billing Plan 6-7 Assumptions Used in This Example 6-7 Zone Membership 6-10 Free Calling Between Zones 6-10 Banded Message Rates 6-11 Configuring Trunk Groups for InterLATA Calls 6-11 Configuring Adjacent Area Codes 6-11 Configuring IntraLATA Calls 6-11 Cisco Billing and Measurements Server User Guide viii OL-11618-18 Contents Configuring Toll-Free Calls 6-12 Configuring a Metropolitan Calling Plan 6-12 Configuring for a Rating Exception 6-12 BAMS Provisioning Worksheets 6-13 BAF Configuration Parameters 6-13 Updating BAF Structure Codes 6-13 Adding a New Zone ID 6-14 Adding a New NPANXX (Zone Membership) 6-14 CHAPTER 7 Configuring BAMS for ASCII Output and Measurements 7-1 Overview 7-1 ASCII Output 7-1 Correlation of Billing Information 7-3 Files and Records 7-4 Extendable ASCII Output 7-4 Extendable ASCII Output Format 7-4 Redirecting Number and Display Name Enhancement 7-7 Operational Measurements 7-7 Defining Bucket Size 7-7 Setting Up the TCA Table 7-8 CHAPTER 8 Configuring BAMS for P01 Output 8-1 Overview 8-1 P01