Cisco Voice Services Provisioning Tool

Release Notes for the Voice Services Provisioning Tool Release 2.3


Table Of Contents

Release Notes for the Voice Services Provisioning Tool Release 2.3



Related Documentation

Software Release History

Release 2.3(2)

Previous Releases

System Requirements

Supported Network Elements

Patch Procedure


Obtaining Documentation

World Wide Web

Documentation CD-ROM

Ordering Documentation

Documentation Feedback

Obtaining Technical Assistance

Technical Assistance Center

Release Notes for the Voice Services Provisioning Tool Release 2.3

February 8, 2007



Software Release History

System Requirements

Supported Network Elements


Obtaining Documentation

Obtaining Documentation

Obtaining Technical Assistance


This document contains release information on the Cisco Voice Services Provisioning Tool (VSPT) Release 2.3 software through Release 2.3(2) patch 1. For more information on the Cisco VSPT software, please visit Cisco's website at: > Software Center > Voice Software > Voice Services Provisioning Tool or

VSPT helps you create configuration files across multiple devices including the Cisco PGW 2200, Cisco Media Gateway for SS7 PRI Gateway, and the Tandem Offload Solutions.

The Cisco VSPT can help avoid common errors that might arise if devices are provisioned independently. This package eliminates the need to enter duplicate data and enables you to import configurations to and export configurations from the PGW 2200. It also generates the configuration files you need to provision the PGW 2200—including the following provisioning information:


Trunk groups



Dial plans

Related Documentation

The Cisco Voice Services Provisioning Tool User's Guide Version 2.3(2) contains information on installing and getting started with VSPT and is available at

For details of using VSPT for provisioning, refer to the Cisco Media Gateway Controller Software Provisioning Guide Version 9, Chapter 3, "Provisioning with the Voice Services Provisioning Tool", at

For details of using VSPT for provisioning dial plans, refer to the Cisco Media Gateway Controller Dial Plan Guide Version 9, Chapter 3, "Provisioning Dial Plans with VSPT", at

Software Release History

This section contains information only for the current and previous 2.3(x) releases. For information on earlier releases, please refer to a previous version's release notes.

Release 2.3(2)

Release 2.3(2) supports Cisco MGC Release 9.3(2) software.

Cisco VSPT 2.3(2) adds support for provisioning the features new in Cisco MGC Release 9.3(2), as shown in Table 1. Enhancement identification numbers are listed where applicable.

Table 1 New Features for Software Release 2.3(2) 

Enhancement Identifier


Dual CLI interworking with Voice over IP network, both signaling path and call control


Calling party category (CPC), transmission medium requirements (TMR), transit network selection (TNS), codec call type, and percentage-based routing (PBR)


Enhanced H.323 services


Range checking of properties


Support for BAMS NICS output


Support for BAMS 1110 output


Support for VISM Voice over ATM operating mode


Configurable ISUP timers


Polish ISUP Version 2


Improved SIP failover support

Release 2.3(2) Patch 1 Information

The following caveats were resolved in Release 2.3(2) Patch 1. Patch installation instructions are described in Patch Procedure.

Table 2 Resolved in Release 2.3(2) Patch 1

DDTS Number


VSPT does not refresh codecstring table on a new import.


VSPT does not refresh codecstring table on a new import.


Trunks are not displayed when imported from the Cisco PGW 2200.


When importing a configuration, VSPT does not update trunk information.


Drop-down menu for result type COND_ROUTE does not work.


The siprttrnkgrp window does not close, and thus does not update the configuration.


VISM card provisioning: Incorrect endpoints generated adding trunks to VISM Media Gateway.

Release 2.3(2) (Base Release) Information

The following caveats were resolved in this release.

Table 3 Resolved Caveats for Software Release 2.3(2) 




Patch: Update patching script to process README_NOTES.txt.



Can't modify weighted trunkgroup off/on for rttrnk.



Java null pointer exception while changing DS1(T1/E1) p.



VSPT ignoring prov-add commands for condrtedesc while i.



CondRte drop down list values for condrtedesc not shown.



