Release Notes for the Cisco Voice Services Provisioning Tool, Release 2.8(1)

Table Of Contents

Release Notes for the Cisco Voice Services Provisioning Tool, Release 2.8(1)

Contents

Introduction

System Requirements

New Features

Cisco PGW 2200 Softswitch Release 9.8(1) Support

Cisco HSI Release 4.3(2) Support

Cisco BAMS Release 3.30 Support

Software Changes

Release 2.8(1)

Release 2.8(1) Patch 1

Supported Configurations

Supported Network Elements

Resolved Problems

Release 2.8(1)

Release 2.8(1) Patch 1

Installation Notes

Acquiring the Software

Installing and Uninstalling Cisco VSPT 2.8(1)

Software Patches

Troubleshooting

Setting X-Windows DISPLAY Environment Variable

Deploying and Communicating with a Remote Machine

Deploying Configurations to Cisco PGW 2200 Softswitch

Verifying VSPT Directories

Directory Where VSPT Is Installed

Directory Where VSPT Configuration Is Stored

Setting VNC Parameters to Address Font Problems

Setting T1 or E1 As Default DS1 Type

SFTP or SSH Client Not Working in VSPT

SFTP or SSH Server Not Working on Cisco PGW 2200 Softswitch or Cisco BAMS

TFTP Not Working on the Cisco PGW 2200 Softswitch or Cisco BAMS

Product Documentation

Related Documentation

Obtaining Documentation and Submitting a Service Request

Release Notes for the Cisco Voice Services Provisioning Tool, Release 2.8(1)

---

January 2009

The Cisco Voice Services Provisioning Tool (VSPT) Release 2.8(1) provides support on new features and performance improvements introduced on Cisco PGW 2200 Softswitch Release 9.8(1).

This document contains release information for the Cisco VSPT Release 2.8(1) software. For more information on the Cisco VSPT software, please visit the Cisco website at

http://www.cisco.com/en/US/products/sw/netmgtsw/ps2272/tsd_products_support_series_home.html

or

http://www.cisco.com/cgi-bin/tablebuild.pl/vspt

Contents

•Introduction

•System Requirements

•New Features

•Software Changes

•Supported Configurations

•Supported Network Elements

•Resolved Problems

•Resolved Problems

•Installation Notes

•Troubleshooting

•Product Documentation

•Related Documentation

•Obtaining Documentation and Submitting a Service Request

Introduction

Cisco VSPT helps you create configuration files across multiple devices including the Cisco PGW 2200 Softswitch and the Cisco Billing and Measurement Server (BAMS). Cisco VSPT provides a GUI for batch and interactive provisioning of the Cisco PGW 2200 Softswitch and the Cisco BAMS.

Each release of Cisco VSPT supports a specific release of the Cisco PGW 2200 Softswitch.

Cisco VSPT 2.8(1) is no longer available as a free download at Cisco.com. In order to use Cisco VSPT 2.8(1), you must purchase the Cisco MGC Node Manager 2.8(1) Media Kit which includes both Cisco VSPT 2.8(1) and Cisco MGC Node Manager (CMNM) 2.8(1).

Cisco VSPT can help you avoid common errors that might arise if devices are provisioned independently. Cisco VSPT also reduces the need to enter duplicate data and enables you to deploy configurations to and export configurations from the Cisco PGW 2200 Softswitch.

Cisco VSPT generates the configuration files you need to provision the Cisco PGW 2200 Softswitch and the Cisco BAMS. The files contain parameter for:

•Signaling

•Trunk groups

•Trunks

•Routes

•External nodes

•System

•Dial plans

System Requirements

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

•Sun UltraSPARC server, 440 MHz or faster

•Sun Solaris 10 operating system (Sparc/Opteron)

–Open Windows with the Common Desktop Environment (CDE)

•8-bit video graphics card

•1 GB of System RAM

•128 MB of free disk space (in installation directory)

•1 GB of free swap space

You need approximately 6 GB of disk space in the /var partition for each configuration session.

New Features

Cisco VSPT Release 2.8(1) added support for Cisco PGW 2200 Softswitch Release 9.8(1), Cisco H.323 Signaling Interface (HSI) Release 4.3(2), and Cisco Billing and Measurements Server (BAMS) Release 3.30.

Cisco PGW 2200 Softswitch Release 9.8(1) Support

