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

Table Of Contents

Voice Services Provisioning Tool Utilities

Perform an Integrity Check

Checking Integrity for MGC Signaling Configuration

Checking Traffic Against MGC Configuration

View Generated MML Commands

View Generated Cisco MGW Commands

Deploy a Configuration

Deploying a New Configuration

Configuring an Incremental Deployment

Telnet

MGC Viewer

State Operation

Perform an Audit

Back Up and Restore

Schedule a Backup or Restore

Check Status of Backup or Restore

Make a Seed File


Voice Services Provisioning Tool Utilities


VSPT Release 2.3(1) provides many utilities, including tools to accomplish the following tasks:

Perform an Integrity Check

View Generated MML Commands

View Generated Cisco MGW Commands

Deploy a Configuration

Telnet

MGC Viewer

State Operation

Perform an Audit

Back Up and Restore

Perform an Integrity Check

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

Checking Integrity for MGC Signaling Configuration

Checking Traffic Against MGC Configuration

Checking 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 the configuration refers to an MGX, checks PeerAddrs on IPLNK to ensure that they are addresses on the specified MGX

For IPFAS IPLNK:

Ensures that SigSlot/SigPort is specified

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

Ensures that MGC ports and MGX ports match on the IPLNK

Checks that all IPLNK 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 showing the results of the integrity checks.

Figure 3-2 Integrity Check Results


View Generated MML Commands

The VSPT automatically generates 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 on the VSPT menu bar. A screen displaying generated MML, similar to the one shown in Figure 3-3, appears.

Figure 3-3 First Generated MML Screen

View Generated Cisco MGW Commands

To view the Cisco  MGW commands generated from your provisioning session, click View > MGW Commands on the main VSPT menu bar. 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

Deploy a Configuration

When you finish defining a configuration, you must deploy that configuration to the Cisco MGC. You can deploy to the Cisco MGC alone, to the Cisco MGC and one or more gateways, or to gateways only.


Note A new configuration should not be deployed during times of peak load on the Cisco MGC.


A configuration created in VSPT can be deployed to a Cisco MGC as a new configuration or incrementally. Deploying incrementally allows you to more quickly deploy modifications to an existing configuration without having to redeploy the entire configuration. VSPT also allows you to visually check the incremental commands it generates before deploying those commands to the MGC.

Deploying a New Configuration

Use the following procedure to deploy a new configuration.


Note 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.



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

Figure 3-5 Deploying a Configuration

Step 2 Indicate how you want to deploy the configuration:

To deploy to the Cisco MGC only, do one of the following:

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.

To deploy to the Cisco MGC and one or more selected gateways, select one of the above three options and also select one or more gateways from the list in Specify media gateways for deployment.

To deploy to selected gateways only (and not the Cisco MGC): Check the box next to Do not deploy to MGC and select one or more gateways from the list in Specify media gateways for deployment.


Note To select multiple gateways, you can use standard selection methods: Shift+click to select a contiguous range, Ctrl+click to select or deselect noncontiguous gateways.



Note If you select an option other than New, the Advanced button is enabled. For information about the options this button provides, see the "Configuring an Incremental Deployment" section.


Step 3 Enter the configuration name on the destination MGC.

Step 4 Select a configuration in the Based on configuration drop-down list. This list displays all existing configurations on the selected MGC and the [LAST IMPORT] and [NEW] options.

Last Import—The VSPT compares your provisioning session to the last imported configuration and deploys only changes you have made.


Note The LAST IMPORT option allows multiple users to modify an existing configuration. However, they must each be modifying a different area of the configuration for this option to work properly.


New—Your entire provisioning session is deployed as a new configuration.

Existing Configurations—VSPT imports the selected configuration from the Cisco MGC, compares the differences between that configuration and your current provisioning session, and deploys changes you have made.


Note Since you are deploying a new configuration, make sure to choose the New option in the Based on configuration drop-down list.


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

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

Figure 3-6 Deployment Progress



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


