Cisco Voice Services Provisioning Tool User's Guide, 2.1
VSPT Utilities

Table Of Contents

Voice Services Provisioning Tool Utilities

Performing an Integrity Check

Checking Integrity for MGC Signaling Configuration

Checking Traffic Against MGC Configuration

Viewing Generated MML

Viewing Generated Cisco MGW Commands

Deploying a New Configuration

Backup and Restore

Schedule a Backup or Restore

Check Status of Backup or Restore


Voice Services Provisioning Tool Utilities


VSPT 2.1 provides many utilities, including tools to accomplish the following tasks:

Performing an Integrity Check

Viewing Generated MML

Viewing Generated Cisco MGW Commands

Deploying a New Configuration

Backup and Restore

Performing an Integrity Check

When provisioning is complete, you can perform an integrity check to prevent possible configuration errors. The integrity check involves:

Integrity for MGC signaling configuration

Traffic against MGC configuration

Dial plan results

Each integrity check is explained in more detail in the following subsections.

Checking Integrity for MGC Signaling Configuration

When you perform an integrity check for MGC signaling configuration, the VSPT does the following:

Checks that the hostname is specified for MGC

Checks that login/passwords are specified for MGC

Checks that MGC ipaddrs are specified

Checks that if MGC failover is specified, the failover IPs are specified

Checks that MGX hostname is specified

Checks that MGX login/password is specified

Checks the MGX IPaddrs

For EXTNODES where it refers to an MGX, checks PeerAddrs on IPLNK to ensure that they are addresses on the specified MGX

For IPFAS IPLNKS:

Ensures that SigSlot/SigPort are specified

Checks SigSlot/SigPort on MGX to ensure that they are valid as specified on the MGX

Ensures that MGC ports and MGX ports match on the IPLNK

Checks that all IPLNKS under a single IPFASPATH map to the same port number


Note The number of IPFAS sessions utilizing a given port is displayed because some IPLNKs might use different port IDs.


Checking Traffic Against MGC Configuration

When you perform an integrity check of traffic against the MGC configuration, the VSPT does the following:

When D channels are defined as FAS and NFAS PRI in the trunk group/trunk section, verifies that there are corresponding IPFASPATH signaling services with corresponding IPLNKs

Checks if there are any defined IPFASPATH signaling services defining a D channel but no corresponding trunk group/trunk in the traffic information with a corresponding NFAS/FAS PRI.

Checks that signaling services defined for trunk groups exist in the configuration

For information about an integrity check of dial plan results, refer to the Cisco  Media Gateway Controller Software Release 9 Dial Plan Guide.

Use the following procedure to perform an integrity check of your configuration:


Step 1 Click Tools > Integrity Check. The screen shown in Figure 3-1 appears.

Figure 3-1 Integrity Check

Step 2 Indicate the tests you want to run, and click Start.

When the tests finish, a screen similar to the one in Figure 3-2 appears and displays the results of the integrity checks performed.

Figure 3-2 Integrity Check Results


Viewing Generated MML

The VSPT automatically generates the MML commands to provision your Cisco  MGC and saves these commands in a file to be executed when you deploy the configuration. To view the MML commands generated from your VSPT provisioning session, click View > MML. Screens displaying generated MML, similar to the one shown in Figure 3-3, appears.

Figure 3-3 First Generated MMLScreen

Viewing Generated Cisco MGW Commands

To view the Cisco  MGW commands generated from your provisioning session, click View > MGW Commands. A screen with generated Cisco  MGW commands, similar to that shown in Figure 3-4, appears.

Figure 3-4 Example of Generated Cisco MGW Commands

Deploying a New Configuration

When you finish defining a configuration, you must deploy that configuration to the Cisco  MGC. A new configuration should not be deployed during times of peak load on the Cisco  MGC.

The new configuration can be deployed completely or in parts, known as an incremental deployment. Deploying incrementally allows you to verify each component type configuration before proceeding to the next component deployment.

If you want to delete a component and plan to reuse the component name, first delete the component, deploy the session, and verify that the component name has been deleted before reusing the name.

Use the following procedure to deploy a new configuration:


Step 1 Click Tools > Deploy on the main VSPT menu. The screen shown in Figure 3-5 appears.

Figure 3-5 Deploying a Configuration

Step 2 Enter the configuration name on the destination MGC.