For more information on features of Cisco PGW 2200 Softswitch Release 9.8(1), see the Release Notes for the Cisco PGW 2200 Softswitch Release 9.8(1) at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/release/note/rn981.html

Cisco HSI Release 4.3(2) Support

For more information on features of Cisco HSI 4.3(2), see the Release Notes for Cisco H.323 Signaling Interface Release 4.3 and Related Patches at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/hsi/4.3/release/note/43p6rn.html

Cisco BAMS Release 3.30 Support

For more information on features of Cisco BAMS 3.30, see the Release Notes for Cisco Billing and Measurements Server Software Release 3.30 and Related Patches at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/bams/3.30/release/note/330rn.html

Software Changes

This section describes added or modified MML components, SIP/sigpath and trunk group properties, and result types and other changes on the Cisco VSPT Release 2.8(1) and Release 2.8(1) patches.

For more information on the Cisco PGW 2200 Softswitch provisioning, see the Cisco Media Gateway Controller Software Release 9 Provisioning Guide at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/provisioning/guide/prvgde.html

Release 2.8(1)

Cisco VSPT Release 2.8(1) supports Cisco PGW 2200 Softswitch Release 9.8(1) up to Release 9.8(1) S1P1.

New MML components

•SourceBlack

•DomainString

•DRPTable

•RouteSelect

•DESTRANS

•outsipheader

•insipheader

•Domainprofile

•SIPIVersion

•gwpool

•ipgw

Modified MML Components

•Added a new parameter, Domain Based RT support, to the siprttrnkgrp component.

•Added new parameters, type, base, category, validation, and variant in profile.

•Added new profile types, sipprofile, eisupprofile, domainprofile, grprofile, commonprofile, and gwpoolprofile.

•Added a new parameter, label, to the h248path component.

New Profile Properties

---

Note Old SIP and EISUP trunk group properties were moved to profile properties and deleted in trunk group properties.

---

•trustLevel

•topologyHidingEnabled

•useDomainProfile

•outboundDomainProfileSource

•commonProfile

•grprofile

•insipheadertable

•outsipheadertable

•LRNDigitCCPrefix

•LRNDigitCCrm

•SipIEgressHandling

•SipIConfusionHandling

•SipIFacilityRejectHandling

•SipICLICOLPreference

•SipICANCELEncapREL

•SipInsertReasonHeader

•SipIIngressVersionMAP

•SipIEgressMDO

•SipIEgressISUPVersion

•SipEgressGN2FromScreenInd

•SipEgressEarlyDialogRelType

•SipIngressLNPHandling

•SipIToiw2

•GatewayToneSupport

•GatewayAnnSupport

•GatewayCodecSupport

•GatewayDTMFSupport

•GatewaySelectionMethod

•GatewayPool

•AnchorMedia

•AnchorPolicy

•AnnouncementOption

•ToneOption

•DummyCodecString

•NATTraversalEnabled

•RestrictPresIfNoPAID

New SIP Properties

•sipTransportMode

•DelayedOfferToEarlyOfferInterworking

Updated SIP Properties

•sipMimeBodySupport

•Support183

New Misc Properties

•PropagateDelayCounter

Updated Analysis Routing Properties

•InhibitSipFromMapping

Updated Number Properties

•BDigitCCPrefix

•BDigitCCrm

•ADigitCCPrefix

•ADigitCCrm

•CCOrigin

Other New Properties

•NATTraversalMethod

•IPTermNumGroups

•IPTermNumInterfaces

•IPTerNumTerms

New Result Types

•DRP_EXIT

•IP_ROUTE_SEL

•IP_SET_SOURCE_DMN

•IP_DEST_TRANS

•IP_SOURCE_SCREEN

•SIPI_CONTROL

•GATEWAYPOOL

Modified Result Types

•The new data word, Pre-analysis as the next stage, was added into the result type RETRY_ACTION.

•The value 3 was added to the dataword 2, Analysis type, in the result type NEW_DIALPLAN.

•The value 6 was added to the dataword 1, Type, and the values 5 and 6 were added to the dataword 2, Treatment, in the result type FACILITY.

Release 2.8(1) Patch 1

Cisco VSPT Release 2.8(1) Patch 1 supports Cisco PGW 2200 Softswitch Release 9.8(1) up to Release 9.8(1) S2P2.

