Cisco Voice Services Provisioning Tool User's Guide, 2.5.2
Cisco Voice Services Provisioning Tool Overview
Downloads: This chapterpdf (PDF - 253.0 KB) The complete bookPDF (PDF - 1.35 MB) | Feedback

Cisco Voice Services Provisioning Tool Overview

Table Of Contents

Cisco Voice Services Provisioning Tool Overview

Provisioning Introduction

VSPT Introduction

VSPT Basics

VSPT Field Definitions

VSPT Data Entry Requirements

Starting the VSPT

Using the VSPT


File Menu

View Menu

Tools Menu

Help Menu

Configuration Editor Views

Defining Users and Permissions

Exiting the VSPT

Cisco Voice Services Provisioning Tool Overview

Cisco Open Packet Telephony (OPT) provides the framework for delivering voice services over packet-based data, voice, and video networks. OPT encompasses a broad range of hardware platforms and Cisco software, delivering a continuum of voice solutions from core infrastructure to enhanced services over circuit and packet networks. The Cisco Media Gateway Controller (MGC) is at the center of Cisco OPT solutions.

Provisioning a Cisco MGC is the process of preparing it to communicate with an SS7 network, with Cisco media gateways, and with the other components of an OPT solution. The Cisco Voice Services Provisioning Tool (VSPT) provides an easy-to-use graphical tool to provision Cisco MGCs.

Individual releases of the VSPT are designed to be used with specific releases of the Cisco MGC software. VSPT Version 2.5(2) is designed to be used with Cisco MGC Version 9.5(2). If you are using a different release of the Cisco MGC software, see the Installation Guide Table 1-1 to identify the release of VSPT that you need.

This chapter introduces the VSPT and provides directions for obtaining, installing, and using the software.

This chapter contains the following sections:

Provisioning Introduction

VSPT Introduction

VSPT Basics

Starting the VSPT

Using the VSPT

Defining Users and Permissions

Exiting the VSPT

Provisioning Introduction

All solutions involving the Cisco MGC are configured through the use of one or more Cisco MGC hosts, one or more Signaling System 7 (SS7) network signaling options, and one or more media gateways that control bearer-traffic routing.

Note In this document, a solution is a logical combination of Cisco hardware and software configured to perform a specific network task.

Prior to starting any provisioning session, you should have a clear understanding of the network topology for your solution. Create a network drawing, and refer to it while configuring your network.

In addition, you should perform the following tasks before starting a provisioning session:

Thoroughly plan your network configuration. Refer to the documentation for your solution for detailed network configuration information.

Set up your system hardware, and install all required software. For more information, refer to Prerequisites in Chapter 1 of the Installation Guide, and the Cisco Media Gateway Controller Software Version 9 Installation and Configuration Guide at

VSPT Introduction

The VSPT allows you to import an existing configuration, modify the configuration, and export it to the same or different devices. The VSPT can also facilitate provisioning of individual call parameters, simplifying the provisioning of a large live network.

Using the VSPT helps avoid common errors that might arise if devices are provisioned independently, eliminates the need to enter duplicate data, and enables importing and exporting configurations to and from the Cisco PGW 2200. The VSPT generates configuration files necessary to provision the PGW 2200, including the following provisioning information:


Trunk groups



Dial plans

During a provisioning session, the VSPT automatically generates the Man Machine Language (MML) or command line interface (CLI) scripts used to configure network elements, assembles these commands into a batch file, and deploys the file to the appropriate network device.

The VSPT allows scheduled backups and restores of configurations on the following devices:

MGC Host—Active configuration or entire MGC system

Catalyst 2900XL—Running-config and image in Flash

Catalyst 5500—For switch module and RSM, configuration and image in Flash

Catalyst 6509—For switch module and MSFC, configuration and image in Flash

SLT 2600—Running-config and image in Flash

BAMS Phase 3—Active configuration

HSI Adjunct Server—Active configuration

VSPT can be installed with the CSCOk9000 package to support secure communications to SSH-enabled devices, the Cisco MGC host, the BAMS server, or the HSI server. The following operations all can use SSH:

Provisioning of an SSH-enabled Cisco PGW 2200

