Cisco Voice Services Provisioning Tool User's Guide, 1.6
Downloads: This chapterpdf (PDF - 231.0 KB) The complete bookPDF (PDF - 1.79 MB) | Feedback

Voice Services Provisioning Tool Overview

Table Of Contents

Voice Services Provisioning Tool Overview

Provisioning Introduction

VSPT Introduction

Installing the VSPT



Upgrading VSPT Software

Saving Configuration Files

Uninstalling the VSPT Software

Installing the VSPT Software

VSPT Basics

VSPT Field Definitions

VSPT Data Entry Requirements

Starting the VSPT

Using the VSPT

Menu Bar


Defining Users and Permissions

Exiting the VSPT

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 all Cisco OPT solutions.

Note A solution is a combination of Cisco hardware and software configured to perform a specific network task.

Provisioning is the process of preparing a Cisco Media Gateway Controller (MGC) 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 Media Gateway Controllers.

This chapter introduces the Voice Services Provisioning Tool (VSPT), Release 1.6, and provides directions for obtaining and installing the software. In addition, it provides basic information for using the tool.

This chapter contains the following sections:

Provisioning Introduction

VSPT Introduction

Installing the VSPT

VSPT Basics

Starting the VSPT

Using the VSPT

Defining Users and Permissions

Exiting the VSPT

Provisioning Introduction

All solutions involving the Cisco MGC are configuredwith 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.

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 using this guide:

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" section, and the following documents

Cisco Media Gateway Controller Hardware Installation Guide

Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide

VSPT Introduction

The VSPT can be deployed as an integrated component of the Cisco MGC Node Manager or as a standalone application. It typically runs on a separate UNIX server and supports multiple users and provisioning sessions. It allows you to import an existing configuration, modify the configuration, and export it to the same or different devices. Alternately, it offers you high-level configuration steps that you can use to create the initial network provisioning information for a newly installed node, creating iterative entries from a single operation. It can also facilitate provisioning of individual call parameters, simplifying the provisioning of a large live network.

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.

Note This document does not include instructions for dial plan provisioning. For dial plan information, refer to the Cisco Media Gateway Controller Software Release 7 Dial Plan Guide.

Installing the VSPT

If you are a registered Cisco Connection Online (CCO) user, you can download the VSPT software from the Cisco website. Before installing the VSPT, you must verify the following:

You have the latest release of the VSPT software. Visit the following Cisco website to check the VSPT release number (a valid login to the VSPT Cisco website is required): > Software Center > Voice Software > Cisco Voice Services Provisioning Tool

The workstation hardware and software requirements have been met.

The network connectivity has been established between your workstation and the network elements.

The network elements have the correct release of software installed.

Note Make sure you have root access on your Sun workstation (sudo access is not adequate).

Tip Before you begin provisioning, you should have a list of components you want to provision, including the component names, IP addresses, properties, and other parameters. You can create them using the worksheets provided in the Cisco Media Gateway Controller Software Release 7 Provisioning Guide. In addition, descriptions of the properties and values contained in the VSPT are included in Appendix A of the Cisco Media Gateway Controller Software Release 7 Provisioning Guide and in the following chapter. Review this information before you begin provisioning and keep it available for reference during provisioning.


To install the VSPT software, you must have the following:

Sun SPARC station running Solaris version 2.6 or earlier.

Sun Ultra-5 Workstation (333 MHz or faster).

Sun Solaris 2.6 (5/98 release is recommended).

Open windows with the Common Desktop Environment (CDE).

Latest Solaris 2.6 recommend patch set. (Log in to then click on Patches).

Cisco Media Gateway Controller Software Release 7.

8-bit video graphics card.

Disk space:

Approximately 20 MB of disk space for installation

Directory /var/opt/data/

Approximately 1 MB for each configuration

Approximately 1 MB for each configuration snapshot

Directory /var/opt/log/

Approximately 0.5 MB for each deployment


Minimum: 128 MB

Recommended: 256 MB or greater

Swap space:

Minimum: 128 MB

Recommended: 256 MB or greater

Cisco Media Gateway Controller Software Release 7

Note Running the VSPT on the same host as the Cisco MGC can adversely impact performance. We recommend using a separate server.


VSPT supports multiple solutions and enables you to provision components for these solutions. Some components may not apply to your solution. Make sure you understand your solution component requirements. For information, refer to the provisioning guide for your solution.

Upgrading VSPT Software

