|
|
Table Of Contents
Release Notes for the Voice Services Provisioning Tool Release 2.1
Known Issues and Operational Recommendations
Using the Cisco AS5x00 as a Media Gateway
Determining a Set of Incremental Commands to be Deployed
Performing an Incremental Deployment
DialPlan Configuration Creation and Maintenance
Multiple Trunk Group Format Support
GUI Interface for Backup and Restore
Redirecting Number and Original Called Number
Adding and Removing A Numbers from Screening Database Without Opening a Provisioning Session
Provisioning and Operating Capability to return to Number Analysis from Cause Analysis.
Support for Redundant IP Connectivity Between the MGC and MGs With a Single IP Address
Additional Option for ITU CIC Selection Method for European Interconnect Compliance
Obtaining Technical Assistance
Release Notes for the Voice Services Provisioning Tool Release 2.1
August 30, 2006
Contents
•
Caveats
•
•
Introduction
This document contains pertinent information on installing, configuring, and using the Cisco Voice Services Provisioning Tool (VSPT) Release 2.1 software. For more information on the Cisco VSPT software, please visit Cisco's website at: http://www.cisco.com > Software Center > Voice Software > Voice Services Provisioning Tool or http://www.cisco.com/cgi-bin/tablebuild.pl/vspt.
This document outlines the latest information about the Cisco VSPT Release 2.1. VSPT Release 2.1 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:
•
•
•
•
•
Software Release History
This section contains information only for the current and previous releases. For information on earlier releases, please refer to a previous version's release notes.
Release 2.1
Version 2.1 supports the MGC Mistral release 9.1(5) software release. It allows you to:
•
•
•
This is helpful when deleting trunks that are in service. From the new state management functionality, you can take those trunks out of service from VSPT, and then issue provisioning commands to delete them.
The following SPRs were resolved:
Release 2.0
•
•
•
–
–
•
–
–
•
•
•
BAMS Phase II, Release 2.62 and above
Release 1.5(4) Level 01
The following SPR was resolved:
Table 2 Resolved Caveats for Software Release 1.5(4) Level 01
CSCdt36493
2
bams
VSPT 1.5 does not import SS7 sigpath from SC2200 into BAMS
The following issue was resolved:
Updated the configEditor.properties file to specify additional SS7 signaling path MDO dialects.
Release 1.5
•
Media Gateway: MGX 8260, Releases 1.1 and 1.2
•
Media Gateway Controller software: MGC software Release 7.4(10)B (minimal release for Release 7)
•
BAMS Phase II, Release 2.62 and above
Release 1.1.2
This release corrected the MGX 8260 commands required for MGCP connections.
Version 1.1
•
•
Media Gateway: MGX 8260, Release 1.1.1
•
Media Gateway: MGX 8850/VISM cards, Release 2.0.1
•
System Requirements
The following is the minimum hardware you need to run the Cisco VSPT software:
•
•
–
–
–
•
•
•
•
•
Supported Network Elements
The following network elements have been tested and verified to work with this release of the Cisco VSPT.
Note
•
–
–
•
Table 3 Supported VSPT Software Releases
1.5(1)
7.4(10)B
1.5(2)
7.4(10)B
1.5(3)
7.4(11)
:
•
Caveats
Contact your Cisco representative to obtain status on problem reports. Caveats are sorted by severity, then identifier, then component. Only severity 1, 2, and 3 caveats are listed.
There are no open caveats for VSPT 2.1.
Known Issues and Operational Recommendations
Using the Cisco AS5x00 as a Media Gateway
If you use Cisco AS5x00 as media gateways, you must update the DEFDS1TYPE flag to either E1 or T1 (in the configEditor.properties) based on the type of card used in the AS5x00 devices.
MGCP endpoint names for IOS devices do not indicate either T1 or E1 endpoints. When importing a configuration from the MGC, this property setting is used to inform VSPT of which type of cards are in use on the AS5x00 device.
<VSPT_INSTALL_DIR>/classes/com/cisco/transpath/dart/editor
Note
pkgparam _DART_PKG_NAME_ BASEDIRDetermining a Set of Incremental Commands to be Deployed
When determining a set of incremental commands to be deployed, VSPT makes a best-attempt at the incremental commands. However, some operations are not supported by the MGC. In those instance, it is recommended that you visually inspect the commands to be deployed and modify them accordingly. Also, you have the ability to cancel the deployment and redeploy as a New config.
Performing an Incremental Deployment
When performing an incremental deployment, the user can specify the based on config as [LAST UPDATE]. This computes a set of incremental commands against the last config that was imported.
This is a useful mechanism when you want to import from an MGC, make a series of modifications, and then redeploy the changes only. To accomplish this, use [LAST UPDATE] as the config to compare against.
Customizable Properties
VSPT has startup properties that can be modified to customize the behavior of the application. The property file is named configEditor.properties, and is located in the //classes/com/cisco/transpath/dart/editor directory.
The following items should be noted:
•
•
Deploy.Retry=3 Deploy.WaitPOM=45•
MGW_RES_CHECK=false•
•
mml> prov-dply MGC-01 - Media Gateway Controller 2001-04-10 18 ;40 ;43 M DENY SROF "PROV-DPLY: error transferring data files" /* Status, Requested Operation Failed on the component */ ;If this occurs, retry the operation from VSPT by activating the MGC Viewer located under the Tools menu option.
When the list of configurations is shown, select the name of the configuration that you created. Then select Configuration > Activate to retry activating the configuration. You can also perform a Configuration > Synchronize to request that the MGC synchronize its configuration with its standby MGC.
DialPlan Configuration Creation and Maintenance
To make the creation and maintenance of configurations easier, VSPT allows you to enter range input for A/B digtree tables.
The implementation of this feature in VSPT is structured to accommodate overdecadic numbering as well as ordinary numbering. If you wish to enter multiple ranges, you can use commas to separate entries.
Some examples of range input for A/B digtree tables follow:
To create digitstring entries from 300 to 399, you can enter:
3[0-9][0-9]
If you input:
1234ff,234[0-8],89[0-7]5[6-f]
VSPT generates digitstring entries for the numbers:
1234ff
2340, 2341, ..., 2348
89056, 89057, ..., 8905f, 89156, 89157 ... 8975f
Note
Screening File Creation
You can create screening files within VSPT. To create a screening file, do the following:
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
A new tree node is created under Screening node.
Step 7
On the right hand side of the window, the Edit File button is enabled.
Step 8
Dial Plan Changes
To ease the provisioning and incremental changes for screening numbers, a new Screening Editor tool is added to this version. You launch it from the menu bar Tool > Screening Editor. This tool allows you to:
•
Step 1
Step 2
The screening numbers are retrieved from the VSC.
Step 3
Step 4
Step 5
•
Multiuser Provisioning
The VSC allows only one provisioning session at a time. VSPT accomplishes multiuser provisioning by placing a provisioning attempt (initiated with the Tools > Deploy menu option) on hold if a provisioning session is already in progress.
After a 45 second timeout, VSPT retries the operation up to three times. Timeout and retry values are specified in the configEditor.properties file located in the directory:
/<install-dir>/classes/com/cisco/transpath/dart/editor.To change these settings, modify the following lines:
Deploy.Retry=3 Deploy.WaitPOM=45Disabling the Resource Check
When you add trunks to a configuration, VSPT checks to ensure that appropriate resources have been added to the media gateway (NAS, MGX-8260, VISM card, etc). If the resources do not exist, VSPT does not allow the trunks to be added.
You may want to disable this feature if you are making frequent changes to trunk information and do not want to take the time to first specify each change on the media gateway. You may also want to disable it if you are frequently importing configurations from the VSC. The VSC does not retain complete information about media gateway resources, and so a resource check will result in the operation failing.
To disable the resource check, modify the MGW_RES_CHECK flag in the configEditor.properties file located in the directory:
/<install-dir>/classes/com/cisco/transpath/dart/editoras follows:
MGW_RES_CHECK=falseTo resume resource checking, reset the flag to true.
Multiple Trunk Group Format Support
VSPT supports multiple trunk group formats. It can parse 57, 60, and 62 column trunk group files; the default for this feature is 62-columns.
As a feature of provisioning, VSPT produces a flat file that contains trunk group information. The format of the flat file has been modified to allow for support of different trunk group properties. Depending on the software release in use, you may need to indicate which format of the trunk group file should be generated.
To change the trunk group format, modify the tgTemplate property in the following directory:
<VSPT_INSTALL_DIR>/classes/com/cisco/transpath/dart/editor/configEditor.propertiesThe value specified in tgTemplate identifies the name of the template file that specifies the trunk group properties and their associations.
Table 5 tgTemplate Values
57 column format
901057
60 column format
902060
62 column format
903062
Note
GUI Interface for Backup and Restore
VSPT provides a graphic user interface (GUI) for the following devices:
•
•
•
•
•
•
You can create, modify, and delete backup and restore schedules on an hourly, daily, weekly, or monthly basis; all the schedules are pushed onto the crontab of the Solaris system. Additionally, you can trigger backup and restore operations on demand.
To launch the backup and restoreGUI:
At the VSPT main window, click on Tools > Backup and Restore.
•
Backup.unixID=•
•
•
To reduce errors when entering information in the <filename> text field, the add/modify schedule GUI has select/view files on TFTP and select/view images on flash buttons. You can use these buttons or type in a filename.
New Features and Enhancements
Redirecting Number and Original Called Number
VSPT support to provision redirecting number and original called number on the MGC. To provide this minimal support, an addition of a switch or flag added to the software allows the passing of the Original Called Number (OCN) or the Redirecting Number to the Redirecting Number field in the NI2+ protocol. The following outlines the logic for passing the appropriate field to the Redirecting Number in the NI2+ field:
If flag is true:
If flag is false:
Adding and Removing A Numbers from Screening Database Without Opening a Provisioning Session
This tool, launched by selecting the Screening Editor from the Tool menu, allows you to Add/Modify/Delete A/B/White/Black screening numbers through the GUI. You can save the created numbers to files and read them back in by clicking the menu items in the File menu. All or a subset of screening numbers can be deployed to VSC without occupying a provisioning session, for example, you do not need to do a Prov-sta::srcver or prov-stp. The VSC to which you are provisioning screening numbers is the one you specified in the VSPT main window. This tool also allows you to import screening numbers from the VSC.
Result Types Enhancements
This enhancement involves opening up result types which were allowed only under A or B analysis, to both A and B analysis areas.
Modification of digits and number A results for A and B number analysis should be a possible result type during analysis of the opposite number. Preanalysis also was enhanced. This allows the user to apply certain result types for A and B numbers, during analysis of the opposite number, depending on certain conditions.
Provisioning and Operating Capability to return to Number Analysis from Cause Analysis.
This enhancement enables allows you to modify the B-number from cause analysis, and then enter number analysis with the modified B-number.
Call Cut-off Timer
This enhancement starts a global timer, after answer for every call, and runs for a pre-configured time. When the timer expires for a call, the call is released in both directions. The timer can be set on a system wide basis, or can be set using a result type with a timer value, in number analysis. The timer can be configured for a minimum of 1 hour and maximum of 48 hours. This feature is common in TDM switches to remove fraud due to long calls, which exceed credit rating, for example, with prepaid services.
Support for Redundant IP Connectivity Between the MGC and MGs With a Single IP Address
To support IP routing enhancement, two parameters, next hop address and subnet mask address, were added to the C7IPLNKs, IPLNKs, IPSESSIONs, and SS7SGIPLNKs objects.
•
•
To support redundancy for MG with one IP address, such as the VISM, the ability to configure multiple routes to the same destination has been added. VSPT now supports this feature on the MGC.
Additional Option for ITU CIC Selection Method for European Interconnect Compliance
This feature is used in some European countries where ITU-T Method 2 is employed on the interconnect. Specifically this is required in Denmark for interconnect with Most Idle/Least Idle selection on two separate groups (even and odd CICs). VSPT now supports this feature on the MGC. This feature is not supported on the MGC in 9.1(5).
Multiple Dial Plans Support
This feature allows the MGC (in both VSC & SC2200 configurations) to support multiple dialplans. More specifically, this means supporting the ability to be able to move from one dial plan to another. VSPT does support import and export of the VSC supporting this feature, however, VSPT will not fully support this until 2.1(2).
Advice of Charge
This requirement describes the Advice of charge capabilities required for deployment of the VSC or signalling controller into the German marketplace. The German specifications are derived from ETSI standard (reference [4]) and on this basis, the functionality introduced is expected to meet other European marketplace requirements for this service.
The requirement can be separated into the following two parts:
•
•
Troubleshooting
•
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>:0In sh or ksh:
DISPLAY=<hostname>:0 ; export $DISPLAY•
–
–
•
–
–
•
/usr/bin/pkgparam _DART_PKG_NAME_ BASEDIR
•
In the examples below, the assumption is that CSCOvsp16 was installed in the directory /opt/CSCOvsp16, thus = /opt/CSCOvsp16
–
–
•
/usr/bin/grep DartStoreDir /opt/_DART_PKG_NAME_/classes/com/cisco/transpath/dart/editor/configEditor.properties
Note
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:
http://www.cisco.com/public/countries_languages.shtml
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:
•
http://www.cisco.com/cgi-bin/order/order_root.pl
•
http://www.cisco.com/go/subscription
•
Documentation Feedback
If you are reading Cisco product documentation on Cisco.com, 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 bug-doc@cisco.com.
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-9883We appreciate your comments.
Obtaining Technical Assistance
Cisco provides Cisco.com 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. Cisco.com registered users have complete access to the technical support resources on the Cisco TAC Web Site.
Cisco.com
Cisco.com 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.
Cisco.com 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
•
•
•
•
•
You can self-register on Cisco.com to obtain customized information and service. To access Cisco.com, 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:
•
•
•
•
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 Cisco.com 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:
http://www.cisco.com/register/
If you cannot resolve your technical issues by using the Cisco TAC Web Site, and you are a Cisco.com registered user, you can open a case online by using the TAC Case Open tool at the following URL:
http://www.cisco.com/tac/caseopen
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:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
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.
AccessPath, AtmDirector, Browse with Me, CCIP, CCSI, CD-PAC, CiscoLink, the Cisco Powered Network logo, Cisco Systems Networking Academy, the Cisco Systems Networking Academy logo, Fast Step, Follow Me Browsing, FormShare, FrameShare, GigaStack, IGX, Internet Quotient, IP/VC, iQ Breakthrough, iQ Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, MGX, the Networkers logo, Packet, RateMUX, ScriptBuilder, ScriptShare, SlideCast, SMARTnet, TransPath, Unity, Voice LAN, Wavelength Router, and WebViewer are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Discover All That's Possible, and Empowering the Internet Generation, are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, the Cisco IOS logo, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Enterprise/Solver, EtherChannel, EtherSwitch, FastHub, FastSwitch, IOS, IP/TV, LightStream, MICA, Network Registrar, PIX, Post-Routing, Pre-Routing, Registrar, StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and certain other countries.
All other trademarks mentioned in this document or Web site 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. (0108R)
Posted: Wed Aug 30 04:53:46 PDT 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