Launching of ssh rather than Telnet for communicating with SSH-enabled network devices through a command-line interface

Use of SSH to secure X windows communications with the end-user display device

Use of SSH in place of Telnet for the initial step (logging into the component to be backed up and getting the configuration) in a backup and restore operation. The configuration is copied to a TFTP server using standard TFTP.

The VSPT can be deployed as an integrated component of the Cisco MGC Node Manager or as a standalone application. If it is installed on the Cisco MGC, call throughput might be impacted when the VSPT is active. It typically runs on a standalone UNIX server that is also running the Cisco MGC Node Manager (Cisco MNM) and supports multiple users and provisioning sessions. You can launch the VSPT from the managed object icon in the Cisco MNM Map Viewer. For information about Cisco MNM, refer to the Cisco MGC Node Manager User's Guide Version 2.5(2) at

This document is designed to help you get started using the VSPT, and does not include complete provisioning instructions, which are found in the Cisco Media Gateway Controller Software Version 9 Provisioning Guide at, in particular Chapter 3, Provisioning with the Voice Services Provisioning Tool at

Detailed instructions for provisioning dial plans are covered in the Cisco Media Gateway Controller Software Version 9 Dial Plan Guide at, in particular Chapter 3, "Provisioning Dial Plans with the VSPT", at

VSPT Basics

This section describes the requirements for entering provisioning data using the VSPT.

VSPT Field Definitions

Table 2-1 lists VSPT field names, which correspond to system components in the Cisco MGC, and their definitions. For more information about system components, refer to the Cisco Media Gateway Controller Software Version 9 Provisioning Guide.

[this table is not a comprehensive list of provisioning components but a list and description of the major fields displayed in the MGC Config window]


Table 2-1 Field Name Definitions 

Field Name

MGCP1 Signaling Service

An MGCP signaling service is a signaling service between the Cisco MGC and a media gateway.

IP Link for MGCP

An IP Link for MGCP is a link for the MGCP signaling services.

MGC Host

An origination point code (OPC) is the address of the Cisco MGC you are provisioning.


Hardware card provisioning for the Ethernet cards in the Cisco MGC host.

Point Codes


Originating Point Code

An originating point code (OPC) is the address for the Cisco MGC.

Adjacent Point Code

An adjacent point code (APC) is the address of an STP2 that sends and receives signaling messages to and from the Cisco MGC.

Destination Point Code

A destination point codes (DPC) is the address of an endpoint, such as a PSTN3 switch that carries the bearer traffic.

Routing Keys


M3UA Route Key

A Transpath NE component that represents the M3UA Routing key, a child of an OPC.

SUA Route Key

A Transpath NE component that represents an SUA Routing key, a child of an OPC.


A LinkSet is a set of links from the MGC to an endpoint, such as an adjacent STP.

SS7 Subsystem)

A logical connection between a pair of mated STPs that allows the Cisco MGC to route through either STP to an endpoint.

ISUP Timer Profile

ISDN User Part (ISUP) timer profile provisioned for signaling service.


Intelligent network services table; can be changed at any time and is dynamically reconfigurable.

SS7 Path (SS7 Signaling Service)

An SS7 path is a connection between the Cisco MGC and a specified point code.

SS7 Route

An SS7 route is a route for each signaling path from the Cisco MGC to the PSTN switch through the linksets you have created to the STPs.

IP Route

A static IP route.

M3UA Route

An M3UA route is a route for each signaling path from the Cisco MGC to the PSTN switch through the SGNode using M3UA.

SUA Route

An M3UA route is a route for each signaling path from the Cisco MGC to the PSTN switch through the SGNode using M3UA.

SS7 Signaling Gateway

SS7 Signaling gateway

SS7 SG Nodes

SS7 signaling gateway nodes

SS7 SG Subsystem

SS7 signaling gateway subsystem.

SS7 SG Pairs

SS7 signaling gateway pair

SS7 SG Sigpaths

SS7 service to a signaling gateway

Line Number Translation

Line number translation represents a line number and internal number translation.and is dynamically reconfigurable.


SIP (session initiation protocol) service, the connection between an MGC and a SIP server.