New Profile Properties

•InsideVrfName

•OutsideVrfName

Removed Profile Properties

•VrfName

Supported Configurations

The following configurations are supported:

•Cisco MGC Node Manager and Cisco VSPT installed together on a network management server (recommended)

•Cisco MGC Node Manager installed on a network management server and Cisco VSPT installed on a Cisco PGW 2200 Softswitch host machine

•Cisco MGC Node Manager installed on a network management server and Cisco VSPT installed on a separate server

•Cisco VSPT installed on a Cisco PGW 2200 Softswitch host machine or a standalone Sun Server

---

Note Cisco VSPT is tested co-resident with Cisco MNM and LMS only.

---

Supported Network Elements

The following network elements have been tested and verified to work with this release of the Cisco VSPT. Cisco VSPT supports provisioning for Cisco PGW 2200 Softswitch and Cisco BAMS only. Cisco VSPT provides backup and restore functions for all the network elements which are supported by Cisco MNM.

---

Note Other network element software versions are not supported with this version.

---

•Cisco PGW 2200 Softswitch Release 9.8(1) with provisioning for the following components:

–Signaling

–Trunk groups

–Trunks

–Routes

–External nodes

–System

–Dial plans

•Cisco HSI 4.3(2)

•Cisco BAMS 3.30

•Cisco ITP-L

–2611 (12.4(21))

–2651 (12.4(21))

–2811 (12.4(21))

•Cisco Integrated ITP-L (5400 & 5350) 12.4(19)a

•Cisco LAN switches

–Cisco Catalyst 5500 (latest)

–Cisco Catalyst 2900XL (latest)

–Cisco Catalyst 6509

Resolved Problems

Release 2.8(1)

Table 1 describes problems resolved in Cisco VSPT Release 2.8(1).

Table 1 Resolved Problems in Cisco VSPT Release 2.8(1) 

Identifier	Severity	Description
CSCsq71077	3	VSPT 2.7.3 P3 fails to import the trunk group information from PGW.
CSCsr13068	3	Array index out of bound exception when adding properties in profiles.
CSCsr13074	3	Property name is not refreshed in profiles.
CSCsr88688	3	The key of domainprof is wrong.
CSCsr88827	4	In non-debug mode, there is still the prompt "using sftp...." in the terminal when running VSPT.
CSCsj03153	6	VSPT: Add support for PGW domain based analysis and routing.
CSCsm19500	6	Tables are not sortable in VSPT.
CSCsm82462	6	VSPT: Add support for SIP over TCP Phase 2.
CSCsm82490	6	VSPT: Add support for SIP-I.
CSCsm82496	6	VSPT: Add support for P IP gateway.
CSCsm82500	6	VSPT: Add support for SIP Profile.
CSCsm89540	6	Add a setting for SSH/non-SSH connection for PGW/BAMS.
CSCsm89556	6	Optimize the MML commands generated by VSPT.
CSCso12632	6	VSPT out of memory when loading config with large porttbl, Termtbl.
CSCsq98291	6	Add patch level information in the Help > About VSPT.
CSCsr42671	6	Add support for Finnish SIP-I support on PGW.
CSCsr64698	6	Add support for PGW features introduced from Release 9.7(3) S14P14 to S17P17.

Release 2.8(1) Patch 1

Table 2 describes problems resolved in Cisco VSPT Release 2.8(1) Patch 1.

Table 2 Resolved Problems in Cisco VSPT Release 2.8(1) Patch 1 

Identifier	Severity	Description
CSCsv79161	3	Trkgrp template should begin with format3 or xml for pgw to read.
CSCsw36268	3	Audit error: invalid password.
CSCsw44649	3	Copyright of the backgroup picture should be updated.
CSCsw76656	3	VSPT fails to complete a full system backup for HSI and PGW.
CSCsx08913	3	VSPT fails to perform MGC system restore because of permission deny.
CSCsx09347	3	VSPT fails to perform the HSI restore if using non-root backup ID.
CSCsw36290	4	Trunk group version should be changed to 981.
CSCsu61922	6	GUI remote shell tool window can't be closed properly.
CSCsv57570	6	VSPT supports to include egress TG vrf information in the originating side.

Installation Notes

This section contains information and procedures you can use to install, upgrade, and uninstall Cisco VSPT Release 2.8(1). It also contains information about software patches.