Step 3 To incrementally deploy a configuration component type, click Advanced. The screen shown in Figure 3-6appears.

Figure 3-6 Incremental Deployment Component Selector

Step 4 Select one or more component types to deploy, and click OK.

Step 5 Indicate how you want to deploy the configuration:

If you want to send the configuration to the MGC but not activate it, click the button next to Send Configuration to MGC Only.

If you want to send the configuration to the MGC and activate it, click the button next to Send and Activate Configuration.

If you have a continuous-service configuration with two Cisco  MGC hosts, click the button next to Send, Activate and Synchronize failover. The configuration is saved on the active host and copied to the standby host. You must restart the standby server after reconfiguration to apply changes.

If you do not want to deploy a configuration to the MGC but only to MGXs, click the box next to Do not deploy to MGC.

Step 6 Select the gateways you want to deploy, if applicable.

Step 7 Click OK.. The screen shown in Figure 3-7 appears and displays the status as the current provisioning session is deployed.

Figure 3-7 Deployment Progress



Note In a continuous-service configuration, the XECfgParm.dat file on each machine must be configured. If you experience problems, verify the XECfgParm.dat files on both machines with Chapter 2, "Installing Cisco  Media Gateway Controller Software," in Cisco  Media Gateway Controller Software Release 9 Installation and Configuration Guide.


Backup and Restore

The VSPT backup and restore tool allows a user to create, modify, and delete scheduled backups and restores on a hourly, daily, weekly, or monthly basis or on demand. Backup and restore activities can be performed on any of the following devices that have been configured for the MGC:

MGC Host—Active configuration

CAT5500—Configuration and image on flash

CAT2900XL—Running-config and image on flash

SLT2600—Running-config and image on flash

BAMS P2—Active configuration

The backup and restore tool also provides the status of each activity and generates user viewable status logs.


Note This tool operates in coordination with the MGC server operating system and can only be performed by one UNIX login, specified during the installation process


Schedule a Backup or Restore

Use the following procedure to open the VSPT backup and restore tool and schedule an activity:


Step 1 Click Tools > Backup and Restore on the main VSPT menu bar. The screen shown in Figure 3-8 appears:

Figure 3-8 Backup and Restore Utility

Step 2 Click the component for which you want to schedule a backup or restore. The following example backs up the MGC. A screen similar to the one shown in Figure 3-9 appears.

Figure 3-9

Scheduling a Backup or Restore


Note If you want to perform a restore, a backup file must have already been created and must be available on the MGC.


Step 3 To schedule a backup or restore, highlight the component you want to backup or restore on the left pane of the main backup and restore tool window, and click Add. A screen similar to the one shown in Figure 3-10 appears:

Figure 3-10 Schedule an Activity


Note Available fields will vary depending on the component selected.


Step 4 Select the action you want to perform, in the Activity field. Valid choices include backup and restore.

Step 5 Enter the IP address of the Cisco MGC.

Step 6 Enter the MGC login and password.

Step 7 Enter a name for the backup file.

Step 8 Enter the IP address of the TFTP server.

Step 9 Enter the TFTP login and password.

Step 10 Specify whether or not to use verbose log mode. Verbose mode records all commands issued by the VSPT and any system responses.

Step 11 Select the schedule type. Valid choices include:

Monthly

Daily

Hourly

Weekly

Now

Later

Step 12 Select the hour and minute that the backup will begin.

Step 13 Click OK. The backup activity will be scheduled, and a screen similar to the one shown in Figure 3-11 appears:

Figure 3-11 Display Activity Schedule

After the backup has been completed, the status of the activity will be available immediately, and the backup file with the name you specified will be available to use with the VSPT to perform a restore.

Check Status of Backup or Restore

The VSPT generates status logs that provide information about each scheduled activity. The status log displays the following information for the activity:

Date and time

Success or failure

File name on the TFTP server

Directory of configuration files

Image file name

If a user has specified verbose log mode, the status log will also display the sequence of commands issued by the VSPT and any system responses.

Use the following procedure to check the status of a backup or restore activity:


Step 1 Click the device that has been backed up or restored, on the left pane of the backup and restore tool window, and click the Status tab on the right pane.

Step 2 Highlight the backup or restore for which you want information.

Step 3 Select the appropriate button for the action you want to perform. Choices are:

Show status

Acknowledge

Clear