Configuring an Incremental Deployment

An incremental deployment allows you to modify an existing configuration and deploy only the modified areas to the Cisco MGG. Modifications can be made more quickly, and errors affecting unmodified areas are minimized. In addition, provisioning modifications made by other users in separate areas are not affected.


Note The Cisco MGC does not support some incremental deployment processes. If you have a problem with an incremental deployment, examine the MML commands to ensure that you have properly configured the desired components. Modify the component presenting the problem, or cancel the deployment and redeploy the component as a new configuration.


Use the following procedure to configure an incremental deployment:


Step 1 Follow Step 1 through Step 4 in the "Deploying a New Configuration" section

Step 2 Click Advanced in the window shown in Figure 3-5. The screen shown in Figure 3-7 appears.

Figure 3-7 Incremental Deployment Component Selector

If you have only made configuration changes to one or more of the areas listed, you can direct the VSPT to compare only those areas with the current configuration, and your modifications can be deployed more quickly.


Note If you select areas in this window, make sure to include all areas that you have modified.


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

Step 4 Go to Step 6 in the "Deploying a New Configuration" section, and complete the procedure described there. When you click OK, a screen similar to the one displayed in Figure 3-8 appears.

Figure 3-8 Confirm MML Commands

Step 5 Inspect the MML commands, modify them if desired, and click Yes to continue with the incremental deployment. Click No to reissue the deployment as a new configuration.


Telnet

Telnet is an application based on the Telnet protocol that allows you to connect to remote computers. VSPT Release 2 provides a utility to open a telnet session directly to a network device. Once you have established your telnet connection, you then log in to that device and execute commands remotely on the device through your telnet interface.

Use the following procedure to open a telnet session with a network device:


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

Figure 3-9 Select Remote Network Device 

    

Step 2 Select a device from the list, or enter the name or IP address of a device on your network, and click Go.

A screen similar to the one shown in Figure 3-10 appears.

Figure 3-10  Log In to Remote Device

   

   


MGC Viewer

The MGC Viewer allows you to view, activate, remove, and synchronize configurations on the MGC.

Use the following procedure to view configurations on a Cisco MGC:


Step 1 Click Tools > MGC viewer on the main VSPT menu. On the MGC Configuration screen that appears, click File > Open MGC. A screen similar to the one in Figure 3-11 appears.

Figure 3-11

Select MGC

Step 2 Enter the host name of the MGC in the Hostname box, enter the MGC login and password, and click OK. A screen similar to the one in appears and lists all configurations on the specified MGC.

Step 3 Click Configuration on the MGC Viewer menu bar, and select one of the following actions:

Activate—

Synchronize—

Delete—

State Operation

The State Operation utility provides the ability to query the active configuration on the Cisco MGC for the state of managed objects. After a query, you can modify the state of an object and apply the update to the MGC.

Use the following procedure to query the state of managed objects on the Cisco MGC:


Step 1 Click Tools > State Operation on the main VSPT menu. A screen similar to the one in appears.

Figure 3-12

State Operation Dialog

Step 2 Click OK. The VSPT queries the MGC and a screen similar to the one in appears.

Figure 3-13

MGC Managed Objects

Step 3 Expand the hierarcal tree in the left pane of the State Operations window to locate and highlight the object for which you want to know the state. In this example, we will display the state of linkset2. A window similar to the one in will appear and the right pane will display information about the state of the object you selected.

Figure 3-14

Step 4 From this window, you can modify the state by selecting the desired state in the ChangeTo box. Click Modify to change the state in this window, and click Commit to change the state on the Cisco MGC. To query the object again, click Refresh.

Perform an Audit

You can use an audit to ensure that both the Cisco MGC and a BAMS server supporting the MGC host have consistently configured signal paths. The audit involves examines signal path and bearer channel data on both servers, comparing the data, and reporting any differences.

Use the following procedure to perform an audit:


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

Figure 3-15 Perform an Audit