Acquiring the Software

Cisco VSPT Release 2.8(1) is provided to users on the VSPT CD included in the Cisco MGC Node Manger Media Kit. All the patches and releases prior to Release 2.8(1) are available at

http://www.cisco.com/cgi-bin/tablebuild.pl/vspt

Installing and Uninstalling Cisco VSPT 2.8(1)

For detailed information on installing and uninstalling Cisco VSPT Release 2.8(1), see Chapter 2, "Installing Cisco VSPT" in the Cisco Voice Services Provisioning Tool User's Guide, Release 2.8(1) at

http://www.cisco.com/en/US/docs/net_mgmt/vspt/2.8/user/guide/vspt_ug_wpr.html

Software Patches

You can only install Cisco VSPT 2.8(1) patches on Cisco VSPT version available on the Cisco VSPT 2.8(1) product CD that ships with the Cisco MGC Node Manager 2.8(1) Media Kit. Perform the following procedure to install patches:

---

Step 1 Save the configuration files using the following commands:

mkdir -p /tmp/CSCOvsp28

cp -r /var/opt/CSCOvsp28/data /tmp/CSCOvsp28 

Step 2 Check the version of Cisco VSPT 2.8(1) using the following command:

cat /opt/CSCOvsp28/version

Step 3 Download the patch file from the following website:

http://www.cisco.com/cgi-bin/tablebuild.pl/vspt

For example, if you are going to install Cisco VSPT 2.8(1) Patch 1, download CSCOvspt-281-P01.tar.

Step 4 Extract the patch file using the following command:

tar -xvf CSCOvspt-281-P01.tar

Step 5 Change to super user root using the following command:

su -root 

Step 6 Install the VSPT patch using the following command:

./patchCSCOvspt 

Step 7 Restore the configuration files using the following command:

cp -r /tmp/CSCOvsp28 /var/opt/CSCOvsp28/data

---

Troubleshooting

Setting X-Windows DISPLAY Environment Variable

You must set the X-Windows DISPLAY environment variable in order to install the Cisco VSPT. If this variable is not set properly, the installation program exits with a Java error message or simply stops responding. Use the following examples to set your X-Windows DISPLAY environment variable. Replace the value <hostname> with your machine hostname.

•In csh or tcsh,

setenv DISPLAY <hostname>:0

•In sh or ksh,

DISPLAY=<hostname>:0; export $DISPLAY

Deploying and Communicating with a Remote Machine

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

•Ensure that the machine is active and responding to the ping command.

•Ensure that you have specefied the correct login and password.

Deploying Configurations to Cisco PGW 2200 Softswitch

If you experience errors when deploying configurations to the Cisco PGW 2200 Softswitch, check the following points:

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

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

Verifying VSPT Directories

Directory Where VSPT Is Installed

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

/usr/bin/pkgparam _VSPT_PKG_NAME_ BASEDIR 

If you want to determine where Cisco VSPT Release 2.8(1) is installed, use the following command:

/usr/bin/pkgparam CSCOvsp28 BASEDIR 

Directory Where VSPT Configuration Is Stored

CSCOvsp28 stores configuration files in the /var/<install directory>/data directory. Each configuration is stored in a separate directory with the directory name the same as the configuration name.

In the example below, it is assumed that CSCOvsp28 was installed in the directory /opt/CSCOvsp28. The "install directory" in this example is /opt/CSCOvsp28.

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

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

To determine where the data directory is located, use the following command to search for DartStoreDir in the configEditor.properties file:

/usr/bin/grep DartStoreDir 
/opt/_VSPT_PKG_NAME_/classes/com/cisco/transpath/dart/editor/configEditor.properties 

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

Setting VNC Parameters to Address Font Problems

If you encounter any font problems in VSPT, use -fb /user/openwin/lib/X11/fonts/misc/ as the command arguments to start the VNC server.

Setting T1 or E1 As Default DS1 Type

You can set the default DS1 type in the configEditor.properties file, which is located at

/opt/_VSPT_PKG_NAME_/classes/com/cisco/transpath/dart/editor/.

•To set T1 as the default DS1 type, edit the property DEFAULT_DS1_TYPE:

DEFAULT_DS1_TYPE=T1

•To set E1 as the default DS1 type, edit the property DEFAULT_DS1_TYPE:

