This preface describes the objectives, audience, organization, and conventions of this document, and explains how to find additional information on related products and services. It contains the following sections:
This document describes the information you need to provision your Cisco PGW 2200 Softswitch. The document contains tables and worksheets for you to use for provisioning your system.
Audience
The primary audience for this document is network operators and administrators who have experience in the following areas:
•Telecommunications network operations
•Data network operations
•SS7 protocols, switching, and routing
•Telecommunications hardware
•Data network hardware
In addition, the following audiences may find this document useful:
This chapter includes a checklist of tasks to perform before you use this guide to provision your system, and information to gather before beginning. It also includes the following information:
This appendix contains worksheets to use for provisioning.
Document Conventions
Caution Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.
Note Means reader take note. Notes contain helpful suggestions or references to materials not contained in this manual.
Tip Means the following information might help you solve a problem.
Timesaver Means the described action saves time. You can save time by performing the action described in the paragraph.
Syntax Conventions
In Chapter 4, "MML Basics" and in Chapter 5, "Adding Components with MML," the same command syntax conventions are used as those shown by MML itself when the MML command HELP is entered within MML. For MML commands, the Backus-Naur conventions are used. For additional information on the MML command syntax, refer to the Cisco PGW 2200 Softswitch Release 9 MML Command Reference.
Conventions used throughout this guide are shown in .
Table 2 Conventions
Convention
Meaning
Description / Comments
Boldface
Commands and keywords you enter as shown.
offset-list
Italics
Variables for which you supply values.
commandtype interface
You replace the variable with the type of interface.
In contexts that do not allow italics, such as online help, arguments are enclosed in angle brackets (< >).
Square brackets ([ ])
Optional elements.
command [abc]
abc is optional (not required), but you can choose it.
Vertical bars ( | )
Separated alternative elements.
command [ abc | def ]
You can choose either abc or def, or neither, but not both.
Braces ({ })
Required choices.
command { abc | def }
You must choose either abc or def, but not both.
Braces and vertical bars within square brackets ([ { | } ])
A required choice within an optional element.
command [ abc { def | ghi } ]
You have three options:
nothing
abc def
abc ghi
Caret character (^)
Control key.
The key combinations ^D and Ctrl-D are equivalent: Both mean "hold down the Control key while you press the D key." Keys are indicated in capital letters, but are not case sensitive.
A nonquoted set of characters
A string.
For example, when setting an SNMP community string to public, do not use quotation marks around the string; otherwise, the string will include the quotation marks.
System prompts
Denotes interactive sessions, indicates that the user enters commands at the prompt.
The system prompt indicates the current command mode. For example, the prompt Router (config) # indicates global configuration mode.
Screen font
Terminal sessions and information the system displays.
Angle brackets (< >)
Nonprinting characters such as passwords.
Exclamation point (!) at the beginning of a line
A comment line.
Comments are sometimes displayed by the Cisco IOS software.
Conventions used in the Cisco PGW 2200 Softswitch system (such as in MML commands) are shown in .
Table 3 Data Types
Data Type
Definition
Example
Integer
A series of decimal digits from the set of 0 through 9 that represents a positive integer. An integer may have one or more leading zero digits (0) added to the left side to align the columns. Leading zeros are always valid as long as the number of digits is less than or equal to ten digits. Values of this type have a range of zero through 4294967295.
123
000123
4200000000
Signed integer
This data type has the same basic format as the integer but can be either positive or negative. When negative, it is preceded by the sign character (-). As with the integer data type, this data type can be as many as ten digits in length, not including the sign character. The value of this type has a range of 0 minus 2147483647 through 2147483647.
123
-000123
-2100000000l
Hexadecimal
A series of 16-based digits from the set of 0 through 9, a through f, or A through F. The hexadecimal number may have one or more leading zeros (0) added to the left side. For all hexadecimal values, the maximum size is 0xffffffff (eight hexadecimal digits).
1f3
01f3000
Text
A series of alphanumeric characters from the ASCII character set, where defined. Tab, space, and double quote (" ") characters cannot be used. Text can be as many as 255 characters; however, it is recommended that you limit the text to no more than 32 characters for readability.
EntityID
LineSES_Threshold999
String
A series of alphanumeric characters and white-space characters. A string is surrounded by double quotes (" "). Strings can be as many as 255 characters; however, it is recommended that you limit the strings to no more than 80 characters for readability.
"This is a descriptive string."
Hexadecimal and integer fields in files may have different widths (number of characters) for column alignment.
Documentation Roadmap and Documentation Suite
Consult the following related documentation for information about the Cisco PGW 2200 Softswitch software and the solutions it supports, including the Cisco SS7 Interconnect for Access Servers Solution and the Cisco SS7 Interconnect for Voice Gateways Solution and the Cisco Packet Tandem Solution.
Documentation Roadmap
You can find the Cisco PGW 2200 Softswitch Documentation Map at the following URL:
•Release Notes for Cisco PGW 2200 Softswitch Release 9.7(3)
•Cisco Media Gateway Controller Online Documentation Notice
•Cisco Media Gateway Controller SLT Documentation Notice
•Billing and Measurements Server User's Guide
Gateway Documentation
Cisco DAS and H.323 VoIP Gateway Installation and Configuration Guide
Terminology
The following terms are used in this document:
•Cisco PGW 2200 Softswitch host—A Sun host server running Cisco PGW 2200 Softswitch software.
•Cisco PGW 2200 Softswitch node—An active and standby Cisco PGW 2200 Softswitch.
•Simplex Cisco PGW 2200 Softswitch node—A node that uses a single Cisco PGW 2200 Softswitch host. Typically, such nodes are used for solution evaluation tests or for small installations. In this configuration, any loss of service in the Cisco PGW 2200 Softswitch host disrupts all call traffic.
•Continuous-service Cisco PGW 2200 Softswitch node—A node that uses two Cisco PGW 2200 Softswitch hosts to prevent system downtime caused by failure of a single host. Calls in progress are maintained when one Cisco PGW 2200 Softswitch host fails. Continuous-service nodes use ITP-Ls to preprocess SS7 signaling and distribute signaling to both Cisco PGW 2200 Softswitch hosts. If a failover occurs, all stable calls are maintained. A continuous-service node may also be referred to as a fault-tolerant node or an active-standby PGW pair.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation at
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.
Summary History of Document Changes
describes the document changes made after the initial release of the Cisco PGW 2200 Softswitch Release 9 Provisioning Guide (through Release 9.7).
Added a Tip to the "Routing" section on page 5-27 to provide a link to detailed descriptions of the parameters that are used with the rttrnkgrp, rttrnk, and rtlist components.
Updated the product name to Cisco PGW 2200 Softswitch throughout the document.
Removed the obsolete note in the "Trunk Group Properties" section on page 3-109, "Although the property order in the Cisco VSPT Trunk Group Data and Property window is somewhat different from that required in the MML file, the output file that Cisco VSPT generates uses the correct sequence. For a list of properties in that sequence, see Table 2-30 on page 2-61."
•Added Cisco IP Transfer Point - LinkExtender (ITP-L) as the new name for Cisco Signaling Link Terminal (SLT). Over time, Cisco ITP-L will replace Cisco SLT in publications and the product.
Updated for Release 9.7
OL-1110-13, November, 2007
•Added new information for Release 9.7 features.
Added feature information
OL-1110-12, October, 2007
•Modified CDR 4239, added CDR 4065 for Redirect Server feature.
Added feature information
OL-1110-12, October, 2007
•Added the following properties for the SIP Loose Routing feature:
–*.sipEgressRoutingControl
–*.sipIngressRoutingControl
Added feature information
OL-1110-12 June 27, 2007
•Added the *.ItpActionRequest property for the Optimize Routing with MAP Query feature.
•Added the following new properties for software Release 9.5(2): MwiStringON, MwiStringOFF, TransferAwaitConnect, MWIInvokeTimerT1, SSCTInvokeTimerT1, SipReferForSimpleStepXfer, GWDefaultATMProfile, PlayAnnouncement, AtmConnectionType, BTechPrefix, LoopAvoidanceSupport, LoopAvoidanceCounter, and CliCodeOfPractice3
Added feature information
OL-1110-09 October 30, 2003
•Added DPNSS as a protocol family supported by SuppressCLIDigits. in Table A-68.
Documentation Roadmap and Documentation Suite
