Table Of Contents
Cisco BTS 10200 Softswitch PacketCable Guide, Release 6.0.x
Cisco BTS 10200 Softswitch in the PacketCable Network
Description of the Event Message Feature
Event Message Generation Details and Content
Timestamp Support for Event Messages
Event Message Storage on the CA
PCMM-Based QoS for Type 1 Clients
SOAP/XML Interface for CMS Subscriber Provisioning
Prerequisites for CMS Subscriber Provisioning
Limitations on CMS Subscriber Provisioning
Provisioning Basic PacketCable and DQoS Features
Provisioning the CMS Interfaces to the CMTS and eMTA
Provisioning DQoS Parameters for Codec Negotiation Service
Provisioning TGCP Interfaces to TGWs
Provisioning the Keepalive AUEP Ping Option
Provisioning MGCP Command Timeout and QoS Parameters
Provisioning the Aggregation ID Subnet
Provisioning CMTS Discovery Using the Static Subnet Table
Provisioning Subscriber ID Parameters and DQoS Measurement Counter
Provisioning Security Interfaces
Provisioning Parameters for Secured Media
Provisioning Security Interfaces to the MTA
Provisioning Security Interfaces to the CMTS
Provisioning Security Interfaces to the TGW
Provisioning Security Interfaces to the RKS
Provisioning IPsec Security Associations and Ciphersuite Algorithms
Provisioning Support for EM Transmission and Storage
Provisioning the System to Generate EMs for Billing
Provisioning Media_Alive Verification for EMs
Provisioning PCMM-Based QoS for Type 1 Clients
Provisioning AuditConnection Parameters
Operations, Billing, and EM Transfer Procedures
PacketCable Billing Data and Formats in Deployments Using CDBs
Reset, Control, and Status Commands
Manual Recovery and Transfer of Stored EMs
Sending Billing Files to the RKS via FTP
Content of EMs Sent to the RKS
Viewing Media_Alive Verification for EMs
Creating Reports and Displays of Measurements
Measurements for the DQoS Feature on COPS Interface
Measurements for the EM Feature
Events and Alarms Specific to PacketCable-Based Network Elements and PCMM Features
Events and Alarms for the EM Feature
Events and Alarms for the Security Interface Feature
EM Generation Details and Content
References to Industry Standards
Cisco BTS 10200 Softswitch PacketCable Guide, Release 6.0.x
Revised: March 31, 2008, OL-15919-01This document describes how the Cisco BTS 10200 Softswitch implements PacketCable-based interfaces and functions. It also provides provisioning and operating information for PacketCable features and event messages (EMs). It is intended for use by service provider management, system administration, and engineering personnel who are responsible for designing, installing, provisioning, and maintaining networks that use the Cisco BTS 10200 Softswitch system in a PacketCable-based network.
Document Change History
The following table lists the revision history for the Cisco BTS 10200 Softswitch PacketCable Guide, Release 6.0.x.
Version Number Issue Date Status Reason for ChangeOL-15919-01
31 Mar 2008
Initial
•
Initial document for Release 6.0.x
•
Removed ICMP ping option, which is obsolete in Release 6.0 and later.
Contents
Operations, Billing, and EM Transfer Procedures
EM Generation Details and Content
References to Industry Standards
Technical Overview
This section provides technical information about the implementation of PacketCable features. It covers the following topics.
•
Cisco BTS 10200 Softswitch in the PacketCable Network
•
PCMM-Based QoS for Type 1 Clients
•
SOAP/XML Interface for CMS Subscriber Provisioning
Note
In this document, the term embedded multimedia terminal adapter (eMTA) refers to eMTAs using PacketCable Network-based Call Signaling (NCS) protocol.
Cisco BTS 10200 Softswitch in the PacketCable Network
The Cisco BTS 10200 Softswitch is a class-independent network-switching element. In a PacketCable-based network, it functions as both a call management server (CMS) and a media gateway controller (MGC). It provides call control, call routing, and signaling for several types of multimedia terminal adapters (MTAs) and embedded MTAs (eMTAs), cable modem termination systems (CMTSs), and trunking gateways (TGWs) in PacketCable-based networks. It provides interfaces to record keeping servers (RKSs) and key distribution centers (KDCs). The Cisco BTS 10200 Softswitch also communicates with announcement servers, Signaling System 7 (SS7)-based signaling gateways, Media Gateway Control Protocol (MGCP)-based media gateways, and Session Initiation Protocol (SIP) networks.
Figure 1 shows a typical network with PacketCable-based network elements and the applicable external interfaces of the Cisco BTS 10200 Softswitch. In the PacketCable-based network, the Cisco BTS 10200 Softswitch performs the functions of both the CMS and MGC. The Cisco BTS 10200 Softswitch also provides provisionable options for customizing the external interfaces.
Figure 1 Example of PacketCable-Based Network Architecture
PacketCable-Based Interfaces
The Cisco BTS 10200 Softswitch supports signaling on specific PacketCable-based interfaces shown in Figure 1. The following list summarizes the supported protocols for each of the links:
•
CMS to MTA (NCS)—CMS-to-MTA interface for subscriber access
•
CMS to CMTS (Common Open Policy Service[COPS])—CMS-to-CMTS interface for gate management
•
CMS to RKS (EM over Remote Access Dial-In User Service [RADIUS])—CMS-to-Record Keeping Server (RKS) interface for EM-based billing functions
•
MGC to RKS (EM over RADIUS)—MGC-to-RKS interface for EM-based billing functions
•
CMS to Communications Assistance for Law Enforcement Act (CALEA) (EM over RADIUS)—CMS-to-CALEA server (Delivery Function [DF]) interface
•
MGC to TGW (Trunking Gateway Control Protocol [TGCP])—MGC-to-trunking gateway (TGW) interface for TGW management (which allows calls to be connected between the PacketCable network and the public switched telephone network [PSTN])
Additional interfaces are defined for the PacketCable Multimedia (PCMM) quality of service (QoS) features in the "PCMM-Based QoS for Type 1 Clients" section.
The Simple Object Access Protocol/Extensible Markup Language (SOAP/XML) interface for CMS subscriber provisioning is defined in the "SOAP/XML Interface for CMS Subscriber Provisioning" section.
For a description of Cisco BTS 10200 Softswitch support for CALEA, see the Cisco BTS 10200 Softswitch System Description. For provisioning procedures related to CALEA support, see the Cisco BTS 10200 Softswitch Provisioning Guide.
Note
For information on compliance with specific paragraphs of PacketCable standards and explicit congestion notifications (ECNs), contact your Cisco account team.
Additional Network Interfaces
The following additional interfaces are not part of the PacketCable feature set, but they provide other important functions useful in the service provider network:
•
Cisco BTS 10200 Softswitch/Signaling Gateway (SIGTRAN)—This interface allows calls to be made between the PacketCable network and the PSTN. The Call Agent (CA) of the Cisco BTS 10200 Softswitch interfaces to an Internet transfer point (ITP) signaling gateway (SG), for example, the Cisco 7500 series router. The ITP SG provides an SS7-based interface to the Signal Transfer Point (STP) (PSTN).
•
MGCP Interface—The Cisco BTS 10200 Softswitch communicates with MGCP-based TGWs that provide a bearer path to the PSTN.
•
SIP Interface—SIP signaling is used for the following two functions:
–
Communications with another CMS
–
Access to voice mail
•
Cisco BTS 10200 Softswitch office applications (Simple Network Management Protocol Version 3 [SNMPv3] and Common Object Request Broker Architecture [CORBA] over Transmission Control Protocol/Internet Protocol [TCP/IP])—
This interface provides communication with Operations Support System (OSS) and office applications servers.Gate Coordination Functions
In the PacketCable environment, the Cisco BTS 10200 Softswitch performs the gate coordination functions of a CMS, including the gate controller (GC). GC signaling is based on the COPS stack. Each CMTS informs the CMS when a gate is successfully opened or closed. Two gate coordination messages are used, Gate-Open and Gate-Close. Gate coordination is required to avoid several theft-of-service scenarios, as described in Appendix K of the PacketCable Dynamic Quality-of-Service Specification, PKT-SP-DQOS-I07-030815, August 15, 2003.
Note
For information on compliance with specific paragraphs of PacketCable standards and ECNs, contact your Cisco account team.
Gate-Open Process
The normal coordination process for Gate-Open signaling, illustrated in Figure 2, has four main steps:
1.
During call setup, the Cisco BTS 10200 Softswitch requests the MTA to commit bearer-path resources.
2.
The MTA sends a commit message to the CMTS to request opening of the gate on the bearer path.
3.
The CMTS opens the gate and sends a Gate-Open message to the Cisco BTS 10200 Softswitch.
4.
The Cisco BTS 10200 Softswitch allows the call.
Figure 2 Gate Coordination Signaling Example (Gate-Open)
If the Gate-Open message arrives at the Cisco BTS 10200 Softswitch before it has sent a resource-commit request to the MTA, the Cisco BTS 10200 Softswitch sends a GATE-DELETE message to the CMTS with Unexpected Gate-Open included in the reason code.
Gate-Close Process
During a call, if the Cisco BTS 10200 Softswitch receives a Gate-Close message from the CMTS, it allows the call to proceed on a best-effort basis, without a guaranteed level of service. (It tears down the call only when one of the parties in the call goes on-hook.)
Security Interface Features
Note
For information on compliance with specific paragraphs of PacketCable standards and ECNs, contact your Cisco account team.
The implementation of PKT-SP-SEC-I09-030728, PacketCable Security Specification, July 28, 2003, provides a security scheme for the voice-over-cable network built on a set of security protocols. These protocols, based on the following documents, provide authentication (to help prevent theft of bandwidth, denial-of-service attack, replay, and so forth) and enable message integrity, privacy, and confidentiality.
•
IETF documents covering IP security (IPsec) architecture:
–
RFC 2401, Security Architecture for the Internet Protocol, IETF (S. Kent, R. Atkinson), Internet Proposed Standard, November 1998
–
RFC 2406, IP Encapsulating Security Payload (ESP), IETF (D. Piper), Internet Proposed Standard, November 1998
•
IETF documents covering key management protocols—Internet Key Exchange (IKE) and Kerberos with extensions:
–
RFC 2409, The Internet Key Exchange (IKE), IETF (D. Harkins, D. Carrel), Internet Proposed Standard, November 1998
–
RFC 1510, The Kerberos Network Authentication Service (V5), IETF (J. Kohl, C. Neuman), September 1993, with updates presented in PKT-SP-SEC-I09-030728
The Cisco BTS 10200 Softswitch performs the security functions of a CMS and a MGC in the PacketCable environment. It supports security in accordance with PKT-SP-SEC-I09-030728 for both signaling and media:
•
Signaling security—For signaling from CMS to eMTA, CMS to CMTS, and MGC to TGW
•
Media (bearer) security—For signaling between originating eMTA and terminating eMTA, which is facilitated by the CMS during call signaling setup
The system supports IPsec features for encryption and authentication on specific PacketCable-based interfaces (see Figure 1). There are two aspects to the security features; the security protocol itself (IPsec), and the key management (Kerberos or IKE). The following list summarizes the supported security type for each of the links:
•
CMS to MTA (NCS)—IPsec/Kerberos
•
CMS to CMTS (COPS)—IPsec/IKE
•
CMS to RKS (EM over RADIUS)—IPsec/IKE
•
MGC to RKS (EM over RADIUS)—IPsec/IKE
•
CMS to CALEA (EM over RADIUS)—IPsec/IKE
•
MGC to TGW (TGCP)—IPsec/IKE
As shown in Figure 1, there is no interface between the KDC and the Cisco BTS 10200 Softswitch. To ensure secure NCS signaling, a dynamic key exchange is performed. This exchange provides for IPsec security operations between the MTA and the Cisco BTS 10200 Softswitch. (These procedures are described in the CableLabs document PacketCable Security Specification, PKT-SP-SEC-I09-030728, under "Kerberized IPsec" and other sections.)
•
Manual key provisioning must be used to match data stored in the KDC with data stored in the Cisco BTS 10200 Softswitch (pre-setup).
•
The MTA must contact the KDC to obtain the credentials to talk to the server, which in this case, is the Cisco BTS 10200 Softswitch.
Note
For information on compliance with specific paragraphs of PacketCable standards and ECNs, contact your Cisco account team.
Note
See the "Installation" section regarding the requirement for setting the IPSEC_ENABLED parameter at the time of Cisco BTS 10200 Softswitch software installation.
Event Message Feature
This section describes Cisco BTS 10200 Softswitch support for the EM feature.
Billing Data Options
The Cisco BTS 10200 Softswitch can provision billing support using either of the following billing data generation methods:
•
Call detail blocks (CDBs)—This is traditional post-call billing data, which is assembled into call detail records (CDRs) by an external billing mediation system or billing server.
•
PacketCable EMs—This is real-time call data flow, which is transferred to an external RKS that assembles CDRs from the EMs.
The Cisco BTS 10200 Softswitch should be provisioned to generate either EMs or CDBs, but not both.
CautionWe strongly recommend that you provision the Cisco BTS 10200 Softswitch to generate either EMs or CDBs, but not both. Attempting to generate both types of records simultaneously can significantly degrade system performance. See the "Provisioning the System to Generate EMs for Billing" section for provisioning details.
The content of the CDBs is outside the scope of this document. See the Cisco BTS 10200 Softswitch Billing Interface Guide for information about CDBs.
Description of the Event Message Feature
EMs are real-time data records containing information about network usage and activities. (They must not be confused with system event messages that report events and sometimes trigger alarms.) EMs are used in PacketCable networks to collect resource usage data for billing purposes. In the PacketCable architecture, EM generation is based on the half-call model. A single EM can contain complete usage data or it might contain only part of the usage information.
The RKS is a PacketCable network element that receives EMs from network elements, such as the CMS, the MGC, and the CMTS. The physical Cisco BTS 10200 Softswitch contains both CMS and MGC logical network elements. The EMs generated by both the CMS and MGC are sent to the RKS. The RKS correlates the information in multiple EMs and provides the complete record of service for a call, which is referred to as a CDR.
For information about EM-related operations on the Cisco BTS 10200 Softswitch, see the "Operations, Billing, and EM Transfer Procedures" section.
Figure 3 illustrates the PacketCable network elements that are involved in the EM process.
Figure 3 Event Message Interfaces
The EM related interfaces illustrated here are described as follows:
1.
MGC to RKS—EMs generated by MGC (Cisco BTS 10200 Softswitch) are sent to RKS.
2.
CMS to RKS—EMs generated by CMS (Cisco BTS 10200 Softswitch) are sent to RKS.
3.
CMTS to RKS—EMs generated by CMTS are sent to RKS. The Cisco BTS 10200 Softswitch (MGC/CMS) is not involved.
4.
CMS to CMTS—CMS (Cisco BTS 10200 Softswitch) sends the billing correlation ID (BCID) to the CMTS using the dynamic quality of service (DQoS) GateSet message.
5.
CMS to MGC—An internal exchange of originating/terminating information such as BCID and financial entity ID (FEID).
PacketCable EMs can support billing and settlement activities for single-zone architectures. The originating and terminating CMSs exchange unique BCIDs and (FEIDs) for each half of the call. The originating CMS sends a BCID and an FEID in the INVITE message. The Cisco BTS 10200 Softswitch allocates the BCID for calls it originates or terminates. Along with the FEID, the BCID is used across network elements to reference calls. The FEID is provisioned on a system-wide basis (a single setting for the Cisco BTS 10200 Softswitch) as defined in the "Provisioning the System to Generate EMs for Billing" section.
Event Message Generation Details and Content
See the "EM Generation Details and Content" section for information on EM data.
Timestamp Support for Event Messages
The system-generated timestamps for EMs are based on the host operating system (OS) time and time zone. This data is not affected by command line interface (CLI) provisioning. The Solaris OS obtains the time automatically through Network Time Protocol (NTP) services.
CautionYou should never attempt to modify the system date or time in a Cisco BTS 10200 Softswitch host machine while system components (CA, feature server [FS], Element Management System [EMS], and Bulk Data Management System [BDMS]) are running. The attempt could cause the system to have serious problems. Allow the Solaris OS to obtain the time automatically through NTP services.
Event Message Transport
Remote Access Dial-In User Service (RADIUS) is a client/server protocol used for Authorization, Authentication, and Accounting (AAA). The RADIUS protocol is an industry standard for remote access AAA defined in a set of Internet Engineering Task Force (IETF) standards: RFC 2865 and RFC 2866.
The RADIUS transport protocol is used between the Cisco BTS 10200 Softswitch (CMS/MGC) and the RKS. The system sends EMs to an RKS without waiting for acknowledgment of the previous message. The maximum number of pending ACK messages is 256.
EMs are first sent to the primary RKS. If the specified number of retry attempts fail, the EMs are sent to the secondary RKS. If one RKS is found to be unreachable, then the other RKS is considered for subsequent messages. If both the primary and secondary RKSs become unreachable, the EMs are stored in an error file on the hard disk (as described in the "Event Message Storage on the CA" section) and a timer is started. When the timer expires, newly arriving EMs are sent to the primary RKS.
If EMs are being sent to the primary RKS and the primary RKS goes down, the Cisco BTS 10200 Softswitch sends subsequent EMs to the secondary RKS. When the primary RKS comes back up, the Cisco BTS 10200 Softswitch continues to send EMs to the secondary RKS. (It does not automatically begin sending them to the primary RKS.) Provisioning of timers and retry attempts is described in the "Provisioning Support for EM Transmission and Storage" section.
Event Message Storage on the CA
Note
For information on compliance with specific paragraphs of PacketCable standards and ECNs listed in this document, contact your Cisco account team.
EMs are stored in the network element (CA) that generates them until they are transferred to the RKS. After receipt of the EMs is acknowledged by the RKS, they are deleted. The number of EMs generated by the Cisco BTS 10200 Softswitch depends on the number of calls processed. Multiple EMs are generated for each call. Depending on provisioning in the call-agent-profile table and the type of call, EMs can be generated by the CMS or MGC (or both) within the CA. The exact storage requirement varies depending on the rate of EM generation and how long the Cisco BTS 10200 Softswitch is required to keep the records before transferring them to an RKS.
The Cisco BTS 10200 Softswitch generates and stores EMs with the following characteristics:
•
EMs are generated in real time during a call. EMs contain timestamps with a granularity of 1 millisecond. The time interval between generation and transmission is not specified.
•
The Cisco BTS 10200 Softswitch synchronizes with the network clock using NTP at least once per hour. The deviation of the clock in the Cisco BTS 10200 Softswitch remains within ±100 milliseconds between NTP synchronizations.
•
EMs that cannot be successfully transferred to the RKS due to loss of communication are stored in the /opt/BTSem directory on the CA. The system uses the file-naming conventions specified in PacketCable ECN EM-N-04.0186-3 for the stored EMs. The maximum EM file size and the time limit on keeping a file open are provisionable, as described in the "Provisioning Support for EM Transmission and Storage" section. These files are not automatically deleted or transferred out of the CA.
CautionEvent messages that cannot be successfully transferred to the RKS due to loss of communication are not automatically deleted or transferred out of the CA. You must transfer these files to the RKS when communication is restored.
The procedure for doing this is provided in the "Manual Recovery and Transfer of Stored EMs" section.
•
Each time an EM file is placed in local storage, the system checks current disk usage and takes the following actions:
–
The system generates an alarm if the disk space allocated to EMs fills up to a certain level—
50 percent (minor alarm), 70 percent (major alarm), or 100 percent (critical alarm).–
When the critical condition is reached, the system issues a critical alarm, and further EMs are dropped without any additional warning.
–
When the critical condition is reached, the disk usage is monitored periodically (one time every minute) to check if disk space usage has decreased and EMs can be stored again.
PCMM-Based QoS for Type 1 Clients
This section describes the implementation of the PacketCable Multimedia (PCMM) feature that provides quality of service (QoS) for type 1 clients managed by the Cisco BTS 10200 Softswitch. This feature is applicable to endpoints using SIP, MGCP, or H.323 as the call signaling protocol.
Note
The Cisco BTS 10200 Softswitch supports this PCMM-based feature in addition to all of the PacketCable-based features provided in earlier releases. If you would like detailed information on compliance with specific PacketCable specifications, contact your Cisco account team.
Figure 4 provides a sample system context for this feature.
Figure 4 Network Architecture with Policy Server and PCMM Interfaces
As shown in Figure 4, the PCMM implementation requires the Cisco BTS 10200 Softswitch to communicate with a policy server (PS), which is a third party device. For calls originating on, or terminating to a type 1 client, the Cisco BTS 10200 Softswitch acts as an application manager (AM) and sends requests to the PS for admission control through PCMM-based signaling. The PS in turn requests the CMTS to allocate bandwidth and other resources as in the request. After resources are allocated, the results are provided to the AM (via the PS) and the Cisco BTS 10200 Softswitch continues with call signaling to set up the call.
For the CLI provisioning procedure related to PCMM-based functions, see the "Provisioning PCMM-Based QoS for Type 1 Clients" section.
For maintenance commands related to the CMTS and PS, see the "Reset, Control, and Status Commands" section.
SOAP/XML Interface for CMS Subscriber Provisioning
This section describes the implementation of PacketCable CMS subscriber provisioning on the Cisco BTS 10200 with a Simple Object Access Protocol/Extensible Markup Language (SOAP/XML) interface.
This initial release supports only the Pkt-p1 interface to the PS/CMS and only the PcspService Object, without extensions. It supports a subset of the call feature objects in the ListOfCallFeatures element.
In the Pkt-p1 interface, the Cisco BTS 10200 Softswitch plays the role of CMS. Any third-party PS using SOAP Version 1.1 can provision the BTS. The requests and responses between the CMS and the PS are encapsulated in SOAP Version 1.1 messages. A secure transport protocol is provided by IPsec.
SOAP/XML Interface
Currently, a user can connect to a Cisco BTS 10200 CORBA server to access command templates and enter command executions, allowing system-to-system provisioning. The feature described in this document allows the XML commands to be transported by the SOAP transport protocol, rather than CORBA. Users of this feature communicate with a BTS SOAP server, which resides on the Cisco BTS 10200 EMS.
The Cisco BTS 10200 XML schema is a general purpose schema currently used by the XML/CORBA interface. The XML schema does not change with the incorporation of the SOAP transport protocol.
SOAP/XML Adapter and specifications are documented in the Cisco BTS 10200 Softswitch SOAP Adapter Interface Specification Programmer Guide.
System Components
CMS subscriber provisioning involves the interface between the following components:
•
Provisioning Server (PS)—Provides the interface between the service provider's back office components and the PacketCable elements. The PS consists of a provisioning application that contains provisioning logic and a provisioning SNMP entity that provides access to active components.
•
Call Management Server (CMS)—Provides call control and signaling-related services for the MTA and CMTS in the PacketCable network. The Cisco BTS 10200 is the CMS.
CMS Subscriber Provisioning
CMS subscriber provisioning includes the operations necessary to provide a specified service to a customer and provides two main functions:
•
CMS Basic POTS Provisioning (BPP)—Provides the CMS with the minimum information necessary for routing of plain old telephone service (POTS) in the PacketCable network. Data consists of a telephone number mapped to its associated MTA's fully qualified domain name (FQDN) and NCS endpoint identifier and is used to set up translation tables enabling the CMS to route calls to the appropriate device given a specific telephone number. BPP for a customer is required before the customer can receive any calls.
•
CMS Call Feature Provisioning (CFP)—Provides call features to a customer.
Call Features
The following call features are supported by the PacketCable CMS subscriber provisioning interface. The following list provides the name of each feature in PacketCable terminology, followed by the corresponding Cisco BTS 10200 feature in parentheses:
•
Calling Number Delivery (CND)
•
Calling Name Delivery (CNAM)
•
Calling Identity Delivery on Call Waiting (CIDCW)
•
Call Waiting (CW)
•
Cancel Call Waiting (CCW)
•
Call Forwarding Variable and Usage-Sensitive Call Forwarding (*72/*73) (CFVBBG)
•
Automatic Recall (*69) (AR)
•
Automatic Callback (*66) (AC)
•
Visual Message Waiting Indicator (VMWI)
•
Customer Originated Trace (*57) (COT)
•
Three Way Calling/Usage-Sensitive Three-Way Calling (*71) (TWC)
•
Remote Activation of Call Forwarding (RACF)
•
Anonymous Call Rejection (*77/*87) (ACR)
•
Call Forwarding Busy Line (*68/*40/*88) (CFB)
•
Call Forwarding Don't Answer (*68/*24/*88) (CFNA)
•
Call Forwarding Combination (CFU)
•
Selective Call Forwarding (*63/*83) (SCF)
•
Selective Call Acceptance (*64/*84) (SCA)
•
Selective Call Rejection (*60/*80) (SCR)
•
Distinctive Ringing/Call Waiting (*61/*81) (DRCW)
•
Speed Calling (*74/*75) (SC1D)
•
Line Service Restriction (COS)
•
Do Not Disturb (DND)
Prerequisites for CMS Subscriber Provisioning
This section lists requirements that must be met before provisioning the CMS subscriber.
•
The web server and SOAP engine are running.
•
The CMS and the PS reside in the same secure provisioning domain.
Limitations on CMS Subscriber Provisioning
This section lists limitations. These are conditions for which the CMS subscriber provisioning is not designed to work.
•
The CMS provisioning interface is limited to the exchange of service activation data between the CMS and the provisioning server.
•
The CMS provisioning interface supports only the existing CMS subscriber provisioning functionality in the Cisco BTS 10200.
•
The scope of the feature is limited to subscriber provisioning in a PacketCable 1.5 network.
•
The system supports only the Pkt-p1 interface to the PS/CMS and only the PcspService Object, without extensions. It supports a subset of the call feature objects in the ListOfCallFeatures element.
Planning
Delivery of the features and functions described in this document requires interoperability with the network elements connected to the Cisco BTS 10200 Softswitch. See the "Component Interoperability" section in the Cisco BTS 10200 Softswitch Release Notes, which lists the specific peripheral platforms, functions, and software loads that have been tested by Cisco for interoperability with the Cisco BTS 10200 Softswitch.
Note
The "Component Interoperability" section in the Cisco BTS 10200 Softswitch Release Notes is intended as a guide. Earlier or later releases of platform software might be interoperable, and it might be possible to use other functions on these platforms. The list certifies only that the required interoperation of these platforms, the functions listed, and the protocols listed have been successfully tested with the Cisco BTS 10200 Softswitch.
Installation
Installation of Cisco BTS 10200 Softswitch software follows a standard process. For details, see the Application Installation Procedure in the Cisco BTS 10200 Softswitch documentation set. Of the three main PacketCable feature areas (DQoS, EM, and security), two of them (DQoS and EM) are always installed, and do not require the setting of any special flags during software installation. However, the third area (security) is not installed unless a special flag (IPSEC_ENABLED) is set in the opticall.cfg file during software installation.
CautionWe strongly recommend that you contact Cisco Technical Assistance Centre (TAC) if you believe that you might need to reinstall Cisco BTS 10200 Softswitch software in order to change the value of IPSEC_ENABLED.
Provisioning Procedures
This section explains how to perform the following procedures:
•
Provisioning Basic PacketCable and DQoS Features
•
Provisioning Security Interfaces
•
Provisioning PCMM-Based QoS for Type 1 Clients
•
Provisioning AuditConnection Parameters
These tasks include examples of CLI commands that illustrate how to provision the specific feature. Most of these tables have additional tokens that are not included in the examples. For a complete list of all CLI tables, tokens, descriptions, valid ranges, and default values, see the Cisco BTS 10200 Softswitch CLI Database.
Note
The command sequences shown in this section provide guidance on how to provision a new system. Therefore, in most cases the commands are add commands. If you are modifying previously provisioned gateways (GWs), TGs, and so forth, use the change commands.
Provisioning Basic PacketCable and DQoS Features
This section describes how to provision the Cisco BTS 10200 Softswitch interfaces to connect to other PacketCable-based network elements (NEs) and how to select DQoS options. It includes the following tasks:
•
Provisioning the CMS Interfaces to the CMTS and eMTA
•
Provisioning DQoS Parameters for Codec Negotiation Service
•
Provisioning TGCP Interfaces to TGWs
•
Provisioning the Keepalive AUEP Ping Option
•
Provisioning MGCP Command Timeout and QoS Parameters
•
Provisioning the Aggregation ID Subnet
•
Provisioning CMTS Discovery Using the Static Subnet Table
•
Provisioning Subscriber ID Parameters and DQoS Measurement Counter
Provisioning CMS Parameters
This section describes how to provision DQoS functionality for the CMS logical entity on the Cisco BTS 10200 Softswitch (Call Agent).
SUMMARY STEPS
1.
add call-agent-profile id=<id>; dqos-supp=[y | n]; description=<description>;
2.
add ca-config type=<timer type>; datatype=INTEGER; value=<value>;
3.
add ca-config type=LOCAL-RINGBACK; datatype=BOOLEAN; value=<value>;
4.
add ca-config type=COPS-DSCP-TOS; datatype=INTEGER; value=<value>;
5.
add ca-config type=MAX-MGCP-DATAGRAM; datatype=INTEGER; value=<value>;
Note
The token values shown in this section are examples.
DETAILED STEPS
Provisioning the CMS Interfaces to the CMTS and eMTA
This section describes how to provision the interfaces to the CMTS and eMTA nodes. Specific tables are provisioned for each of these interfaces:
•
CMTS—The Aggregation Profile (aggr-profile) and Aggregation (aggr) tables define the parameters for the connected CMTS devices. These parameters are used by the COPS adapter to establish and terminate TCP connections to the CMTS.
•
MTA (or eMTA)—The Cisco BTS 10200 Softswitch uses the Media Gateway Profile (mgw-profile), Media Gateway (mgw), and Termination (termination) tables to establish and terminate connections to the eMTAs. The supported MGCP variant is NCS. The following tables are provisioned for this interface:
–
The mgw-profile table provides templates for defining each type of eMTA by hardware vendor. It identifies the specifications and settings necessary for communications between the Cisco BTS 10200 Softswitch (which functions as the CMS) and each type of eMTA. An mgw-profile ID must be created in this table before entries can be added to the mgw table. Several tokens have values that can be overwritten after the Cisco BTS 10200 Softswitch (CMS) queries the eMTA for supported capabilities. If the eMTA returns a value different from the value originally provisioned in the Cisco BTS 10200 Softswitch, the returned value automatically replaces the originally provisioned value.
–
The mgw table holds information about each eMTA managed by the Cisco BTS 10200 Softswitch (CMS). The eMTA can be uniquely addressed by domain name, an IP address, or the TSAP address.
–
The termination table holds information about each endpoint in eMTAs managed by the CMS. Termination events and signals are grouped into packages, which are groupings of events and signals supported by a particular type of endpoint, such as an eMTA endpoint. One or more packages can exist for a given endpoint-type.
SUMMARY STEPS
1.
add aggr-profile id=<id>; dqos-supp= [y | n];
2.
add aggr id=<id>; tsap-addr=<tsap-addr>; aggr-profile-id=<id>;
3.
add mgw-profile id=<id>; mgcp-version=<version>; mgcp-variant=<variant>; mgcp-default-pkg=LINE; mgcp-conn-id-at-gw-supp= [y | n];
4.
show mgw-profile;
5.
change mgw-profile id=<id>; mgcp-version=<version>; mgcp-variant=<variant>;
6.
add mgw id=<id>; tsap-addr=<tsap-addr>; call-agent-id=<id>; mgw-profile-id=<id>; type=rgw; aggr-id=<id>; node=<node>;
7.
add termination prefix=<prefix>; port-start=<port>; port-end=<port>; type=LINE; mgw-id=<id>;
8.
control mgw id=<id>; target-state=INS; mode=forced;
9.
status mgw id=<id>;
10.
equip subscriber-termination id=<id>;
11.
control subscriber-termination id=<id>; target-state=INS; mode=forced;
12.
status subscriber-termination id=<id>;
Note
The token values shown in this section are examples.
DETAILED STEPS
Command or Action PurposeStep 1
add aggr-profile id=<id>; dqos-supp=[y | n];Example:add aggr-profile id=aggrprofile001; dqos-supp=y;Creates the CMTS (aggregation device) and enables DQoS support.
CautionDQoS is disabled (DQOS-SUPP=N) by default. Set this value to Y to enable DQoS.
Step 2
add aggr id=<id>; tsap-addr=<tsap-addr>; aggr-profile-id=<id>;Example:add aggr id=cmts777;tsap-addr=ADDRESS123.cisco.com; aggr-profile-id=aggrprofile001
The TSAP-ADDR can be a DNS or IP address. If you enter a domain name system (DNS) address, it must be a fully qualified domain name (FQDN).
Step 3
add mgw-profile id=<id>; mgcp-version=<version>; mgcp-variant=<variant>; mgcp-default-pkg=LINE; mgcp-conn-id-at-gw-supp= [y | n];
Example:add mgw-profile id=mgwprofile777; mgcp-version=MGCP-1-0; mgcp-variant=NCS-1-0; mgcp-default-pkg=LINE; mgcp-conn-id-at-gw-supp=n;Creates the mgw-profile for this type of eMTA, and specifies values for the optional parameters.
The default values for these parameters might be adequate for your specific case. In each case, you can use the show command to find out how the parameter is currently set. See the Cisco BTS 10200 Softswitch CLI Database for parameter definitions and valid ranges.
Step 4
show mgw-profile;
Example:show mgw-profile id=mgwprofile777;
Shows the provisioned values for the parameters in the mgw-profile table.
Verify that the following values are present:
vendor=Cisco [or applicable vendor name]
mgcp-version=MGCP-1-0
mgcp-variant=NCS-1-0
mgcp-default-pkg=LINE
codec-neg-supp=y
pc-mptime-supp=y
mgcp-xdlcx-supp=n
domain-name-caching-supp=y
mgcp-conn-id-at-gw-supp=y
Step 5
change mgw-profile id=<id>; mgcp-version=<version>; mgcp-variant=<variant>;
Example:change mgw-profile id=mgwprofile777; mgcp-version=MGCP-1-0; mgcp-variant=NCS-1-0;
(Optional) If any of the mgw-profile token values (from Step 4) need to be changed, use the change mgw-profile command.
Step 6
add mgw id=<id>; tsap-addr=<tsap-addr>; call-agent-id=<id>; mgw-profile-id=<id>; type=rgw; aggr-id=<id>; node=<node>;
Example:add mgw id=CiscoGW50; tsap-addr=192.168.26.104; call-agent-id=CA146; mgw-profile-id=mgwprofile777; type=rgw; aggr-id=cmts777; node=main0044;
Creates the mgw id for a single eMTA, and specifies values for the other required parameters.
Be sure to set type=rgw or an eMTA.
You must enter the value for aggr-id to identify the appropriate CMTS for this eMTA.
The node token allows you to identify a hybrid fiber coax (HFC) node to which the eMTA is assigned. Typically, each eMTA is assigned to a node, and one or more nodes are assigned to a CMTS.
Step 7
add termination prefix=<prefix>; port-start=<port>; port-end=<port>; type=LINE; mgw-id=<id>;
Example:add termination prefix=aaln/; port-start=1; port-end=2; type=LINE; mgw-id=CiscoGW50;
Creates the line termination for the eMTA and specifies values for the required parameters.
For eMTA terminations, always enter type=LINE.
Step 8
control mgw id=<id>; target-state=INS; mode=forced;
Example:control mgw id=CiscoGW50; target-state=INS; mode=forced;
Brings the eMTA in service (INS state).
Step 9
status mgw id=<id>;
Example:status mgw id=CiscoGW50;
Verifies that the administrative state is INS.
Step 10
equip subscriber-termination id=<id>;
Example:equip subscriber-termination id=sub3456;
Equips the termination.
Step 11
control subscriber-termination id=<id>; target-state=INS; mode=forced;
Example:control subscriber-termination id=sub3456; target-state=INS; mode=forced;
Places it in service (INS state).
Step 12
status subscriber-termination id=<id>;
Example:status subscriber-termination id=sub3456;
Verifies that the administrative state is INS.
Provisioning DQoS Parameters for Codec Negotiation Service
The Quality of Service (qos) table is used in providing the codec negotiation service. Codec negotiation is the process the Cisco BTS 10200 Softswitch uses to find a common codec for the compression or decompression of a signal between two gateways. The Subscriber Profile (subscriber-profile) and Subscriber (subscriber) tables point to the qos table.
The following commands allow you to specify the required characteristics for these tables.
SUMMARY STEPS
1.
add qos id=<id>; codec-type=<type>; client-type=dqos;
2.
add subscriber-profile id=<id>; dial-plan-id=<id>; POP=<POP; qos-id=<id>;
3.
add subscriber id=<id>; dn1=<dn1>; sub-profile-id=<id>; qos-id=<id>; term-type=<type>;
Note
The token values shown in this section are examples.
DETAILED STEPS
Provisioning TGCP Interfaces to TGWs
This section describes how to provision the TGCP interfaces to the TGWs.
The mgw-profile table provides templates for defining each type of TGW by hardware vendor. It identifies the specifications and settings necessary for communications between the Cisco BTS 10200 Softswitch (which functions as the MGC) and each type of TGW. Several tokens in this table have values that can be overwritten after the Cisco BTS 10200 Softswitch (MGC) queries the TGW for supported capabilities. If the TGW returns a value different from the value originally provisioned in the Cisco BTS 10200 Softswitch, the returned value automatically replaces the originally provisioned value.
SUMMARY STEPS
1.
add mgw-profile id=<id>; vendor=<vendor>; mgw-type=<type>; mgcp-version=<version>; mgcp-variant=<variant>; mgcp-default-pkg=<pkg>; pc-mptime-supp=[y | n];
2.
add mgw id=<id>; tsap-addr=<tsap-addr>; call-agent-id=<id>; mgw-profile-id=<id>; type=<type>;
3.
add termination prefix=<prefix>; mgw-id=<id>; port-start=<port>; port-end=<port>; type=<type>;
4.
add qos id=<id>; lptime=<time>; hptime=<time>; codec-type=<type>; client-type=<type>;
5.
add trunk-grp id=<id>; call-agent-id=<id>; tg-type=<id>; qos-id=<id>; mgcp-pkg-type=<type>; pop-id=<id>;
Note
The token values shown in this section are examples.
DETAILED STEPS






