Table Of Contents
Migration From Automatic Routing Management to PNNI Using Cisco WAN Manager
Migration Process Overview
Upgrade Cisco WAN Manager from 10.x to 11.
Preparing To Upgrade Cisco BPX Switch Software From 9.2.34 to 9.3.30
Gracefully Upgrading the BCC Card Pair on the BPX node
Gracefully Upgrading the Rest of the Cards on the BPX Node
Upgrading Existing Switch Software to 9.3.30
Upgrading the MGX 8850 from Release 2 to Release 2.1 Software
XPVC Creation Overview
XPVC as a Migration Connection
XPVC/XPVP Provisioning and Management
Connection Creation for XPVC/XPVPs
Creating an XPVC
XPVC Preferred Table Configurator
CWM-XPVC-CLI
Adding an XPVC
Example (Add an XPVC Syntax)
Deleting an XPVC
Example (Delete an XPVC Command Syntax)
Connection Manager Support for XPVCs
XPVC Provisioning via Service Agent
Location of ConnProxy Scripts
Adding an XPVC Connection: AddConn script
Deleting an XPVC Connection: DelConn script
Fault Segment Isolation: FaultIsolation script
Get Any Connection: GetAnyConn script
Get Connection Errors: GetConErr script
Get Connection Details: GetConnDetails script
Get Connection Index: GetConnIndex script
Modifying an XPVC Connection: ModConn script
End to End Test Connection or Test Delay: TestConnDelay script
Trap support for XPVCs
Displaying XPVC Status
Displaying Information on a Specified XPVC Segment
XPVC End-to-end Test Delay
Connection Templates
Migration From Automatic Routing Management to PNNI Using Cisco WAN Manager
This chapter provides details on the AutoRoute to PNNI migration process, including upgrading switch software, and creating and managing extended permanent virtual circuits (XPVCs) and extended permanent virtual paths (XPVPs).
Migration Process Overview
The migration process consists of the following tasks:
•
Upgrading Cisco WAN Manager from Release 10.x to 11
•
Preparing to upgrade BPX switch software from Release 9.2.3z to 9.3.30
•
Gracefully upgrading the BPX node (BCC card pair)
•
Verifying that the upgrade has propagated to all the nodes in the network
•
Upgrading the MGX 8850 from Release 2 to Release 2.1
Upgrade Cisco WAN Manager from 10.x to 11.
Upgrade Cisco WAN Manager from Release 10.x to 11. Refer to the Upgrading Cisco WAN Manager chapter in the Cisco WAN Manager Installation Guide for Solaris, Release 11.
Preparing To Upgrade Cisco BPX Switch Software From 9.2.34 to 9.3.30
Upgrade the Cisco BPX switch software from Release 9.2.34 to Release 9.3.30. Complete the following steps:
Step 1
Use "Configuration Save & Restore" on the node before starting the upgrade process.
Refer to Chapter 13, "Saving and Restoring Node Configurations", in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Config-save-restore GUI to save the configuration on the switch.
Step 2
Enter the dspcds command in a telnet window to verify that the BCC cards are running Release 9.2.34 of the BPX switch software.
Step 3
Verify with the dspcds command that the node contains the appropriate firmware and hardware revisions.
Refer to the Compatibility Matrixes in the Switch Software Release Notes for Release 9.2.34 to confirm this.
The user can also verify the same information using Network Browser. Refer to Chapter 5, "Network Browser", in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Network Browser.
Step 4
Enter the clrlog, clrswlog and clrcderrs commands to clear the error logs and SW logs on the node.
Syntax and detailed descriptions of these commands are available in the Cisco WAN Switching Command Reference, Release 9.3.30.
Step 5
Verify that the nodes in the Automatic Routing Management network are free of alarms, including card alarms and SW alarms by entering the dspalms and dspnodes commands on the node.
Syntax and detailed descriptions of these commands are available in the Cisco WAN Switching Command Reference, Release 9.3.30.
Step 6
Verify that the Cisco WAN Manager Topology and Network Browser applications also show that the nodes are free of alarms
Step 7
Enter the dspcons, dspcons -fail, dspcons -abit, and dspcons -oam commands to verify that none of the existing complete connections is in failed state, and there are no A-bit or OAM alarms. All incomplete and failed connections are in failed state.
Step 8
Use the Connection Manager GUI, or the user_connection and atm_connection tables to verify that none of the existing complete connections is in failed state, and that there are no A-bit or OAM alarms. All incomplete and failed connections are in failed state.
Step 9
Enter the dspports command to verify that all the ports are free of alarms
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the dspports command.
Step 10
Verify, using the Connection Manager and the Network Browser application, that the ports are free of alarms.
Refer to Chapter 5, Network Browser, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Network Browser GUI. Refer to Chapter 3, Connection Manager, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Connection Manager GUI.
Step 11
Enter the dsptrks and dsplns commands to verify that all the trunks and lines are free of alarms.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the dsptrks and dsplns commands.
Step 12
Use the Topology application and the Network Browser application to verify that the lines are free of alarms.
Refer to Chapter 5, Network Browser, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Network Browser GUI and to Chapter 3, Topology Manager, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Topology application.
Step 13
Enter the tstdelay command to verify data continuity on the complete end to end Automatic Routing Management PVCs.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the tstdelay command. All incomplete and failed connections are in failed state.
Step 14
Enter the tstconseg command to verify data continuity on all connections initiated to the CPE.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the tstconseg command. All incomplete and failed connections are in failed state.
Gracefully Upgrading the BCC Card Pair on the BPX node
Perform the following steps to upgrade gracefully the BCC cards on a BPX node
Step 1
Use tftp to load the saved configuration on the node as part of the upgrade process.
Refer to Chapter 12, Downloading Software and Firmware, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on entering TFTP commands to load the new version of software and firmware to the node.
Step 2
While upgrading the node, verify that the node is not shown in the topology GUI but comes up after the upgrade is done.
Step 3
Verify that both processor cards in the BPX node are upgraded to 9.3.30 version by entering the
dspcd 7 and dspcd 8 commands to verify that the SWSW version displayed is 9.3.30.
Step 4
In Cisco WAN Manager, use the Network Browser and CiscoView applications to confirm that the upgraded version of system software (9.3.30) displays the installation correctly on both of the processor cards.
Gracefully Upgrading the Rest of the Cards on the BPX Node
Perform the following steps to upgrade gracefully the remaining cards on a BPX node
Step 1
Verify that the BPX node is upgraded to 9.3.30 and is free from alarms by entering the dspcds command.
The SWSW version displayed should be 9.3.30 and all the cards in the network should not display any alarms.
Step 2
In Cisco WAN Manager, use the Network Browser and CiscoView applications to confirm that the upgraded version of system software (9.3.30) displays as having been installed correctly on all cards in the network.
Step 3
Enter the dspalms and dspnodes commands to verify that there are no network alarms.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the dspalms and dspnodes commands.
Step 4
Verify, using the Topology application and the Network Browser application, that there are no network alarms.
Refer to Chapter 5, Network Browser, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Network Browser GUI. Refer to Chapter 3, Topology Manager, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Topology application.
Step 5
Enter the dspcons, dspcons -fail, dspcons -abit, and dspcons -oam commands to verify that none of the existing complete connections is in failed state, and there are no A-bit or OAM alarms. All incomplete and failed connections are in failed state.
The user can also verify the same information using the Connection Manager GUI, and/or the user_connection and atm_connection tables that none of the existing complete connections is in failed state, and there are no A-bit or OAM alarms. All incomplete and failed connections are in failed state.
Step 6
Enter the dspports command to verify that all the ports are free of alarms. Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the dspports command.
The user can also verify the same information using the Connection Manager and the Network Browser application, that the ports are free of alarms.
Refer to Chapter 5, Network Browser, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Network Browser GUI and to Chapter 3, Connection Manager, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Connection Manager GUI.
Step 7
Enter the dsptrks and dsplns commands to verify that all the trunks and lines are free of alarms.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the dsptrks and dsplns commands.
Step 8
Verify, using the Topology application and the Network Browser application, that the trunks and lines are free of alarms.
Refer to Chapter 5, Network Browser, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Network Browser GUI and to Chapter 3, Topology Manager, in the Cisco WAN Manager User's Guide, Release 11 for detailed instructions on using the Topology application.
Step 9
Enter the tstdelay command to verify data continuity on the complete end to end Automatic Routing Management PVCs.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the tstdelay command. All incomplete and failed connections are in failed state.
Step 10
Enter the tstconseg command to verify data continuity on all connections initiated to the CPE.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for syntax and a detailed description of the tstconseg command. All incomplete and failed connections are in failed state.
Upgrading Existing Switch Software to 9.3.30
This section describes the process of upgrading to the appropriate Release of switch software to migrate from Automatic Routing Management to PNNI. To begin the software upgrade procedure, enter the loadrev command. The node will search for the specified software revision from a Cisco WAN Manager workstation, a PC running StrataView Lite, or from another node. Once the node finds a download source, the flash EEPROM on the active processor card will erase. The flash EEPROM will then be loaded with the new software using a block file transfer protocol. This process takes approximately one hour using the 19.2 Kbps serial port or 45 minutes via Ethernet.
Much less time is required for downloading from neighbor nodes via network trunks. Output during a download is shown below:
Info NPM [or BCC or NPC] 1 downloading Flash with Revision 9.3.30 17:49:45
Info NPM [or BCC or NPC] 1 downloaded Flash with Revision 9.3.30 18:39:29
Once the flash EEPROM on the active processor card has been loaded, the RAM image on the standby processor card is erased in preparation for the new software image download. Once the RAM is cleared, the new image is downloaded into RAM from the flash EEPROM on the active processor. When the RAM is successfully downloaded, the standby processor restarts with the new software. This example shows the NPM on an IGX; it is equally valid for a BCC on a BPX.
The following lines are typical event log messages resulting from the loadrev command completing the download.
Info NPM 2 Removed 18:39:32
Info NPM 2 Restarted due to a Primary Revision Change 18:39:42
Info Standby NPM [or BCC or NPC] 2 downloading Revision 8.3.20 18:39:48
Info Standby NPM [or BCC or NPC] 2 Update Completed 18:41:11
Info Standby NPM [or BCC or NPC] 2 downloaded Revision 8.3.20 18:52:25
Info NPM 2 Removed 18:52:26
Info NPM 2 Restarted due to a Completed Download 18:52:32
When a new revision of software is loaded into the standby processor card's RAM, the existing database of configuration parameters must be converted to the new structure. When this process is completed, the standby processor card will enter the "Upgraded" state.
Info Standby NPM 2 Update Completed 19:00:52
To run the new software, enter the runrev command. This causes a processor switch-over, so the standby processor that's loaded with the new software version (in RAM) becomes the active processor. The processor with the original software revision enters a "locked" state. The original version of software is maintained in the locked processors' RAM in case a fall-back is necessary. The node operates in a non-redundant mode until the "locked" processor is upgraded to the new software revision.
Info NPM 1 Revision Installation - switched to NPM 2 19:40:09
Info Standby NPM 1 downloaded Revision 9.2.34 19:40:09
Info Standby NPM 1 Update Completed 19:40:18
When the new software revision is verified to be operating correctly, the "locked" processor must be updated with the new software. Enter another loaders command to purge the original software version. The "locked" processor restarts and loads RAM with the new software image from flash EEPROM.
Finally, both processor cards are loaded with the new software.
Info NPM 2 downloading Flash with Revision 8.3.20 19:41:57
Info Standby NPM 1 Update Completed 19:42:54
Info NPM 1 Removed 19:42:55
Info NPM 1 Restarted due to a Completed Download 19:43:04
Info NPM 2 downloaded Flash with Revision 8.3.20 19:44:23
Info Standby NPM 1 Update Completed 19:52:05
Upgrading the MGX 8850 from Release 2 to Release 2.1 Software
Refer to Appendix A, "Downloading and Installing Software Upgrades" of the Cisco MGX 8850 and Cisco MGX 8950 Routing Switch Software Configuration Guide, Release 2.1. This appendix describes how to locate, download, and install software updates for the switch. Because software updates are stored in the switch file system, it also includes a section on browsing the file system. This appendix includes the following sections:
•
Upgrade Process Overview
•
Quickstart Procedures for Software Upgrades
•
Quickstart Procedures for Software Downgrades
•
Browsing the File System
•
Locating Software Updates
•
Copying Software Files to the Switch
•
Upgrade Procedures for PXM45 and AXSM Cards
•
Upgrade Procedures for RPM-PR Cards
•
Troubleshooting Upgrade Problems
XPVC Creation Overview
Note that in the following sections, mention of Extended Permanent Virtual Circuit (XPVC) also implies Extended Permanent Virtual Path (XPVP), unless the section says explicitly that one or the other is not applicable.
Step 1
Use the switch CLI to configure XLMI and ENNI on BPX and MGX ports
Extended Local Management Interface protocol (XLMI), in conjunction with the LMI Neighbor Discovery feature, enables the exchange of connection status and topology information between the BPX and MGX switches.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for command syntax and a detailed description of the process of configuring BPX ports to support XLMI. Refer to the Update to the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.1 for command syntax and a detailed description of the process of configuring Cisco MGX 8850 Release 2.1 ports to support XLMI.
Enhanced (or Friendly) Network-to-Network Interface (ENNI) links individual networks of Cisco Automatic Routing Management switches to individual networks of PNNI switches. When a port is configured to ENNI, all new SPVC/SPVPs added to that port will have the OAM segment configured as non-segment.
Note
If there are already existing connections on a port, you cannot configure the port from UNI or NNI to EUNI or ENNI, or vice versa. You must delete all existing connections on a port before configuring the port to ENNI or EUNI.
In a regular connection, links joining two network domains serve as segment endpoints for OAM (segment) loopback. In order for all OAM cell types to traverse end-to-end without being looped back or terminated at the ingress of the intermediate links, XPVCs and XPVPs are provisioned across ENNI networks to allow segment OAM cells to flow over end-to-end OAM segment loops for the provisioned length of the XPVC or XPVP.
Refer to the Cisco WAN Switching Command Reference, Release 9.3.30 for command syntax and a detailed description of the process of configuring BPX ports to support ENNI. Refer to the Update to the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.1 for command syntax and a detailed description of the process of configuring Cisco MGX 8850 Release 2.1 ports to support ENNI.
Step 2
Use the Network Browser and Topology Map to display XLMI link status.
Figure 11-1 below shows the popup menu item that appears when you right-click on an XLMI link.
Figure 11-1 Display XLMI Trunk Popup
The display that opens after selecting the Display Trunk popup is shown in Figure 11-2.
Figure 11-2 XLMI Trunks Display
You can also verify the status of the ENNI ports in the Network Browser application, as shown in Figure 11-3.
Figure 11-3 Verifying ENNI Ports in the Network Browser
For more information on the Network Browser application and its use, see Chapter 5, "Network Browser" of the Cisco WAN Manager User's Guide, Release 11.
Step 3
Manually define the AR-PNNI interface(s). Use the XPVC Preferred Flag checkbox within the XPVC Preferred Table Configurator application in Cisco WAN Manager.) Define whether the selected BPX node should use a particular preferred node when setting up an XPVC connection.
For an example of the Preferred Table Configurator application, refer to Chapter 3 of the Cisco WAN Manager User's Guide, Release 11.
Note
Connection Manager is display-only for XPVCs.
Step 4
Evaluate the status of your XPVC using the end-to-end test delay diagnostic. See Figure 11-12 through Figure 11-14 in this chapter for examples of this diagnostic tool.
The above list summarizes the steps required to create and verify an XPVC using CWM Release 11.
XPVC as a Migration Connection
An XPVC is an end-to-end virtual circuit that traverses at least one UNI or NNI interface on which XLMI has been enabled. The XPVC, which is shown in the following graphic, Figure 11-4, provides the first step towards migration from an existing proprietary Automatic Routing Management infrastructure toward standards-based PNNI by encompassing networks with both Automatic Routing Management and PNNI routing nodes.
Figure 11-4 Migration Connection Example
There are two basic types of XPVC that you can create using Cisco WAN Manager 11:
•
AR-PNNI-AR—The XPVC originates and terminates at endpoints on an Automatic Routing Management BPX switch or MGX feeder node attached to a BPX switch. This is a three-segment (PVC to SPVC to PVC) XPVC.
•
AR-PNNI—The XPVC originates at an Automatic Routing Management switch or feeder endpoint, and terminates at a PNNI endpoint on an Cisco MGX 8850 switch (or vice versa). This is a two-segment (PVC to SPVC) XPVC.
Each XPVC segment consists of an actual virtual circuit, that is a PVC, an SPVC, or a Hybrid (feeder) VC. Each of these circuits could, in turn, comprise more than one segment if feeders are included. Cisco WAN Manager software ties together these circuits to create an end-to-end XPVC. XPVC provisioning is supported across a maximum of three networks.
In earlier Releases, you could construct circuits across multiple networks that were connected with NNI interfaces. However, the NNI interface loops back the management messages (OAM segment cells) so that end-to-end management of the circuit is not possible. This problem is resolved with the proprietary ENNI interface that is supported on BXM cards in the Cisco BPX switch and on the AXSM and PXM45 cards in the MGX 8850 switches.
1.
XLMI enables neighbor discovery between Automatic Routing Management and PNNI domains
2.
ENNI enables end-to-end OAM cell flow, which provides end-to-end management
XPVC/XPVP Provisioning and Management
There are two ways to provision an XPVC using Cisco WAN Manager Release 11:
1.
Using a special script (CWM-XPVC-CLI), from the Unix CLI prompt
2.
Using the SNMP Service Agent
You can provision end-to-end XPVCs using either a script that is manually invoked from the Cisco WAN Manager Unix command line (the CWM-XPVC-CLI) or programmatically via the SNMP interface of the Service Agent. Note that the CWM-XPVC-CLI supports addition and deletion only, whereas you can also modify an existing XPVC using the Service Agent.
Before creating an XPVC you must configure the BPX and MGX ports that connect the Automatic Routing Management and PNNI networks to support XLMI and ENNI. This can be done by using the switch CLI. Once you have done this, you will be able to verify the successful activation and discovery of the XLMI links through the Network Browser and by inspection of the Topology Map.
Although Cisco WAN Manager is able to automatically discover the XLMI links, you must define manually how each BPX node, including those that are not directly attached to an MGX PNNI port, reaches the PNNI network. The XPVC Preferred Table Configurator application defines the XLMI interface that XPVCs from a particular BPX switch must use to reach the PNNI network. The Configurator also includes an XPVC Preferred Flag, which you must enable on a node-basis to enable XPVC routing between two BPX nodes. Details of the Configurator are included later in this chapter.
Once you have created the XPVC using the CWM-XPVC-CLI, you can use the Connection Manager to display status information and also to perform an end-to-end test that will provide the round-trip delay on a selected connection. End-to-end test delay is also available through the SNMP service agent.
Table 11-1 Supported Connections for XPVCs
End Point Type
|
XPVC type
|
ATM-ATM
|
FR-FR
|
ATM-FR
|
BPX Feeder to BPX Feeder
|
AR-PNNI-AR
|
Y
|
Y
|
Y
|
BPX Feeder to MGX R2 Feeder
|
AR-PNNI (Hybrid)
|
Y
|
Y
|
Y
|
BPX to BPX
|
AR-PNNI-AR
|
Y
|
—
|
—
|
BPX to MGX 8850
|
AR-PNNI
|
Y
|
—
|
—
|
BPX to BPX Feeder
|
AR-PNNI-AR
|
Y
|
—
|
Y
|
BPX to MGX R2 Feeder
|
AR-PNNI (Hybrid)
|
Y
|
—
|
Y
|
BPX Feeder to MGX 8850
|
AR-PNNI
|
Y
|
—
|
Y
|
Supported cards: BXM, ASI, AUSM, FRSM, RPM/RPM-PR, ATM = ATM or RPM endpoint
BPX feeder or MGX R2 feeder = Cisco MGX 8220, Cisco MGX 8230, Cisco MGX 8250,
Cisco MGX 8850 Release 1
The above table summarizes the endpoint and XPVC connection types that are supported in Cisco WAN Manager 11. Associated with each connection type are specifically supported service types. Refer to the Cisco WAN Manager 11 Release Notes for a complete mapping of the specific connection and service types supported.
Note
Not all service modules are supported for XPVC user endpoints in Cisco WAN Manager Release 11. Specifically, the CESM and VISM cards are not included.
Connection Creation for XPVC/XPVPs
The following steps summarize the process for creating and verifying an XPVC or XPVP.
Creating an XPVC
Step 1
Using the applicable switch CLI, do the following action
•
Configure, activate and verify the XPVC endpoints (lines, ports)
–
Activate XLMI on the BXM and AXSM ports
–
Activate ENNI on the XLMI links
Step 2
Verify that the XLMI links are displayed on the Topology Map.
Step 3
Use the Cisco WAN Manager XPVC Preferred Table Configurator to associate BXM ports with MGX PNNI ports
Step 4
If your connections are using non-default parameters, modify the appropriate parameter file.
Step 5
Add the connection using the cwmAddConn script.
Step 6
Launch the Connection Manager GUI.
Step 7
Select Nod, > View > XPVC Segments.
Step 8
Test connection end-to-end round-trip delay.
XPVC Preferred Table Configurator
The XPVC Preferred Table Configurator is a Cisco WAN Manager application that allows you to define the mapping between XLMI/ENNI ports on BPX nodes and the corresponding AXSM ports in the PNNI network. The overall function of the XPVC Preferred Table Configurator is described in Chapter 3, "Using Network Topology" in the Cisco WAN Manager User's Guide, Release 11.
CWM-XPVC-CLI
This section highlights the main features of the CWM-XPVC-CLI. These features are as follows.
•
HP OpenView and Cisco WAN Manager Service Agent are required
•
Cisco WAN Manager Release 11 uses an SNMP script that invokes the Service Agent ConnProxy
•
Two new commands (formed from Unix shell scripts)
–
cwmAddConn to add an XPVC
–
cwmDelConn to delete an XPVC
•
Four optional parameter files are used for non-default settings:
a.
atmendpt.conf for ATM endpoint
b.
frendpt.conf for Frame Relay endpoint
c.
rpmendpt.conf for RPM endpoint
d.
connparam.conf for connection parameters
The CLI is invoked from the Unix command line, and in turn invokes the ConnProxy process in the Cisco WAN Manager Service Agent. The Service Agent must have been previously installed on the Cisco WAN Manager workstation. Also, HP OpenView must be installed and running since the CLI uses the SNMP command tools included with OpenView.
The CLI supports the addition and deletion of XPVCs, but not modification. If you need to modify an XPVC, you must first delete it then add it again with the new parameters.
In addition to the add and delete scripts, Cisco WAN Manager provides several parameter files. These files are sample templates that you can modify if the default parameters are not appropriate. The parameter files are of two basic types:
1.
Endpoint Parameters—Files are included for Frame Relay, ATM and RPM endpoints. For example, you can create a new ATM Endpoint file and define values for parameters such as the ingress policing for the connection.
2.
Connection Parameters—You can use the standard file as a template for a new file with non-default connection-specific parameters, such as trunk avoidance.
The shell scripts and the parameter files are stored in the /usr/users/svplus/tools directory.
Adding an XPVC
The following example shows how the syntax for the cwmAddConn command is used to create an XPVC. This command and its associated parameters are entered at the Unix command line by an authorized Cisco WAN Manager user. Mandatory parameters are shown like this <cwmHost>, and optional parameters as shown inside brackets, for example: [-tout ...].
Example (Add an XPVC Syntax)
[-desc \"<ConnectionDescriptor>\"]
[-lfile <LocalEndpointParameterFile>]
[-rfile <RemoteEndpointParameterFile>]
[-cfile <ConnectionParameterFile>]
The mandatory parameters for cwmAddConn are shown in Table 11-2.
Table 11-2 Mandatory Parameters
Parameter
|
Description
|
cwmHost
|
The name of the Unix host on which Cisco WAN Manager is running
|
snmpCommunity
|
SNMP Community String to access Cisco WAN Manager SNMP Agent. The default string is "private", but it can be changed by editing the file /usr/users/svplus/config/SNMPProxy.conf.
|
localEndpoint
|
The local endpoint, defined as <RoutingNodename.FeederName.Slot.Line.Port.Vpi|Dlci[.Vci]>.
Examples of the endpoint syntax are as follows:
• An ATM VC originating on a BPX port: bpx01..4..1.20.250. Note that where a term is not required it is omitted, as is the following case where there is no FeederName or Line. Port equates to line in the case of the BPX node, since virtual ports are not supported with XPVCs.
• An ATM VP originating on a BPX port: bpx01..4..1.20.
• A VC originating on an RPM in an MGX feeder node: bpx02.mgx02.10..1.0.250
• A VP originating on an RPM in an MGX feeder node: bpx02.mgx02.10..1.30.
• A Frame Relay connection originating on a FRSM port in an MGX feeder node: bpx03.mgx01.5.2.5.300
|
localEndpointType
|
fr, atm or rpm
|
remoteEndpoint
|
The local endpoint, defined in the same format as the local endpoint.
|
remoteEndpointType
|
fr, atm or rpm
|
serviceType
|
cbr1, vbr1, vbr2, vbr3, abrfs, frfs, fr, ubr1, ubr2, abr1, rtvbr1, rtvbr2 or rtvbr3
|
Optional parameters are indicated by keywords, and are shown in Table 11-3
Table 11-3 Optional Parameters
Parameter
|
Description
|
help
|
Outputs the help text with the command syntax.
|
tout <TimeOut>
|
Defines the time out period in seconds before the system abandons the connection attempt.
|
vc <VCType>
|
Defines the type of connection to be created. Choices are pvc, spvc, hybrid, or xpvc. You can use this parameter to override the standard Cisco WAN Manager provisioning rules. For example, if you want a connection between two BPX nodes that both have the XPVC Preferred Flag enabled to be routed as an Automatic Routing Management PVC,rather than as an XPVC, set the VCtype to pvc.
|
desc \"ConnectionDescriptor"\
|
Defines a Connection Descriptor string that must be entered inside double quotes.
|
lfile <LocalEndpointParameterFile>
|
Defines the path to a user-created file for local endpoint parameters.
|
rfile <RemoteEndpointParameterFile>
|
Defines the path to a user-created file for remote endpoint parameters.
|
cfile <ConnectionParameterFile>
|
Defines the path to a user-created file for connection parameters.
|

Note
Endpoint parameter files for an RPM must contain the correct MGX node User ID and password, and the RPM password.
The following example shows a cwmAddConn command for creating an XPVC. In this example, the local endpoint is an ATM port on a BPX node, bpx1. The port is slot 4, port 1 and the VPI.VCI is 20.356. The remote endpoint is on port1, line 2 of the FRSM card in slot 6 of the feeder node mgx08 attached to bpx6. The circuit has the DLCI 356.
private \ <snmpCommunity>
bpx1..4..1.20.356 \ <localEndpoint>
atm \ <localEndpointType>
bpx6.mgx08.6.2.1.356 \ <remoteEndpoint>
fr \ <RemoteEndpointType>
-desc "ATFR bpx1-mgx08" \
-cfile /usr/users/ATFR_parms1
Note that each parameter in the command is entered on a separate line, and that each line except the last is terminated by " \" (space backslash).
This example also includes a user-created connection parameter file (AFR_parms1) that includes one or non-default settings.
%cd /usr/users/svplus/config
%cp connfparm.conf /usr/users/ATFR_parms1
%vi /usr/users/ATFR_parms1
svConnOvrSubOvrRide 2 # enable oversub on FRSM
svConnTrkAvoidType 2 # avoid satellite trunks
Note
Obtain parameter values from the Service MIB for supported parameters.
You will need to verify the allowable values for the parameters you wish to modify. The Service MIB is stored in /usr/users/svplus/mibs/SV+Service.mib, and can be viewed from the Unix command line. Alternatively, refer to the Cisco WAN Manager SNMP Service Agent Release 11.
-cfile /usr/users/ATFR_parms1
Deleting an XPVC
The syntax for the cwmDelConn command is shown in the following example.
Example (Delete an XPVC Command Syntax)
Example 1
[-lfile <LocalEndpointParameterFile>]
[-rfile <RemoteEndpointParameterFile>]
The following is an example of the cwmDelConn command that is used to delete an XPVC with RPM endpoints.
Example 2
private \ <snmpCommunity>
bpx2.mgx02.9..1.0.250 \ <anyEndpoint>*
-lfile /usr/users/RPM/passwds **
Note
anyEndpoint can either be local or remote; the EndpointType must match
Note
The passwds parameter file must contain the user name and passwords for the RPM
When deleting an XPVC, you provide either the local or the remote endpoint.
The endpoint type must be appropriate for the endpoint that you select.
Parameters that differ from those for cwmAddConn are shown in Table 11-4.
Table 11-4 Parameters differing from those in cwmAddConn
Parameter
|
Description
|
anyEndpoint
|
The local or remote endpoint. If one of the endpoints is an RPM, this must be the RPM8,and both the -lfile and -rfile parameters must be defined.
|
EndpointType
|
fr, atm, or rpm, corresponding to the selected endpoint
|
-rend <remoteEndpoint>
|
For an RPM endpoint, this is the remote endpoint.If you define this optional parameter, then anyEndpoint must refer to the local endpoint.
|
-lfile <LocalEndpointParameterFile>
|
Defines the path to a user-created file for local endpoint parameters. This is only required for an RPM endpoint.
|
-rfile <RemoteEndpointParameterFile>
|
Defines the path to a user-created file for remote endpoint parameters. This is only required for an RPM endpoint.
|
Note
Endpoint parameter files for an RPM must contain the correct MGX node User ID and password, and the RPM password.
Connection Manager Support for XPVCs
The Connection Manager in Cisco WAN Manager Release 11 provides support for XPVCs. Supported features include the following:
•
Filter on XPVCs and dangling segments. A dangling segment is an XPVC segment that has been discovered by Cisco WAN Manager but which is not part of an end-to-end XPVC.
•
View the parameters for XPVCs and individual XPVC segments
•
Monitor alarm status for an XPVC or an individual XPVC segment
•
Deletion of dangling segments
•
End-to-end test delay
XPVC Provisioning via Service Agent
This section provides procedures for provisioning XPVC connections via the Service Agent.
For a XLMI Configuration
SET svAtmPortSignallingProtocol in svATMPortTable to XLMI for NNI port.
For a ENNI Configuration
SET svATMPortType in svATMPortTable to ENNI or EUNI.
For Adding an XPVC Connection
SET endpoints and parameters in End Point Tables. rpmEndPointTable, atmEndPointTable, frEndPointTable are applicable.
SET svConnRowStatus in svConnTable to create (4).
SET svConnProtocolType to xpvc for XPVC connection.
An XPVC connection can be added using the CWM-XPVC-CLI without specifying the VC type or using the Service MIB without specifying the svConnProtocolType.
The ConnProxy will determine the correct protocol type (PVC/SPVC/HYBRID/XPVC) based on the endpoints chosen and the contents of the xpvc_preferred table.
The protocol type will be automatically chosen as XPVC provided all user endpoints chosen in the Automatic Routing network have a xpvc_preferred table entry with the preferred flag set.
For Deleting an XPVC Connection
SET svConnRowStatus for XPVC deletion.
For Modifying an XPVC Connection
SET endpoints and parameters in End Point Tables and svConnTable (except CC related objects).
SET cwmConnPrefRoute for PVC segment of the XPVC in cwmConnTable.
Location of ConnProxy Scripts
Scripts can be found in /usr/users/svplus/scripts/proxyscripts/connproxy. The following scripts are provided:
•
AddConn
•
DelConn
•
FaultIsolation
•
GetAnyConn
•
GetConErr
•
Get ConnDetails
•
GetConnIndex
•
ModConn
•
TestConnDelay
Adding an XPVC Connection: AddConn script
AddConn <proxyHost> <localType> <localNode> <localChan> <remoteType> <remoteNode> <remoteChan> <conSubType> <totalNumberOfConnections> <numberOfSimultaneousRequests> <local_parameter_set | -> <remote_parameter_set | -> <connection type>
When configuring the parameters, the user should observe the following rules.
•
localType or remoteType can be one of atm, ce, fr, voice, data, or rpm
Note
XPVCs localType or remoteType cannot be set to "ce" (circuit emulation)
•
connSubType can be one of cbr1, vbr1, vbr2, vbr3, abr-fs, fr-fs, fr, ubr1, ubr2, abr1, atfst, atfxfst, atftfst, voice, or data
•
local_parameter_set or remote_parameter_set are names of the parameter files. Use "-" to take default values.
•
connection type can be pvc, spvc, hybrid or xpvc. Use "-" to take default values.
•
For ATM/VISM/RPM connection types, localChan or remoteChan should be given as "slot.port.vpi.vci" (for rpm connections port is the sub-interface number on switch + 1) (for rpm VC connections vpi is always 0).
•
For FR connection type, localChan or remoteChan should be given as slot.line.port.dlci (for fr connections port is the l_port field in frp table for example., start ds0 number on switch)"
•
For CE connection type, localChan or remoteChan should be given as slot.line.port (for CE connections port is the physical port number. It is the same as the l_port in frp table and is the starting DS0 time slot number. It is not the logical_port, which is the port number given in CLI)
Features
The script allows bulk provisioning by incrementing the VCI or the DLCI based on the value given for the input parameter "totalNumberOfConnections." The script also allows simultaneous provisioning based on the value given for the input parameter "numberOfSimultaneousRequests".
Example Parameter Files
Filename: /tmp/parmfile (atm connection)
atmEndPointSCRZeroPlus1 87
atmEndPointPCRZeroPlus1 297
Filename: /tmp/parmfile (rpm connection on MGX8850 R1)
rpmEndPointNodeUser cisco
rpmEndPointNodePasswd cisco
Filename: /tmp/parmfile (fr connection)
Example AddConn Commands:
AddConn host1 atm igx1 5.2.1.1 atm bpx1 2.2.1.1 vbr2 2000 8 - - -
AddConn host1 fr pop1 2.0.1.1 atm pop2 3.1.10.10 abr-fs 1023 5 - - hybrid
Logs
AddConn.time.log in the $TMP_DIR contains the time log of all the connection additions using AddConn. $TMP_DIR/AddConn.<localChan>_<remoteChan>.out will be created for all the failure cases (For example, /tmp/AddConn.2.2.1.11_2.2.2.11.out).
Sample Output
In the following example, 3 connections are added with 2 simultaneous requests. The third connection addition fails, since the end-point is already in use.
AddConn cwmult60 atm nmsbpx16 2.2.1.9 atm nmsbpx16 2.2.2.9 vbr2 3 2 - - pvc
nmsbpx16 [2.2.1.9] [atm] <--- [vbr2] - [pvc] ---> [atm] [2.2.2.9] nmsbpx16
+ /opt/OV/bin/snmpset -d -t 3000 -p 8161 -c private -r 0 cwmult60
atmEndPointRowStatus.8.110.109.115.98.112.120.49.54.0.2.2.1.9 integer 4
atmEndPointRowStatus.8.110.109.115.98.112.120.49.54.0.2.2.2.9 integer 4 svConnLocalEndPt.0
objectidentifier atmEndPointNodeName.8.110.109.115.98.112.120.49.54.0.2.2.1.9
svConnRemoteEndPt.0 objectidentifier
atmEndPointNodeName.8.110.109.115.98.112.120.49.54.0.2.2.2.9 svConnSubType.0 integer 3
svConnRowStatus.0 integer 4 svConnOvrSubOvrRide.0 integer 2 svConnProtocolType.0 integer 1
+ 1>> /tmp/AddConn.2.2.1.9_2.2.2.9.out 2>& 1
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
nmsbpx16 [2.2.1.10] [atm] <--- [vbr2] - [pvc] ---> [atm] [2.2.2.10] nmsbpx16
+ /opt/OV/bin/snmpset -d -t 3000 -p 8161 -c private -r 0 cwmult60
atmEndPointRowStatus.8.110.109.115.98.112.120.49.54.0.2.2.1.10 integer 4
atmEndPointRowStatus.8.110.109.115.98.112.120.49.54.0.2.2.2.10 integer 4
svConnLocalEndPt.0 objectidentifier
atmEndPointNodeName.8.110.109.115.98.112.120.49.54.0.2.2.1.10 svConnRemoteEndPt.0
objectidentifier atmEndPointNodeName.8.110.109.115.98.112.120.49.54.0.2.2.2.10
svConnSubType.0 integer 3 svConnRowStatus.0 integer 4 svConnOvrSubOvrRide.0 integer 2
svConnProtocolType.0 integer 1
+ 1>> /tmp/AddConn.2.2.1.10_2.2.2.10.out 2>& 1
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
nmsbpx16 [2.2.1.9] [atm] <--- [vbr2] - [pvc] ---> [atm] [2.2.2.9] nmsbpx16
Connection index of the connection given above: 2681
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
nmsbpx16 [2.2.1.10] [atm] <--- [vbr2] - [pvc] ---> [atm] [2.2.2.10] nmsbpx16
Connection index of the connection given above: 2682
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Time elapsed to add 2 connection[s] in this loop : 4
Total connections added till now : 2
Total number of errors seen till now : 0
Total time taken till now : 4
Average time to add a connection till now : 2.00
================================================================================
nmsbpx16 [2.2.1.11] [atm] <--- [vbr2] - [pvc] ---> [atm] [2.2.2.11] nmsbpx16
+ /opt/OV/bin/snmpset -d -t 3000 -p 8161 -c private -r 0 cwmult60
atmEndPointRowStatus.8.110.109.115.98.112.120.49.54.0.2.2.1.11 integer 4
atmEndPointRowStatus.8.110.109.115.98.112.120.49.54.0.2.2.2.11 integer 4
svConnLocalEndPt.0 objectidentifier
atmEndPointNodeName.8.110.109.115.98.112.120.49.54.0.2.2.1.11 svConnRemoteEndPt.0
objectidentifier atmEndPointNodeName.8.110.109.115.98.112.120.49.54.0.2.2.2.11
svConnSubType.0 integer 3 svConnRowStatus.0 integer 4 svConnOvrSubOvrRide.0 integer 2
svConnProtocolType.0 integer 1
+ 1>> /tmp/AddConn.2.2.1.11_2.2.2.11.out 2>& 1
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
nmsbpx16 [2.2.1.11] [atm] <--- [vbr2] - [pvc] ---> [atm] [2.2.2.11] nmsbpx16
Log file : /tmp/AddConn.2.2.1.11_2.2.2.11.out
stratacom.svplus.serviceGroup.connGroup.svCmpaErrorTable.svCmpaErrorEntry.svCmpaErrorReqId
.12469 : INTEGER: 12469
stratacom.svplus.serviceGroup.connGroup.svCmpaErrorTable.svCmpaErrorEntry.svCmpaErrorDesc.
12469 : DISPLAY STRING- (ascii): [08/14/2001 14:52:23] EndPoint already in use:
0.2.2.1.11
stratacom.svplus.serviceGroup.connGroup.svCmpaErrorTable.svCmpaErrorEntry.svCmpaErrorEcode
.12469 : INTEGER: endpt-exists
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Time elapsed to add 1 connection[s] in this loop : 0
Total connections added till now : 2
Total number of errors seen till now : 1
Total time taken till now : 4
Average time to add a connection till now : 1.33
================================================================================
********************************************************************************
TOTAL NUMBER OF CONNECTIONS ADDED : 2
TOTAL NUMBER OF CONNECTION ADDITIONS FAILED : 1
TOTAL TIME TAKEN TO ADD ALL THE CONNECTIONS : 4
APPROXIMATE AVERAGE TIME TAKEN TO ADD A CONNECTION : 1.33
********************************************************************************
Deleting an XPVC Connection: DelConn script
Use the delComm command to delete an XPVC connection.
DelConn <proxyHost> <Type> <Node> <Chan> <totalNumberOfConnections>
<numberOfSimultaneousRequests> <local_parameter_set | -> <remote_parameter_set | ->
<connection type>
When configuring the parameters, the user should observe the following rules.
•
Type can be one of atm, ce, fr, voice, data, or rpm
•
local_parameter_set or remote_parameter_set are names of the parameter files. Use "-" to take default values.
•
connection type can be pvc, spvc, hybrid, or xpvc. Use "-" to take default values.
•
For ATM/VISM/RPM connection types, Chan should be given asslot.port.vpi.vci (for RPM connections port is the sub-interface number on switch + 1) (for RPM VC connections the VPI is always 0).
•
For FR connection type, Chan should be given as slot.line.port.dlci (for FR connections the port is the l_port field in the frp table for example, the starting ds0 DS0 time slot number on the switch)
•
For CE connection type, Chan should be given as "slot.line.port" for CE connections port is the physical port number. It is the same as the l_port in frp table and is the starting DS0 time slot number. It is not the logical_port, which is the port number given in CLI). Note that the CE connection type is not supported for XPVCs.
Example
DelConn cwmult65 atm igx1 5.2.1.1 100 5 - -
Fault Segment Isolation: FaultIsolation script
FaultIsolation <cwmHost> <connIndex> <xpvcSegmentNumber>
where
The connIndex parameter is the xpvc_id in the XPVC table if the connection is an XPVC or the snmp_index in the user_connection table if the connection is either a PVC, an SPVC, or a hybrid connection.
Note
The connIndex can be retrieved using the GetConnIndex script.
The xpvcSegmentNumber can be 1, 2, or 3. The numbering starts from the local end of the connection. This number should not exceed the number of segments in the specified connection, of course. You should not try to test for faults on segment 3 of a two segment connection.
Note
This script can be used only on XPVCs to run test delay on each XPVC segment
Example
FaultIsolation cwmult65 1000000015 1
Check for faults on the first segment of the connection with the index of 1000000015
Get Any Connection: GetAnyConn script
GetAnyConn <Host> <connIndex> <local_parameter_set | -> <remote_parameter_set | ->
•
local_parameter_set or remote_parameter_set are the names of the parameter files. Use "-" to take default values.
Example:
GetAnyConn cwmult65 1000000015 - -
Get Connection Errors: GetConErr script
GetConErr <Host> <"Request ids">
•
endptType can be one of the following types atm, ce, fr, voice, data, rpm
Note
The CE connection type is not supported for XPVCs.
Get Connection Details: GetConnDetails script
GetConnDetails <Host> <Options> <ConnIndex>
•
Options can be one of the following:
-l : Get local endPt.
-r : Get remote endPt.
-c : Get connection parameters
-a : Get all
Get Connection Index: GetConnIndex script
GetConnIndex <Host> <endptType> <Node[.Shelf]> <ChanInfo>
•
endptType can be one of the following types atm, ce, fr, voice, data, rpm
Note
The CE connection type is not supported for XPVCs.
Modifying an XPVC Connection: ModConn script
ModConn <proxyHost> <localType> <localNode> <localChan> <totalNumberOfConnections>
<numberOfSimultaneousRequests> <local_parameter_set | -><remote_parameter_set | ->
•
localType can be one of the following types atm, ce, fr, voice, data, rpm
•
The CE connection type is not supported for XPVCs.
•
local_parameter_set or remote_parameter_set are the names of the parameter files. Use "-" if you do not want to specify any parameters
Example
ModConn cwmult65 atm igx1 5.2.1.1 100 10 - -"
Give the local endpoint type, node and channel information, not the remote endpoint information
End to End Test Connection or Test Delay: TestConnDelay script
Use the TestConnDelay to execute and end-to-end connection.
TestConnDelay <ProxyHost> <ConnIndex> <1 for TestConn, 2 for TestDelay>
Example
TestConnDelay cwmult65 1000000015 1
Execute an end to end Test Connection on the connection with the index of 1000000015
Trap support for XPVCs
The following existing traps support XPVCs
•
cwmUserConnComplete, #25113
•
Sent to user when an incomplete XPVC connection becomes complete.
•
cwmUserConnIncomplete, #25114
•
Sent to user when a complete connection goes into incomplete state.
•
cwmUserConnectionCleared, #25116
•
Sent to user when there is a change in the alarm status of a XPVC connection and the end to end XPVC connection status is OK.
•
cwmUserConnectionFailed, #25117
Sent to user when there is a change in the alarm status of a XPVC connection and the end to end XPVC connection status is failed.
•
cwmUserConnectionDown, #25118
Sent to user when the entire XPVC connection or at least one segment of the XPVC connection is downed.
The following new traps support XPVC management:
•
cwmTrapConnAdded, #25210
End-To-End Connection described by the above endpoints is added. This trap is generated when a new End-To-End connection is added from any Connection Manager interface (GUI or Service Agent). A connection alarm status trap is also generated along with this. Currently this TRAP is generated for XPVC connections only.
•
cwmTrapConnDeleted, #25211
End-To-End Connection described by the above endpoints is deleted. This trap is generated when a connection is deleted from any Connection Manager interface (GUI or Service Agent). Currently this TRAP is generated for XPVC connections only.
•
cwmTrapConnDescModified, #25212
Connection Descriptor for the End-To-End connection is modified. Currently this TRAP is generated for XPVC connections only.
Displaying XPVC Status
To view XPVC status within the Connection Manager, edit the filter settings to set the end to end Type to XPVC, and select Apply. You will then see a display similar to that shown in Figure 11-5 and/or Figure 11-6 below.
Figure 11-5 XPVC Display at Opening
Figure 11-6 XPVC Display Expanded
With Release 11 you can also view additional information relating to the individual XPVC segments. After highlighting to select an XPVC in the Main Window, activate the Segment View GUI by selecting