Table Of Contents
Release Notes for Cisco Voice Interworking Service Module Release 3.1(1)
These release notes are part number OL-3480-01 Rev. D0, January 9, 2004
The Voice Interworking Service Module (VISM) product is supported by MGX Voice Media Gateways. Refer to these release notes for Media Gateway and version level support guidelines.
The software Release 3.1(1) for VISM/VISM-PR is an upgrade from the VISM 3.1(0) Release. For details related to new features added in Release 3.1, refer to Release Notes for Cisco Voice Interworking Service Module Release 3.1(0).
The software Release 3.1(1) for VISM/VISM-PR is supported by the Cisco VISM Installation and Configuration Guide, which is available on cisco.com.
These release notes contain the following sections:
Elements of Release 3.1(1)
This section describes the following elements of software Release 3.1(1) for VISM/VISM-PR:
VISM Management Information Base
The VISM Management Information Base (MIB) Version 0.0.30 is provided with the delivery of software Release 3.1(1) for VISM/VISM-PR, which bundles with the Cisco MGX 8230,
Cisco MGX 8250, Cisco MGX 8830, and MGX 8850 software on the Web at the following location:
When the selected FW *.tar file or FW*.zip file is downloaded, untar or unzip the file and you will find all the latest MIBs bundled with this release.
The MIB is in standard ASN.1 form and can be compiled with most standards-based MIB compilers. Refer to the MIB release notes on the Web.
New VISM/VISM-PR CLI Commands
Software Release 3.1(1) for VISM/VISM-PR includes the following new command-line interface (CLI) commands:
Note The CLI does not have MIB variables associated with these commands. If the VISM card is reset, you must reconfigure the parameters.
Use the dsplinesabyte to display the transmit and receive SA buffers.
Examplecvgmgx1a.1.20.VISM8.a > dsplinesabyte 1Line 1 Transmit SA Buffer Registers------- -------Transmit Sa4-byte Buffer: 255Transmit Sa5-byte Buffer: 255Transmit Sa6-byte Buffer: 255Transmit Sa7-byte Buffer: 255Transmit Sa8-byte Buffer: 255Line 1 Receive SA Buffer Registers------- -------Receive Sa4-byte Buffer: 0Receive Sa5-byte Buffer: 0Receive Sa6-byte Buffer: 0Receive Sa7-byte Buffer: 0Receive Sa8-byte Buffer: 0
Possible errors include
•Incorrect number of parameters.
•Line number is out-of-range.
Use the cnflinesabyte command to configure SA bytes on a line.
cnflinesabyte <line_number> <sa_byte> <sa_value>
Line number in the range 1-8.
Type of sabyte.
•1 = sa4-byte
•2 = sa5-byte
•3 = sa6-byte
•4 = sa7-byte
•5 = sa8-byte
Range is 0-255.
The possible error includes invalid parameters.
This example shows configuring SA buffers on line 1 and displaying the results.cvgmgx1a.1.20.VISM8.a > cnflinesabyte 1 3 0cvgmgx1a.1.20.VISM8.a > dsplinesabyte 1Line 1 Transmit SA Buffer Registers------- -------Transmit Sa4-byte Buffer: 0Transmit Sa5-byte Buffer: 255Transmit Sa6-byte Buffer: 0Transmit Sa7-byte Buffer: 255Transmit Sa8-byte Buffer: 255Line 1 Receive SA Buffer Registers------- -------Receive Sa4-byte Buffer: 0Receive Sa5-byte Buffer: 0Receive Sa6-byte Buffer: 0Receive Sa7-byte Buffer: 0Receive Sa8-byte Buffer: 0
Table 1 provides the support level for 1:N Service Module Redundancy (N = 1 through 11).
Note You can use a VISM-PR card as a redundant card for a VISM card, but a VISM card cannot be used as a redundant card for a VISM-PR card.
There is support for Bulk Distribution using the SRM-3T3 and SRM-E (OC3) cards.
VISM Call Rate
Software Release 3.1(1) for VISM/VISM-PR handles at least 10 CAS, SS7, or PRI calls per second per VISM card.
VISM software interoperability with Cisco MGX 8830, Cisco MGX 8850 (PXM1E), Cisco MGX 8850 (PXM1), Cisco MGX 8850 (PXM45), Cisco MGX 8250, and Cisco MGX 8230 platform software is listed in Table 2.
Table 2 VISM Software Interoperability
Product CW2000 Name Latest Firmware Min. Firmware
10.5.101 patch 1
1.1.40 and 1.2.0
1.1.40 and 1.2.0
1.1.40 and 1.2.0
1.1.40 and 1.2.0
2 This card is not compatible to VISM cards.
VISM software interoperability with other Cisco products is described in Table 3.
Table 3 Software Release 3.1(1) for VISM/VISM-PR Interoperability with Other Cisco Products
Virtual Switch Controller Software
Table 4 describes the software images available for Release 3.1(1) for VISM/VISM-PR.
Table 4 Software Images for Release 3.1(1) for VISM/VISM-PR
Product Name Software Image Firmware Description
This image does not support the CALEA1 feature.
Use this image for CALEA1 feature support.
1 CALEA = Commission on Accreditation for Law Enforcement Agencies.
2 The CALEA implementation supports the CALEA law intercept confirmation interface.
Table 5 describes the software boot code and run-time firmware requirements for software Release 3.1(1) for VISM/VISM-PR.
Note Loading this release of the backup bootcode is required for existing VISM cards not using this new release.
Limitations and Restrictions
The following limitations and restrictions are valid for software Release 3.1(1) for VISM/VISM-PR:
•Software Release 3.1(1) for VISM/VISM-PR requires you to use 64 Mb VISM cards or VISM-PR cards exclusively.
•The switched AAL2 PVC operating mode is not supported in software Release 3.1(1) for VISM/VISM-PR.
•Cisco recommends that you use the cnfcodecjtrdelay command to configure the jitter-delay argument to 20 msec when using DSP firmware versions 3.4 and 3.6.
•Table 6 describes the design constraint which is identified in software Release 3.1(1) for VISM/VISM-PR.
Installation and Upgrade Procedures
This section describes the following installation and upgrade procedures:
VISM Firmware and Boot Code Download Procedure for PXM1
Step 1 Download the selected revision of service module boot code into the service module in the selected.
a. tftp <node_name or IP address>
c. put <backup boot> POPEYE@SM_1_0.BT
a. tftp <node_name or IP address>
c. put <FW file> POPEYE@SM_1_0.FW
d. put <FW file> POPEYE@SM_1_<slot number of card to upgrade>.FW
Note Do not enter two put commands in the same TFTP session.
Step 3 Proceed to the "Installing VISM Software Updates with PXM1 Cards" section to install the download.
VISM Firmware and Boot Code Download Procedure for PXM1E and PXM45
Step 1 Access the image on the Cisco Web site in order to download the image.
Step 2 Use the ftp node-ip command, where node-ip is the IP address of the node to which you want to download the image, to download the image.
Step 3 Enter your username and password.
Step 4 Type cd C:FW to access the appropriate directory.
Step 5 Type bin.
Step 6 Use the put image-version, where image-version is the downloaded image from Step 1, to download the image to your C:FW directory.
Step 7 Type bye to exit the download procedure.
VISM/VISM-PR Firmware Upgrade
Software Release 3.1(1) for VISM/VISM-PR introduces the new VISM-PR card. Complete the following steps to gracefully upgrade from VISM cards to VISM-PR cards. You must ensure that the VISM and VISM-PR cards have the minimum boot code version of vism_8t1e1_BT_3.1.00.fw.
The following versions of VISM software Release 3.1(1) are available:
Note You do not have to complete these instructions in order to use software Release 3.1(1) for VISM/VISM-PR; however, see the VISM Features section of the Release Notes for Cisco Voice Interworking Service Module Release 3.1(0) of features that are not available to you if you do not perform this upgrade procedure.
VISM cards and VISM-PR cards use the same back cards. There are no new back cards introduced with this release. In the following procedure:
•Perform the firmware upgrade in the following procedure on the VISM cards; do not remove the VISM cards and replace them with VISM-PR cards at this time.
•Two VISM cards are involved in a redundancy group, initially with the primary card in the active state and the secondary card in the standby state.
•Old-rev refers to the firmware before the upgrade (2.2).
•New-rev refers to the firmware after the upgrade (3.1).
Step 1 Log in to the active PXM1 card (slot 7 or 8).
Step 2 Save the existing configuration as a contingency plan by entering:
savesmcnf <SM slot#>
This will save the existing configuration in the C:CNF directory. This file can be used during the downgrade procedure, if necessary.
Step 3 Execute the PXM install command:
install sm <SM slot#> <new-rev>
SM slot# is the slot number of the primary VISM card and new-rev is the file name of the new firmware (for example, vism_8t1e1_300.001.000.000.fw).
This command causes the secondary VISM card to reset and come up in the standby state, running the new-rev firmware. The primary VISM card is unaffected by this command.
Step 4 Execute the PXM newrev command:
newrev sm <SM slot#> <new-rev>
SM slot# is the slot number of the primary VISM card and new-rev is the filename of the new firmware.
This command causes the primary VISM to reset and the secondary VISM card to become the active VISM running the new-rev firmware.
Step 5 Execute the PXM commit command:
commit sm <SM slot#> <new-rev>
SM slot# is the slot number of the primary VISM card and new-rev is the filename of the new firmware.
The two VISM cards are now back to their original condition except that both cards are now running the new-rev firmware.
Step 6 Log in to the active VISM card and use the display commands (dspendpts, dspcasvar, etc.) to confirm that the configuration has been preserved through the upgrade process.
It is also recommended that a further verification be performed by making some minor modifications to the configuration, checking that the changes have been executed correctly, and then changing the configuration back again.
VISM to VISM-PR Hardware Upgrade
Complete the following steps to upgrade your system from VISM cards to VISM-PR cards.
Caution You must install the redundant (standby) VISM-PR card first; failure to follow this recommendation results in traffic loss. In addition, do not remove an active VISM card from your chassis; ensure that you configure an active VISM card to the standby state before you remove it and replace it with a VISM-PR card.
Step 1 Remove the redundant (standby) VISM card from your chassis.
Step 2 Install a VISM-PR card in the slot you removed the VISM card from in Step 1.
Step 3 Administratively configure the VISM-PR card you installed in Step 2 as primary (active).
Step 4 Remove the now redundant VISM card from your chassis.
Step 5 Install a VISM-PR card in the slot you removed the VISM card from in Step 4.
Step 6 Log into the redundant (secondary) VISM-PR card and execute the dspcd command. Verify that the output from the dspcd command lists the card type under FunctionModuleType as a VISM-PR card. If the card type still indicates the VISM card, execute the resetcd slot-num command from the PXM and repeat the dspcd command to insure that the correct card type is shown.
Step 7 Log into the active VISM-PR card and execute the dspcd command. Verify that the output from the dspcd command lists the card type under FunctionModuleType as a VISM-PR card. If the card type still indicates the VISM card, execute the resetcd slot-num command from the PXM and repeat the dspcd command to insure that the correct card type is shown.
Step 9 Remove a standby VISM card from your chassis.
Step 10 Install a VISM-PR card in the slot you removed the VISM card from in Step 9.
Installing VISM Software Updates with PXM1 Cards
Software Release 3.1(1) for VISM/VISM-PR provides a procedure for the graceful upgrade (one in which the existing VISM configuration is preserved throughout the upgrade procedure) from the earlier VISM 2.0 release.
Caution Installing VISM software updates from VISM Release 2.2 with CALEA to VISM Release 3.0 without CALEA is not graceful.
Caution Temporary traffic loss occurs during Step 4 and Step 5 of the VISM graceful upgrade procedure of the Upgrade Procedure for software Release 3.1(1) for VISM/VISM-PR.
The following initial conditions are required before the graceful upgrade procedure can be started:
•The MGX 8000 Series shelf must be configured with at least two VISM cards in a redundant configuration (refer to the add redundancy, addred, command in the MGX 8830, MGX 8850, MGX 8250, and MGX 8230 Command Reference documentation for more information).
•The VISM cards must be running VISM 2.0 and be configured to the desired configuration.
•The software Release 3.1(1) for VISM/VISM-PR must have been already downloaded to the MGX shelf.
•Ensure that you have the version of VISM software that supports CALEA, if you are using the CALEA feature.
Upgrades are available for the following releases:
•From VISM 1.5 to VISM 3.1
•From VISM 2.1 to VISM 3.1
•From VISM 2.2 to VISM 3.1
•From VISM 3.0 to VISM 3.1
Installing VISM Software Updates with PXM1E or PXM45 Cards
Complete the following steps to update the VISM software when you are using PXM1E or PXM45 cards in your MGX 8000 Series chassis:
Step 1 Log on to the active PXM1E or PXM45 card.
Step 2 Ensure that the card is in the redundant mode, where the active card is the primary card.
Step 3 Use the saveallcnf command to save the existing configuration as a contingency plan.
Step 4 Use the loadrev sm-primary-slot-num new-rev command, where sm-primary-slot-num is the slot number of the VISM/VISM-PR card you to which you want to install the new software, and new-rev is the new firmware version number for the VISM software.
Step 5 Use the runrev sm-primary-slot-num new-rev command to execute the download.
Step 6 Use the commitrev sm-primary-slot-num new-rev command to commit the new download to the VISM/VISM-PR card.
You have completed the steps. Proceed to the VISM Boot Code Upgrade Procedure with PXM1E and PXM45 Cards.
VISM Boot Code Upgrade Procedure with PXM1 Cards
There is a new backup boot code change from VISM Release 2.2(0) to software Release 3.1(1) for VISM/VISM-PR. Complete the following steps to upgrade the new backup boot code when you are using PXM1 cards in your MGX 8230, MGX 8250, and MGX 8850 chassis:
Note This procedure re-programs the VISM boot code for previous VISMs using the VISM runtime image version 1.0 to 2.0.
Step 1 Telnet to MGX shelf and cc to the VISM card.
Note VISM must be in the active state in order to update the VISM boot code.
Step 2 Access the server where the VISM boot code resides and TFTP the VISM boot code to the VISM card with the following procedure:
a. Type tftp <IP address of the MGX shelf>
b. Type bin at the tftp prompt.
Caution Ensure that you perform Step 2 b. If you to not perform Step 2 b. the boot code will be corrupted and not recoverable.
c. Type install [bt] [sm <slot>] <version> at the PXM prompt.
Caution Do not touch the VISM card until the status comes back ('Sent xxx bytes in yyy seconds'). Failure to follow this recommendation will corrupt the boot code and it will not be recoverable.
When the boot code is being written to PROM, you will see comments displayed at the VISM prompt. This is normal and expected behavior.
Step 3 Use the resetcd command for VISM from the PXM card for the latest boot take effect.
Step 4 Type the version command to verify the correct boot code.
Note Step 4 is optional.
You have completed upgrading the new VISM backup boot code.
VISM Boot Code Upgrade Procedure with PXM1E and PXM45 Cards
There is a new backup boot code change from VISM Release 2.2(0) to software Release 3.1(1) for VISM/VISM-PR. Complete the following steps to upgrade the new backup boot code when you are using PXM1E or PXM45 cards in your MGX 8000 Series chassis:
Step 1 Complete the steps in the VISM Firmware and Boot Code Download Procedure for PXM1E and PXM45.
Step 2 Log on to the PXM1E or PXM45 card.
Step 3 Use the burnboot sm-primary-slot-num new-rev command, where sm-primary-slot-num is the slot number of the VISM/VISM-PR card you want to upgrade and new-rev is the firmware version number of the new VISM software, to upgrade the VISM/VISM-PR boot code.
The VISM/VISM-PR card automatically resets and becomes active with the latest boot code image. You have completed the boot code upgrade procedure.
VISM Downgrade Procedure
Use this procedure to downgrade VISM software from software Release 3.1(1) for VISM to the earlier VISM Releases 3.1, 3.0, 2.2, 2.1, and 2.0. By following the downgrade procedure described here, the configurations will be retained after downgrade.
Note It is important to note that the configurations that existed with old-rev firmware should have been saved earlier. You cannot downgrade from VISM-PR to VISM.
Complete the following steps to downgrade the VISM software from software Release 3.1(1) for VISM/VISM-PR to Release 3.1, 3.0, 2.2, 2.1, or 2.0:
Step 1 If the VISM card is in a redundancy group, remove the redundancy.
delred <SM slot#>
Step 2 Download the old-rev firmware onto the MGX shelf.
Step 3 Execute the PXM clrsmcnf command:
clrsmcnf <SM slot#>
SM slot# is the slot number of the VISM card to be downgraded.
The VISM card will be reset on executing this command. Wait for the card to come active.
Step 4 Execute the PXM restoresmcnf command:
restoresmcnf -f <filename> -s <SM slot#>
The filename is the name of the old configuration file that was saved while the old-rev firmware was running. The file can be found in the C:CNF directory on the MGX shelf.
The SM slot# is the slot number of the VISM card to be downgraded.
The VISM card will be reset again. When the card comes active, it will have the old-rev firmware running and will have the old configuration.
Step 5 Reconfigure redundancy group, if required.
This section describes resolved and open software caveats for this release of VISM. Caveats describe unexpected behavior or defects in VISM software.
Table 7 describes the caveats issued against VISM software that have been resolved in software Release 3.1(1) for VISM/VISM-PR.
Table 8 describes possible unexpected behavior by software Release 3.1(1) for VISM/VISM-PR.
The following documents contains information that may be useful to software Release 3.1(1) for VISM/VISM-PR:
•Cisco VISM Installation and Configuration Guide, Release 3.0
•Cisco MGX 8830, MGX 8850 (PXM45 and PXM1E), and MGX 8950 Command Reference, Release 3
•Cisco MGX 8850 (PXM45 and PXM1E) Hardware Installation Guide, Release 3
•Cisco MGX 8850 (PXM45) and MGX 8950 Software Configuration Guide, Release 3
Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.
You can access the most current Cisco documentation on the World Wide Web at this URL:
You can access the Cisco website at this URL:
International Cisco websites can be accessed from this URL:
You can find instructions for ordering documentation at this URL:
You can order Cisco documentation in these ways:
•Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool:
•Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).
You can submit e-mail comments about technical documentation to firstname.lastname@example.org.
You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.
Obtaining Technical Assistance
For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, the Cisco Technical Assistance Center (TAC) provides 24-hour-a-day, award-winning technical support services, online and over the phone. Cisco.com features the Cisco TAC website as an online starting point for technical assistance. If you do not hold a valid Cisco service contract, please contact your reseller.
Cisco TAC Website
The Cisco TAC website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The Cisco TAC website is available 24 hours a day, 365 days a year. The Cisco TAC website is located at this URL:
Accessing all the tools on the Cisco TAC website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a login ID or password, register at this URL:
Opening a TAC Case
Using the online TAC Case Open Tool is the fastest way to open P3 and P4 cases. (P3 and P4 cases are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Case Open Tool automatically recommends resources for an immediate solution. If your issue is not resolved using the recommended resources, your case will be assigned to a Cisco TAC engineer. The online TAC Case Open Tool is located at this URL:
For P1 or P2 cases (P1 and P2 cases are those in which your production network is down or severely degraded) or if you do not have Internet access, contact Cisco TAC by telephone. Cisco TAC engineers are assigned immediately to P1 and P2 cases to help keep your business operations running smoothly.
To open a case by telephone, use one of the following numbers:
Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553-2447
For a complete listing of Cisco TAC contacts, go to this URL:
TAC Case Priority Definitions
To ensure that all cases are reported in a standard format, Cisco has established case priority definitions.
Priority 1 (P1)—Your network is "down" or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.
Priority 2 (P2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.
Priority 3 (P3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.
Priority 4 (P4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.
Obtaining Additional Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
•Cisco Marketplace provides a variety of Cisco books, reference guides, and logo merchandise. Go to this URL to visit the company store:
•The Cisco Product Catalog describes the networking products offered by Cisco Systems, as well as ordering and customer support services. Access the Cisco Product Catalog at this URL:
•Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press online at this URL:
•Packet magazine is the Cisco quarterly publication that provides the latest networking trends, technology breakthroughs, and Cisco products and solutions to help industry professionals get the most from their networking investment. Included are networking deployment and troubleshooting tips, configuration examples, customer case studies, tutorials and training, certification information, and links to numerous in-depth online resources. You can access Packet magazine at this URL:
•iQ Magazine is the Cisco bimonthly publication that delivers the latest information about Internet business strategies for executives. You can access iQ Magazine at this URL:
•Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:
•Training—Cisco offers world-class networking training. Current offerings in network training are listed at this URL:
CCIP, CCSP, the Cisco Arrow logo, the Cisco Powered Network mark, Cisco Unity, Follow Me Browsing, FormShare, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study 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, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherSwitch, Fast Step, GigaStack, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, MGX, MICA, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, RateMUX, Registrar, ScriptShare, SlideCast, SMARTnet, StrataView Plus, Stratm, SwitchProbe, TeleRouter, The Fastest Way to Increase Your Internet Quotient, TransPath, 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. (0304R)
Copyright © 2004, Cisco Systems, Inc.
All rights reserved.