DEFAULT_DS1_TYPE=E1

SFTP or SSH Client Not Working in VSPT

If you get the error message, "The path, /user/bin/ssh, doesn't exist" or the message "FTP Error. The path, /user/bin/sftp, doesn't exist" when you are using SSH to deploy configurations in Cisco VSPT, check the SFTP and SSH clients.

Use the following procedures to troubleshoot this problem.

•Check the folder /user/bin/ to verify that SSH and SFTP clients are installed. If they are not installed, you need to reinstall SSH and SFTP included in Solaris 10 software.

•Check the sshPath variable in the configEditor.properties file. The sshPath should be configured with the folder path where SSH and SFTP are installed. The following example gives the location of the configEditor.properties file and the default path for SSH and SFTP clients.

/opt/CSCOvsp28/classes/com/cisco/transpath/dart/editor/configEditor.properties
sshPath=/usr/bin

SFTP or SSH Server Not Working on Cisco PGW 2200 Softswitch or Cisco BAMS

If you get the error message, "Error connecting to MGC:jump_ssh:failed login" or "Error connecting to BAMS:jump_ssh:failed login" when you are using SSH to deploy configurations in Cisco VSPT, check the SFTP and SSH on the Cisco PGW 2200 Softswitch or Cisco BAMS.

You can use the following MML command on both Cisco PGW 2200 Softswitch and Cisco BAMS to check if SFTP and SSH are installed on Cisco PGW 2200 Softswitch and Cisco BAMS.

ps -ef | grep ssh

Information displays that resembles the following:

root 240 1 Feb 22 ? 0:01 /usr/lib/ssh/sshd

mgcusr 8640 8637 0 03:17:19 ? 0:01 /usr/lib/ssh/sshd

If sshd is displayed, SFTP and SSH are already installed on the Cisco PGW 2200 Softswitch or Cisco BAMS. If sshd is missing, SFTP and SSH are not correctly installed on the Cisco PGW 2200 Softswitch or Cisco BAMS.

•SFTP and SSH installed on the Cisco PGW 2200 Softswitch and Cisco BAMS.
You need to verify that the path displayed for each command is the same path configured for the sshPath variable in the configEditor.properties file in the following VSPT folder:
/opt/CSCOvsp28/classes/com/cisco/transpath/dart/editor/configEditor.properties

The default path for SSH and SFTP for the Cisco PGW 2200 Softswitch and Cisco BAMS is /usr/bin/ on Solaris 10.

•SFTP or SSH not installed on the Cisco PGW 2200 Softswitch or Cisco BAMS.
You need to reinstall SSH and SFTP, which are included in Solaris 10 software, on the Cisco PGW 2200 Softswitch and Cisco BAMS.

TFTP Not Working on the Cisco PGW 2200 Softswitch or Cisco BAMS

If you get the timeout error message in Status tab when you are performing the backup and restore in VSPT, check the TFTP on the Cisco PGW 2200 Softswitch or Cisco BAMS.

Use the following MML command to check TFTP on the Cisco PGW 2200 Softswitch or Cisco BAMS.

grep /etc/inetd.conf tftp

If in.tftpd is missing, TFTP is not installed on the Cisco PGW 2200 Softswitch or Cisco BAMS. You need to download the following two packages to install the TFTP on the Cisco PGW 2200 Softswitch or Cisco BAMS:

•SUNWtftp

•SUNWtftpr

To enable the TFTP on the Cisco PGW 2200 Softswitch or Cisco BAMS, see the section, "Enable TFTP on the Backup Host" in Chapter 2, "Installing Cisco VSPT," in Cisco Voice Services Provisioning Tool User Guide, Release 2.8(1) at

http://preview.cisco.com/en/US/docs/net_mgmt/vspt/2.8/user/guide/vspt_ug_wpr.html

Product Documentation

The documents that contain information related to the Cisco VSPT Release 2.8(1) are at the following URL:

http://www.cisco.com/en/US/products/sw/netmgtsw/ps2272/tsd_products_support_series_home.html

Related Documentation

The documents that contain information related to the Cisco PGW 2200 Softswitch are at the following URL:

http://www.cisco.com/en/US/products/hw/vcallcon/ps2027/tsd_products_support_series_home.html

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

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

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.

CCDE, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0812R)