Table Of Contents
Voice Services Provisioning Tool Overview
Uninstalling the VSPT Software
Defining Users and Permissions
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
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:
•
•
–
–
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
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:
•
http://www.cisco.com > Software Center > Voice Software > Cisco Voice Services Provisioning Tool
•
•
•
Note
Tip
Prerequisites
To install the VSPT software, you must have the following:
•
•
•
•
•
•
•
•
–
–
Approximately 1 MB for each configuration
Approximately 1 MB for each configuration snapshot
–
Approximately 0.5 MB for each deployment
•
–
–
•
–
–
•
Note
Preplanning
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
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
Step 2
Step 3
# cp -p /var/opt/CSCOvspXX/etc/dartpwd.txt /<temporary directory>/dartpwd.txtStep 4
Step 5
Note
Step 6
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
>su -root
>cd /
>/opt/CSCO15/uninstall/uninstall
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
Installing the VSPT Software
To install the software from the Cisco website, follow the procedure listed below:
Step 1
Step 2
>su - rootStep 3
#mkdir -p /var/tmp/CSCOvsp16-installStep 4
http://www.cisco.com> Software Center > Network Management > Cisco Voice Services Provisioning ToolStep 5
Step 6
Step 7
#tar xvf <filename>.tarStep 8
#./setup
Note
#./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 $DISPLAYStep 9
Step 10
#rm -rf /var/tmp/CSCOvsp16-installStep 11
Step 12
#./dartInstallation 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
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
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.
LinkSets
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
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:
•
•
•
•
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
Step 2
>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
>./dart
The system opens the X-windows , and the login screen appears.
Step 4
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
New
Begin a new configuration session.
Open
Open an existing configuration.
Import
Import an existing configuration from a MGC, as well as import trunk group, trunk, routing, and dial plan files into the VSPT.
Export
Export files from the VSPT.
Save
Save the current configuration:
•
•
•
Note
Exit
Stop any open provisioning sessions and close the VSPT.
The View menu contains the choices listed in Table 1-4.
The Tools menu contains the choices listed in Table 1-5.
Buttons
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:
•
•
•
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
The screen in Figure 1-3 appears.
Figure 1-3 VSPT User Administration
Step 2
•
•
•
Exiting the VSPT
You can exit the VSPT at any time by performing one of these actions:
•
•