If you have an older release of the VSPT already installed (such as VSPT, Release 1.5) and you are upgrading to VSPT Release 1.6, the existing VSPT data is automatically migrated to VSPT Release 2.0; you do not need to uninstall the older release . However, if an incremental release is detected during the installation, you are prompted to uninstall the older release (for example, Release 1.5.1 cannot coexist with Release 1.5.2 and must first be uninstalled).

Note Because the uninstall directory and files are removed during uninstall, do not run the uninstall script from within the /opt/CSCOspgw directory.

Saving Configuration Files

Before uninstalling the VSPT software, you can save current configuration data and administrative information so users and logins do not have to be recreated after the upgrade. Use the following procedure to save data and user information:

Step 1 Log in to the server as root.

Step 2 Create a temporary directory to hold the pertinent files.

Step 3 Use the following command to copy the password file, /var/opt/CSCOvspXX/etc/dartpwd.txt, to the temporary directory.

# cp -p /var/opt/CSCOvspXX/etc/dartpwd.txt /<temporary directory>/dartpwd.txt

Step 4 Change to the /var/opt/CSCOvspXX/data directory.

Step 5 Use the tar commend to archive all files in the directory.

Note The tar command preserves file permissions.

Step 6 Copy the archive file to the temporary directory.

After you upgrade the VSPT software, replace the /var/opt/VSVOvsp<New>/etc/dartpwd.txt file and the /var/opt/CSCOvsp<New>/data directory with the archive files you saved in the temporary directory.

Uninstalling the VSPT Software

Use the following procedure to uninstall the software:

Step 1 Enter the following commands:

>su -root

>cd /


The uninstallation process removes all files and directories created by the installation process. If a directory contains a file that was not created during the installation process, it is not removed and is logged in the uninstall.log file. This might occur in the data and log directories.

Step 2 Proceed with the VSPT software installation (see "Installing the VSPT Software" section).

Installing the VSPT Software

To install the software from the Cisco website, follow the procedure listed below:

Step 1 Verify that the requirements listed in "Prerequisites" section have been met.

Step 2 Become the root user by entering the following command:

>su - root

Step 3 Create the temporary directory /var/tmp/CSCOvsp16-install by entering the following command:

#mkdir -p /var/tmp/CSCOvsp16-install

Step 4 Open a web browser, and go to the following site:> Software Center > Network Management > Cisco Voice Services 
Provisioning Tool

Step 5 Select the desired release number.

Step 6 Download the software to the temporary directory /var/tmp/CSCOvsp16-install.

Step 7 Extract the software image using the following tar command:

#tar xvf <filename>.tar

Step 8 Run the setup program by entering the following command:


Note You can avoid the GUI and install the Cisco VSPT in TTY mode by entering the following command:
#./setup -nodisplay, and following the onscreen prompts. An X-server must be running, and the DISPLAY environment variable must be properly configured. Use one of the following commands, depending on which shell you are using, to set the x-display variable.

In "csh" or "tcsh": setenv DISPLAY <hostname>:0
In "sh" or "ksh": DISPLAY=<hostname>:0;export $DISPLAY

Step 9 Follow the onscreen prompts.

Step 10 Remove the /var/tmp/CSCOvsp16-install directory when the installation is complete by entering the following command:

#rm -rf /var/tmp/CSCOvsp16-install

Step 11 Change to the installation directory, /opt/CSCOvsp16.

Step 12 Run the VSPT Release 1.6 program by entering the following command:


Installation of the VSPT software is now complete. Table 1-1 lists the default VSPT directories and files. If you have questions or need assistance, see the "Obtaining Technical Assistance" section on page -xiv

Table 1-1 Installation Directories and Files


/opt/CSCOvsp216 (home directory)



VSPT application script


Class and properties files




Java Runtime Environment


Uninstall script directory


VSPT version


/var/opt/CSCOvsp16 (home directory)


Configuration files


Log files



VSPT Basics

This section describes VSPT fields and data entry requirements..

VSPT Field Definitions

Table 1-2 lists VSPT field names and their corresponding system components. For more information about system components, refer to the Cisco Media Gateway Controller Software Release 7 Provisioning Guide.

Table 1-2 Field Definitions 

Field Name
Component Description

MGC Host

Origination point code (OPC), the address of the Cisco MGC you are provisioning.

Interfaces (cards)

Ethernet hardware cards and virtual interfaces (connections) for the Ethernet cards in the Cisco MGC host.

Adjacent Point Codes

The address of an STP1 that sends signaling messages to and receives signaling messages from the Cisco MGC.


Links from the MGC to an endpoint, such as an adjacent STP.