Java exception while viewing percrte component prov-add.



Java exception when trying to delete percrte component.



Unable to add CPC component.



TMR and TNS be added as screening criteria for Blacklis.



README_NOTES doesnt contain VISM specific information.



Adding RTTRNKGRP with bearcap property throws Java exce.



Java Null pointer exception when adding trunk group.



DW1 for Perc_route result type showing wrong values in.



VISM config deploy screen, Continue w/ Commands check b.



User's Guide clarifies PGW and media gateway options in importing and deploying configurations.



ST. VSPT default values are not correct.



VSPT provisions Bell_1268 Span_ids as 0, should be ffff.



Can't configure second half of a Classic-split AS5850 - .

Previous Releases

Release 2.3(1)

Release 2.3(1) supports Cisco MGC Release 9.3(1) software. The following caveats were resolved:

Table 4 Resolved in Release 2.3(1) 

DDTS Number


Install: Install netscape browser with VSPT.


State operation should add/display sessionset/c7iplnk for SLT.


NF: VSPT support for Currituck.


NF: Rename Protocol Files.


NF: AOC Support for India ISUP.


NF: INAP-Based Pre-Paid Card Service.


NF: VSPT support for HSI.


Drop down list for rtedesc attribute of condrte mml component.


VSPT using incorrect mgcp endpoint format for as5400.


NF: VSPT support for Circuit Reservation.


NF: VSPT support of Route Advance and Redirection for Circuit Reservation.


NF: Support BU/Restore of 6509.


Unable to add multiple instances of same trunkgroup in a route.


BT: Calls to emergency numbers should have CPC 00001011.


Install: VSPT cannot determine correct netscape directory.


Max number of route list is 6 instead of 5 for conditional route.


MGCbackup does not list all scheduled backups setup by different users.


Routes in rtlist needs distrib on each of them.


MGC doest support MGCP message appears on dart launched xterm window.


Importing trunk/trunkgroup .dat messgaes appear on xterm window.


Backup and Restore window does not show complete field names.


Backup and restore does not work with log file does not exist message.


Restore does not work for Cat6509 switch flash.


For Image type of config/running-config for CAT6509 switch and msfc blades, select /view images from flash should not activated.


Backup and Restore for HSI not working.


ST. VSPT retrieves T1 by default, from 5300 configured as E1.


ST. VSPT-BAMS always sends prov-ed:NODEPARMS:with everything.


ST. VSPT-BAMS has wrong menu under MSC-PARMS/AgeAlarm.


ST. VSPT-BAMS does not import MSC-PARMS from the system node.


ST. VSPT-BAMS msgdisclvl and msgfwdlvl allow failure.


ST. VSPT BAMS POLL tag contains wrong titles.


ST. VSPT BAMS The importing menu should be improved.


ST. VSPT-BAMS when importing trunkgrps, the import button fails.


GTD NOA override support.


GTD NOA Override.


Change MGC Product Name References.


Need to support alphanumeric for NEXTHOP and PEERADDR.


Misspelled word on BAMS3 provisioning screen.


Result type A_NUM_DP_TABLE is not open to Btree Analysis.


Sigpath name display needed instead of hex for BAMS config.


BAMS provisioning does not allow 2 TGs per sigpath.


Install:Rename Release_Notes.txt to README_NOTES.txt.


Install:Add full version of netscape with VSPT.


Install:Use CEMF version of netscape if available.


Online help is not displayed when using CEMF 3.2 netscape.


Range parameter not used when configuring BAMS sigpaths.


Install: add MINMGCVER to the VSPT Sun Package.


CONDRTE component mml commnads not shown in the inc. deploy window1.


VSPT delete digmodstring even if referenced by result CC_DIG, AMODDI1a.


ST. VSPT deploys or changes EndPoints for 5400/5350 to E1.

The following new features were added:

Table 5 New Features for Software Release 2.3(1) 



NF:Time Conditional Routing.


NF:Country Code Prefix Per Trunk Group Capability.


NF:Support for IRI/ORI in Q.767.