Step 1 Enter the MGC hostname, login, and password in the top pane of the window.

Step 2 To specify the configuration to audit, click Select, highlight the configuration to audit, and click OK.

Step 3 Enter the BAMS hostname, login, and password in the bottom pane of the window.

Step 4 To specify the configuration to audit, click Select, highlight the configuration to audit, and click OK.

Step 5 Click Audit. A screen similar to the one displayed in Figure 3-16 appears.

Figure 3-16 Audit Results

The left pane displays the signal path and bearer channel data configured on the MGC host, and the right pane displays the same data configured on the BAMS server.


Back Up and Restore

The VSPT backup and restore tool allows you to create, modify, and delete scheduled backups and restores hourly, daily, weekly, monthly, or on demand. You can perform back up and restore activities on any of the following devices if they have been configured for the MGC:

MGC Host—Active configuration

CAT5500—Configuration and image in Flash

CAT2900XL—Running-config and image in Flash

SLT2600—Running-config and image in Flash

BAMS P2—Active configuration

BAMS P3—Active configuration

HSI Adjunct Server—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 be performed by one UNIX login (specified during the installation process).


Schedule a Backup or Restore

To schedule a backup or restore, use the following procedure:


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

Figure 3-17 Backup and Restore Utility

Step 2 Click the component for which you want to schedule a backup. In the following example, the MGC component configuration is backed up. A screen similar to the one shown in Figure 3-18 appears when you click the MGC component.

Figure 3-18 Scheduling a Backup or Restore


Note If you want to perform a restore, you must have a backup file alreadycreated and available on the MGC.


Step 3 Highlight the component you want to back up or restore in the left pane of the main backup and restore tool window, and click Add. A screen similar to the one shown in Figure 3-19 appears.

Figure 3-19 Schedule an Activity


Note The fields available on the Schedule an Activity screen vary according to the component selected.


Step 4 In the Activity field, select the action you want to perform. 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 In the File Type drop-down list, select one of the following:

MGC System—Backs up data files for the active configuration, the Times Ten database, the XEconfigParm.dat file, and UNIX configuration files.

MML Config—Backs up exported MML files for the active configuration on the MGC

Step 9 Enter the IP address of the TFTP server.

Step 10 Enter the TFTP login and password.

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

Step 12 Select the schedule type. Choices include:

Monthly

Daily

Hourly

Weekly

Now

Later

Step 13 Select the hour and minute that the backup should begin.

Step 14 Click OK. The backup activity is scheduled, and a screen similar to the one shown in Figure 3-20 appears.

Figure 3-20 Display Activity Schedule

After the backup has been completed, the status of the activity is immediately available. The backup file with the name you specified is available for use with the VSPT.

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 when activity began

Success or failure

File name on the TFTP server

Directory of configuration files

Image file name

If you specified verbose log mode, the status log also displays 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 In the left pane of the backup and restore tool window, click the device that has been backed up or restored. Click the Status tab in 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—Displays the log file for the activity.

Acknowledge—Removes the text from the Status window and deletes the log file from the server.

Clear—Removes the text from the Status window, but the log file remains on the server.


Make a Seed File

A seed file is a file created by the VSPT that contains the IP addresses of all of the devices in the Cisco MGC network, plus the relationship (hierarchy) between the devices. With this file, Cisco MNM can automatically deploy all the elements in the network that have been configured with the VSPT.

For information about deploying a seed file, refer to the Cisco MNM Release 2.1or 2.3 User's Guide.

Use the following procedure to make a seed file:


Step 1 Click Tools > Make a Seed File on the main VSPT menu. The screen shown in Figure 3-21 appears:

Figure 3-21 Make a Seed File

Step 2 Enter the path and a filename, or click Select and specify a directory for the file. You can also choose the default, which is /var/opt/<basedir>/data/mgc/mistral/<configuration name>/WORKING/seed.file.

Step 3 Click OK. A seed file is created in the directory you specified.