C7 IP Link

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

Mated Pairs (SS7 Subsystem)

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

Point Code

Destination point code (DPC), the address of an endpoint, such as a PSTN3 switch that carries the bearer traffic.

SS7 Path (SS7 Signaling Service)

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

SS7 Route

A route for each signaling path from the Cisco MGC to the PSTN switch through the linksets you have created to the STPs.

External Node

Any object in the network that is connected to the Cisco MGC, for example, a media gateway (Cisco MGW) and associated BSCs4 .

Note Cisco SLTs perform MTP layer 2 processing only. Therefore, they are not considered to be external nodes.

MGCP5 Signaling Service

A signaling service between the Cisco MGC and a media gateway.

IPFAS Signaling Service

A signaling service (over IP) between the Cisco MGC and a media gateway.

IP Links for MGCP and IPFAS

Links for the MGCP and IPFAS signaling services.

1 STP = signal transfer point.

2 SSP = service switching point.

3 PSTN = Public Switched Telephone Network.

4 BSC = Broadband service card.

5 MGCP = Media Gateway Control Protocol.

5 Figure 1-1 shows the relationship among the components listed in Table 1-2.

Figure 1-1 Component Relationships

VSPT Data Entry Requirements

When entering data into the VSPT windows, follow standard MML conventions for names and descriptions. MML names 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

Must be lowercase

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 that 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 Release 7 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 Release 7 Provisioning Guide.

Starting the VSPT

Perform the following steps to start the VSPT:

Step 1 Log in to the VSPT server or access it from a machine with X-windows capability.

Step 2 In a terminal window, enter:

>cd /opt/CSCOvsp16

The default directory is /opt/CSCOvsp16. Navigate to the appropriate directory if you installed the VSPT in a different location.

Step 3 Enter the following command to start the VSPT application:


The system opens the X-windows , and the login screen appears.

Step 4 Enter your user name and password, and click OK.

The default beta user name is admin, and the default password is also admin. The Welcome screen is displayed briefly during the login process, and then the main window appears (see Figure 1-2).

Figure 1-2 Main Window

Using the VSPT

This section describes the VSPT menus and buttons and provides directions for using the tool functions.

Menu Bar

The VSPT provides a menu bar that contains the following selections:





The File menu contains the choices listed in Table 1-3.

Table 1-3 File Menu Choices 



Begin a new configuration session.


Open an existing configuration.


Import an existing configuration from a MGC, as well as import trunk group, trunk, routing, and dial plan files into the VSPT.


Export files from the VSPT.


Save the current configuration:

As Working

As Snapshot

As New Config

Note For more information on the different save options, see the "Starting a New Provisioning Session" section.



Stop any open provisioning sessions and close the VSPT.

The View menu contains the choices listed in Table 1-4.

Table 1-4 View Menu Choices



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.

The Tools menu contains the choices listed in Table 1-5.

Table 1-5 Tools Menu Choices


Integrity Check

Check your configuration for inconsistencies and missing information.


Move the configuration to one or more target hosts and Cisco MGWs.


Open a Telnet session.

MGC Viewer

View MGC configurations.

MGX-8850 Wizard

View and configure MGX 8850 hosts.

BAMS Config

View and configure a Billing and Measurement Server (BAMS)

State Operation

View and configure the state of MGC components.

Screening Editor

View and configure screening number provisioning.

Backup and Restore

Schedule and perform a backup or restore of an existing configuration.

Make Seed File

Use an existing configuration to create a text file that can be used by the Cisco Media Node Manager (CMNM).


The VSPT provides buttons and explorer trees to move through the system. Click these buttons to add or change network components. The VSPT contains the following buttons:

MGC Config—Add components and provision component properties.

Traffic—Create customer-specific files, including trunk groups, trunks, and routing.

Number Analysis—Provision a dial plan.

The left side of the screen displays selectable components. The right side of the screen displays data entry fields. Click a component to select it. To see all subcomponents, click the icon next to the component name to expand the component list.

The Help menu selection displays the information about the current build release number.

Defining Users and Permissions

After you install the VSPT, you should define users and their respective permissions.

Use the following procedure to define users:

Step 1 Click Tools > User Admin.

The screen in Figure 1-3 appears.

Figure 1-3 VSPT User Administration

Step 2 Add, modify, or delete users as follows:

To add a user, enter a user name and password, click Permission, select the permission level, and click Add.

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

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

Exiting the VSPT

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

Click File > Exit. Click OK at the prompt.

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