NF:TYPE parameter added for MGC sessionset component.

System Requirements

The following is the minimum hardware and software you need to run the Cisco VSPT software:

Sun Ultra 5 workstation, 440 MHz or faster

Sun Solaris 8 operating system

April 2001 release recommended

Open Windows with the Common Desktop Environment (CDE)

8-bit video graphics card

128 MB of System RAM

128 MB of free disk space (in installation directory)

128 MB of free swap space

Approximately 4 MB of disk space in the /var partition required for each configuration session

Supported Network Elements

The following network elements have been tested and verified to work with this release of the Cisco VSPT.

Note Other network element software versions have not been tested and are not supported with this version.

Cisco PGW 2200 Release 9.3(2) including provisioning the following components:


Trunk groups



Dial plans

Devices managed by the Cisco PGW 2200:

Cisco Media Gateway (MGX) 8850

Voice Interworking Service Module (VISM) Release 2.1, 2.2, 3.0, and 3.1

For the Cisco Media Gateway, VSPT supports these provisioning tasks:

Chassis provisioning tasks

VISM provisioning tasks:

Initial VISM Configuration

Configuring the Operating Mode

Placing the VISM Card In Service

Configuring T1 and E1 Lines

Configuring the Clocking Source

Configuring the PXM1 Clocking Source

Configuring DS0 Channels

Configuring Bearer Processing

Configuring Codecs

Configuring ECAN

Configuring Jitter

Configuring Domain Names and IP Addresses

Setting Up Call Agents and Protocols

Configuring Gateway Control Protocols

Backhaul setup

Patch Procedure

The Cisco MNM-PT patch process is cumulative. Downloading and installing the latest patch installs all previous patches. In order for you to install a patch, the base Cisco MNM-PT 2.3(2) software must be installed. Use the following steps to install the desired patch.

Step 1 Verify that the base Cisco MNM-PT 2.3(2) software is installed.

Step 2 Become the root user.

Step 3 Create a temporary installation directory.

Step 4 Download the patched software:

a. Go to

b. Log in.

c. Navigate to Technical Support > Software Center > Products and Downloads > Network Management Software. On this page find and click on Cisco Voice Services Provisioning Tool. You go to the patch download page.

d. Download the desired patch to the temporary installation directory.

Step 5 Untar the dart_2_3_2-080403-932-patch-01.tar file to a temporary directory.

Step 6 Execute the "patchCSCOvspt" script to install the VSPT 2.3(2) patch package.

Step 7 Follow the on-screen prompts.


The X-Windows DISPLAY environment variable must be set in order for you to install the Cisco VSPT:

During installation, the X-Windows DISPLAY environment variable must be set properly. If this variable is not set properly, the installation program exits with a Java error message or simply appears to stop responding. Use the following examples to set your X-Windows DISPLAY environment variable. Replace the value <hostname> with your machine's hostname:

In csh or tcsh:

setenv DISPLAY <hostname>:0

In sh or ksh:

DISPLAY=<hostname>:0 ; export $DISPLAY

If you experience problems or errors deploying to or communicating with a remote machine, check the following points:

Ensure that the machine is alive and responding to the ping command.

Ensure that correct login/passwords have been specified.

If you experience errors when deploying to the PGW 2200, check the following:

The PGW 2200 supports only one provisioning session at a time. When deploying to the PGW 2200, ensure that no other provisioning sessions are active.

When activating a configuration on the PGW 2200, the PGW 2200 might require that some signaling components are taken out of service before the configuration is activated. If you do not take the component out of service, you receive an MML error message. You can take the component out of service from MML manually, and after that you can activate the configuration.

Enter the following command to determine where Cisco VSPT is installed:

/usr/bin/pkgparam _DART_PKG_NAME_ BASEDIR

CSCOvsp stores configuration files in the /var/<install directory>/data directory. Each _DART_PKG_NAME_ configuration is stored in a separate directory; the directory nameis the same as the configuration name.

In the examples below, the assumption is that CSCOvsp16 was installed in the directory /opt/CSCOvsp16, thus = /opt/CSCOvsp16