Auto Congestion Ctrl


Response Category

Auto Congestion Control response categories that may be associated with a trunkgroup (MGC configuration) or a signalling path (SC configuration).

MCL Threshold

Definition of onset and abate values of different contributing factors for Machine Congestion Lavel(MCL).

MCL Callreject

The definition of call reject percentage in different machine congestion levels (MCL)

Advice of Charge



Holiday table that provides the capability to distinguish specific days of the year and charge them differently from the actual day of the week that the holiday falls on.


Charge table that defines the tariff rates (table index key for tariff.dat) and their durations.


Tariff table contains the tariff rates and scale factors. Each row is referenced by a tariff id which call processing will obtain by accessing the Charge table.

GTD Parameters

GTD (generic transparency descriptor) transports ISUP messages and parameters, using a generic format, between the ingress and egress Cisco PGW 2200 Signaling Controllers.

External Node

An external node is any object in the network that is connected to the Cisco MGC, for example, media gateways (Cisco MGWs) and associated BSCs4 .


ITP (Internet Transfer Point), a signaling gateway to the SS7 network


DPNSS5 signaling path that is backhauled over IP to/from a Network Access Server (destination).


An SCTP6 association represents the connection between the Cisco MGC and a Cisco access server.


Signaling gateway process


EISUP signaling service or signaling path, the signaling path to an externally located MGC (destination).

C7 IP Link

A link to the SS7 network (for example, an SSP7 or STP) from the Cisco MGC through a Cisco SLT.


A pair of backhaul IP links used on the PGW, used to communicate with external nodes that support IPFAS or BSMV0.


Network access server (NAS) signaling path, the Q.931 protocol path between the MGC and the media gateway

1 MGCP = Media Gateway Control Protocol.

2 STP = signal transfer point.

3 PSTN = Public Switched Telephone Network.

4 BSC = Broadband Service Card.

5 Digital Private Network Signaling System

6 SCTP = Stream Control Transmission Protocol

7 SSP = service switching point.

VSPT Data Entry Requirements

When you are entering data into the VSPT windows, follow standard MML conventions for names and descriptions. Each MML name must have the following characteristics:

A maximum of 20 alphanumeric characters, including dashes

No space, underscore, or special characters

Must start with an alphabetic character

For example: name="dpc1"

MML descriptions can be as many as 128 characters and can include spaces and symbols. You should use a description that helps to identify the component or link that you are provisioning. For example, for an SS7 route, which indicates the signaling path from the Cisco MGC to a switch through a linkset, you could create a description "SS7 Route to PSTN Switch A through Linkset 1." For more information about MML, refer to the Cisco Media Gateway Controller Software Version 9 MML Command Reference Guide.

The VSPT GUI enables you to step through the provisioning process in a logical sequence. The sequence of steps is described in the Cisco Media Gateway Controller Software Version 9 Provisioning Guide.

Starting the VSPT

Note See the Cisco Media Gateway Controller Software Version 9 Installation and Configuration Guide for information on setting up user privileges and access rights.

Perform the following steps to start the VSPT:

Step 1 Do one of the following:

To start VSPT standalone:

Log in to the VSPT server or access it from a machine with X window capability.

In a terminal window, change to the default directory:

>cd /opt/CSCOvsp25

Navigate to the appropriate directory if you installed the VSPT in a different location.

Enter the following command to start the VSPT:


The login screen shown in Figure 2-1 appears.

Figure 2-1 Login Screen

Step 2 Enter your user name and password and click OK.

The default user name is admin, and the password is also admin.

The Welcome screen is displayed briefly during the login process, and the main window appears (see Figure 2-2).

Figure 2-2 Main VSPT Window

Using the VSPT

This section describes the VSPT menus and Configuration Editor views, and provides directions for using the tool functions.


The VSPT menu bar contains these menus:





These menus are described in the following sections.

File Menu

Table 2-2 describes File menu commands.

Table 2-2 File Menu commands 



Begin a new configuration session


Open an existing configuration


Import an existing configuration from an MGC, or import trunk group, trunk, routing, or dial plan files into the VSPT


Export configuration files from the VSPT to a specified directory


Save the current configuration:

As Working: Use to save a new configuration, either a configuration imported from the Cisco PGW or a configuration created in VSPT, and to save modifications to an existing configuration, overwriting the last version. The configuration is saved in the /var/opt/CSCOvsp24/data/mgc/mistral directory.

As Snapshot: Use to save modifications to an existing configuration under a new name in the ARCHIVE directory. The snapshot configuration is saved in /var/opt/CSCOvsp24/data/mgc/mistral/<configname>/ARCHIVE

As New Config: Use to save a modified configuration under a new name, leaving the original intact.


Stop any open provisioning sessions and close the VSPT.

View Menu

Table 2-3 describes View menu commands.

Table 2-3 View Menu commands 



Show generated MML for the current configuration

MGW Commands

Show generated Cisco MGX 8850 commands for the current configuration.

Trunk Group File

Show generated trunk group file for the current configuration

Trunk File

Show generated trunk file for the current configuration

Tools Menu

Table 2-4 describes Tools menu commands.

Table 2-4 Tools Menu commands 


Integrity Check

Check your configuration for inconsistencies and missing information


Move the configuration to one or more target hosts and Cisco media gateways (MGWs)


Open a Telnet or SSH session

MGC Viewer

View, activate, remove, and synchronize configurations on the MGC.

BAMS Config

View and configure a Billing and Measurements Server (BAMS). Refer to the Billing and Measurements Server User's Guide for your release of BAMS for information about BAMS configuration.

State Operation

View and configure the state of MGC components.

Screening Editor

View and configure screening number provisioning. Refer to the Cisco MGC Software Version 9 Dial Plan Guide for information about using the VSPT Screening Editor.


Audit bearer trunk information between the Cisco MGC and the BAMS.

Backup and Restore

Create, modify, or delete scheduled backups or restores on the Cisco MGC Host, Catalyst 2900XL, Catalyst 5500, Catalyst 6509, SLT 2600, BAMS P3, and HSI server components.


Change Password

Change your password.

User Administration

Add, modify, or delete users.

Help Menu

Table 2-5 describes Help menu commands.

Table 2-5 Help Menu commands


MNM-PT User Guide

View a local version of the VSPT User Guide.

About MNM-PT

View information about the current version of VSPT, including the software release number.

Configuration Editor Views

You create, view, and modify configurations using the VSPT Configuration Editor, which has three different views. Select a view by clicking one of the radio buttons at the top of the Configuration Editor window:

MGC Config—MGC Configuration view. Use to add components and provision component properties.

Traffic—Traffic view. Use to create customer-specific files, including trunk groups, trunks, and routing.

Number Analysis—Number Analysis view. Use to provision dial plans.

In each view, the left pane displays selectable components in an Explorer-type tree view. The right pane displays data entry fields for the selected component. Click a component to select it. To see all of the subcomponents for the component you select, click the icon next to the component name to expand the component list.

Note For instructions for using the VSPT to provision components, component properties, trunk groups, trunks, and routing, refer to the Cisco Media Gateway Controller Software Version 9 Provisioning Guide. For instructions for using the VSPT to provision a dial plan, refer to the Cisco Media Gateway Controller Software Version 9 Dial Plan Guide.

Defining Users and Permissions

After you install the VSPT, you define users and their respective permissions using the following procedure:

Step 1 Log in to the server as root.

Step 2 Start VSPT, either by first starting Cisco MGC Node Manager and then starting VSPT, or by starting it standalone.

Step 3 Click Tools > User Admin.

The screen in Figure 2-3 appears.

Figure 2-3 VSPT User Administration

Step 4 To add a user, do the following:

Enter a user name and password.

From the Permission dropdown list, select the desired permission level, viewer, user, or admin.

Click Add.

Step 5 To modify a user, select the user name, change the password or permission level, and click Modify.

Step 6 To delete a user, select the user name, and click Delete.

Exiting the VSPT

You can exit the VSPT by performing one of these actions:

Click File > Exit. Click OK at the resulting prompt.

Click the close box in the upper right of the VSPT screen. Click OK at the prompt.