To rename a configuration, simply rename the directory under /var/opt/_DART_PKG_NAME_/data

To remove a configuration, remove the directory under /var/opt/_DART_PKG_NAME_/data

To determine where the data directory is located, search for DartStoreDir in the file:

/usr/bin/grep DartStoreDir /opt/_DART_PKG_NAME_/classes/com/cisco/transpath/dart/editor/

As a safety precaution, the deinstallation procedure does not remove configuration data. The data must be removed manually.

Obtaining Documentation

The following sections explain how to obtain documentation from Cisco Systems.

World Wide Web

You can access the most current Cisco documentation on the World Wide Web at the following URL:

Translated documentation is available at the following URL:

Documentation CD-ROM

Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which is shipped with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual subscription.

Ordering Documentation

Cisco documentation is available in the following ways:

Registered Cisco Direct Customers can order Cisco product documentation from the Networking Products MarketPlace:

Registered users can order the Documentation CD-ROM through the online Subscription Store:

Nonregistered users can order documentation through a local account representative by calling Cisco corporate headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).

Documentation Feedback

If you are reading Cisco product documentation on, you can submit technical comments electronically. Click Leave Feedback at the bottom of the Cisco Documentation home page. After you complete the form, print it out and fax it to Cisco at 408 527-0730.

You can e-mail your comments to

To submit your comments by mail, use the response card behind the front cover of your document, or write to the following address:

Cisco Systems
Attn: Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883

We appreciate your comments.

Obtaining Technical Assistance

Cisco provides as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools by using the Cisco Technical Assistance Center (TAC) Web Site. registered users have complete access to the technical support resources on the Cisco TAC Web Site. is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information, networking solutions, services, programs, and resources at any time, from anywhere in the world. is a highly integrated Internet application and a powerful, easy-to-use tool that provides a broad range of features and services to help you to

Streamline business processes and improve productivity

Resolve technical issues with online support

Download and test software packages

Order Cisco learning materials and merchandise

Register for online skill assessment, training, and certification programs

You can self-register on to obtain customized information and service. To access, go to the following URL:

Technical Assistance Center

The Cisco TAC is available to all customers who need technical assistance with a Cisco product, technology, or solution. Two types of support are available through the Cisco TAC: the Cisco TAC Web Site and the Cisco TAC Escalation Center.

Inquiries to Cisco TAC are categorized according to the urgency of the issue:

Priority level 4 (P4)—You need information or assistance concerning Cisco product capabilities, product installation, or basic product configuration.

Priority level 3 (P3)—Your network performance is degraded. Network functionality is noticeably impaired, but most business operations continue.

Priority level 2 (P2)—Your production network is severely degraded, affecting significant aspects of business operations. No workaround is available.

Priority level 1 (P1)—Your production network is down, and a critical impact to business operations will occur if service is not restored quickly. No workaround is available.

Which Cisco TAC resource you choose is based on the priority of the problem and the conditions of service contracts, when applicable.

Cisco TAC Web Site

The Cisco TAC Web Site allows you to resolve P3 and P4 issues yourself, saving both cost and time. The site provides around-the-clock access to online tools, knowledge bases, and software. To access the Cisco TAC Web Site, go to the following URL:

All customers, partners, and resellers who have a valid Cisco services contract have complete access to the technical support resources on the Cisco TAC Web Site. The Cisco TAC Web Site requires a login ID and password. If you have a valid service contract but do not have a login ID or password, go to the following URL to register:

If you cannot resolve your technical issues by using the Cisco TAC Web Site, and you are a registered user, you can open a case online by using the TAC Case Open tool at the following URL:

If you have Internet access, it is recommended that you open P3 and P4 cases through the Cisco TAC Web Site.

Cisco TAC Escalation Center

The Cisco TAC Escalation Center addresses issues that are classified as priority level 1 or priority level 2; these classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer will automatically open a case.

To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to the following URL:

Before calling, please check with your network operations center to determine the level of Cisco support services to which your company is entitled; for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). In addition, please have available your service agreement number and your product serial number.