cc/td/doc/product/wanbu/vns/vns_30
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Understanding the VNS
Configuration Interface

Understanding the VNS
Configuration Interface

This chapter provides a description of VNS Configuration Interface, which is used to view, configure, and provision the Voice Network Switching application through a series of inter-linked menus. This chapter concentrates on providing a description of these menus and their respective fields, including the parameters that are entered in them. Chapter 8 provides instructions for using the VNS Configuration Interface to configure a VNS and VNS WAN switching network.

This chapter contains the following sections:

Accessing the VNS Configuration Interface

To access the VNS Configuration Interface, follow these steps:

Step 1 Log in to the VNS through either a telnet session or from a terminal directly connected to the VNS. (Chapter 6 provides instructions for connecting a terminal. You can also telnet from StrataView Plus Workstation.)

Step 2 Log in as root and enter the password (if applicable) that you normally use in your UNIX environment.

Step 3 Type vnscli (lower case) at the prompt and press Enter. The VNS Configuration Interface main menu, shown in the following example, appears:

VNS Configuration Interface Example Main Menu ################################################################################ # # # ciscoSystems/StrataCom V N S # # Configuration Interface, Release 3.0.00 # # # # 1. Add an entry # # # # 2. Delete an entry # # # # 3. Modify an entry # # # # 4. Browse Data Base # # # # 5. Debug Mode # # # # 6. Validate Data Base # # # # 7. Exit the program # # # # Enter your selection: # # # # # # # ?###############################################################################

Using the VNS Configuration Interface

As shown, the VNS Configuration Interface main menu presents 7 options. Each option is indexed by a number. You select one of the options by typing its number and pressing Enter. For instance, to Add an entry, you would type 1 and press Enter. (Throughout the rest of this book, the VNS Configuration Interface main menu will be referred to simply as the VNS main menu.)

The six options are:

    1. Add an entry

    2. Delete an entry

    3. Modify an entry

    4. Browse Data Base

    5. Debug Mode

    6. Validate Data Base

    7. Exit the program

Each option (except no. 7) leads to subsequent menus and screens. Menus normally have a name and a list of fields; screens have similar layouts but they present previously configured information. A saved menu becomes a screen or a VNS record. Each field on a menu is followed by a pair of square brackets, [ ], separated by some blank space. The cursor is positioned between the square brackets which is active for entering information. Many fields accept an index number for the various parameters that can be configured. You move the cursor to the next field by pressing Return. The cursor will skip over read-only fields. The following information line appears at the bottom of most menus:

Enter `c' to commit changes or 'q' to quit [ ]

When using these screens to configure an option, type in the value and press Enter to move the cursor to the next field, the square brackets. When you reach the "Enter `c' to commit...", square brackets, make sure you have entered the desired values in each field, then type c and press Enter to save your changes. When you save your changes, the completed menu becomes a record in the VNS data base. If you do not want to save the values you entered, type q and press Enter. You can re-access the configuration menu from the VNS main menu.

In the Browse Data Base mode, the line at the bottom will read:

Enter `s' to skip record or 'q' to quit [ ]

Entering `s' in the square brackets will bring up the next record of the same type.

Some configuration screens will have additional information fields (i.e., a help line at the bottom of the screen) describing a field's parameters. This information line will change as the cursor is moved from field to field.

To reach any of these screens or menus, follow these steps:

Step 1 From the VNS main menu, enter the index number of desired option.

Step 2 Press Enter, the desired screen or menu will appear.

VNS Configuration Interface Responses

The VNS Configuration Interface communicates with VNS processes using the Simple Network Management Protocol. The responses and error status conform to SNMP standards. The VNS Configuration Interface typically responds to your inputs in three ways:

Response Error: ErrorCode (5), Error Index (1)

Error Messages

Nineteen possible ErrorCodes that could be returned are listed in Table 7-1:


Table 7-1: VNS Configuration Interface Error Codes
Error Code Description

1

Too Big

2

No Such Value

3

Bad Value

4

Read Only

5

General Error

When using the VNS Configuration Interface, the most common error response is:

Response Error: ErrorCode (3), ErrorIndex (3)

This message typically indicates that you entered an unacceptable value in one of the fields of the menu. The ErrorIndex number points to the first field of the menu containing a bad value. For instance Error Index (1) is the first field on the menu. (Hitting the enter or tab key will step you through the various fields of a menu in their indexed sequence.) When you see this message, you should closely look over all the fields for which you entered values because there could be more than one mistake.

The other common error response is:

Response Error: ErrorCode (5), ErrorIndex (1)

ErrorCode 5 (General Error) indicates there was a logical error while trying to execute the command. In general, it implies that the operation is not allowed to be performed. The ErrorIndex does not have any meaning in this case.

Table 7-2 at the end of this chapter lists the configuration parameters of each menu, along with the index number associated with that field that is returned with VNS Configuration Interface error messages.

VNS Records

Options 1 through 4 of the VNS main menu will access the VNS Records menu. The VNS Records menu is accessed in four ways:


Note It is good practice to use Browse Data Base after you complete a VNS Configuration Interface menu to recall the record and see if it contains the entered parameters.

Deleting or Modifying Records

When modifying or deleting a VNS record from a batch of records, the VNS Configuration Interface will provide an intermediate menu that will allow you to select the individual record. For instance, it is possible to have a great number of Address records configured in your system. Rather than have to scroll through them to find the record you are seeking, the VNS will provide a menu that allows you to specify the exact record you are seeking. If you selected Delete an entry (6 on the Main Menu), then Address Information (5 on the VNS Records menu), the following menu will appear:

Delete or Modify Menu Example +##############################################################################+ # # # # # # # # # Address [ ] # # Port Descriptor [ ] # # # # Enter the Address and Port Descriptor and press 'd' to # # delete record, 'b' to browse before deleting or 'q' to quit [ ] # # # # # # # # # +###############################################################################

If you knew the Address and Port Descriptor for the record you wanted to delete or modify, you could enter them directly. If you do not know the specific record information, enter `b' at the prompt and you will enter the Browse mode. The Browse mode allows you to step through the configured records sequentially. You can also enter the Browse mode directly from the Main Menu.

VNS Record Menu Options

The VNS Records menu, shown in the following example, has 16 options. With the exception of option 16, each option leads to a menu or record.

VNS Records Menu ################################################################################ # ciscoSystems/StrataCom V N S # # Configuration Interface, Release 3.0.00 # # # # 1. VNS Information # # 2. Local Adjacency Information # # 3. Network Adjacency Information # # 4. Interface Card Information # # 5. Address Information # # 6. Network Prefixes Information # # 7. Address Screening Information # # 8. Transformation Rules Information # # 9. Nodes Information # # 10. Cards Information # # 11. Ports Information # # 12. More VNS Info and Redundancy Information # # 13. Multihome port configurations # # 14. Multihome policy configurations # # 15. Preferred Route configurations # # 16. Cause Code Configuration # # 17. Return to Previous Menu # # # # Enter your selection: # ?###############################################################################

Options 1 through 16 of the VNS Records menu lead to the following menus or records:

    1. VNS Information menu provides configuration information about a specific VNS.

    2. Local Adjacency Information menu provides information about VNSs that are connected by a frame relay signaling PVC.

    3. Network Adjacency Information menu provides information about the link (frame relay PVC signaling connection) between two VNS's in the WAN switching network when there is more than one path between them. (This menu is not used in VNS Release 2.1.)

    4. Interface Card Information. (Not supported in this release.)


Note The
Interface Card Information menu is not supported in this software release. When you select this option, you will see an OPTION NOT SUPPORTED, ENTER ANY KEY TO CONTINUE message. Press any key to return to the VNS Records menu.

    5. Address Information menu describes the addresses, the telephone number in E.164 format, assigned to a UNI port in a VNS's area.

    6. Network Prefixes Information menu is used assign addresses to VNS areas in the network. These VNS prefixes (or addresses) help to organize the numbering plan for the VNS network.

    7. Address Screening Information menu specifies the type of source and destination screening applied to each UNI port. Address Screening lists destination addresses that are allowed or not allowed for a specific port.

    8. Transformation Rules Information menu specifies a list of transformation rules to be applied to a particular UNI port. Each rule consists of a control string that will specify the way in which digits in a telephone number are to be manipulated.

    9. Nodes Information menu contains information about a node, an IPX or IGX switch, in a VNS's area.

    10. Cards Information menu contains information about a specific voice card (e.g., a CDP in an IPX switch, or an CVM in an IGX switch) in the VNS's area.

    11. Ports Information submenu leads to other menus that provide information about the voice ports in a VNS's area. These other menus provide Port Information about a specific UNI port in a VNS's area, and Screening Type Information for that port.

    12. More VNS Info and Redundancy Information menu contains information about the VNS and its redundant peer.

    13. Multihome port configurations menu is used to multihome a pair of E1 UNI ports and select the policy the VNS will use for choosing between those ports.

    14. Multihome policy configurations menu is used to provide a weight for the Select policy when more than one Select Policy is specified for a multihomed port pair.

    15. Preferred Route Configurations menu leads to the menus for configuring Preferred Routes for Local Adjacency and UNI Port D-channel connections.

    16. Cause Code Information menu is used map cause codes for a specific type of PBX. This allows you to specify which cause codes the VNS will send back to a PBX for disconnect, release, or release complete messages.

    17. Return to Previous Menu.

Menu Order

VNS menus are not completed in the numerical sequence (that is their option number) in which they appear on the VNS Records menu. During an initial installation of a Voice Network Switching system, the menus must be completed in a logical sequence. This logical sequence groups the menus into four sequential operations:

Each of the four operations has its own group of menus that must be configured in a particular order. Certain fields of one menu must be completed before subsequent menus can be completed. These fields are linked between menus. Where it is applicable, this chapter will point out the links between the menus. The following sections describe each of the menus in these three logical groups. For each menu, all the fields are listed along with the parameters or options that the field contains. Where a parameter is listed with an index number, such as, 1 = DPNSS, the default, you only need to enter the index number in that field when completing a menu before moving on to the next field. Other fields will accept text or numerical data from the keyboard; for those fields, we list the range of acceptable values or the length of the character string to be entered. Where applicable the default value of the field is also listed.

Menu Illustrations

In the following sections, the illustration of VNS Configuration Interface menus are taken from both VNS Records Add an entry and Browse Data Base options. Add an entry leads to menus with blank fields that a user must complete. Browse Data Base leads to completed records, and are identified by the Enter `s' to skip record... line at the bottom. The Browse Data Base records have been used to indicate typical values that are entered in some fields. Although the Browse Data Base records and Add an entry menus are nearly identical, a couple Browse Data Base records have an extra field for status. These status fields are typically not user-configurable and thus do not appear on Add an entry menus. The descriptions of the menus in the following pages will point out the differences between Add an entry menus and Browse Data Base records.

Configuring the Domain

The domain configuration menus must be completed in the following order:

Nodes Information

The Nodes Information menu, shown in the following example, creates records of the node's (IGX or IPX switch) in a VNS's area. It includes the node's IP address through which the VNS will communicate with the node. For the node which is directly attached to the VNS, this IP address is the LAN address of the IGX or IPX switch. For nodes which are not directly attached to the VNS, however, this IP address is typically the Network IP (NWIP) address of remote IGX or IPX switch.

You must create separate Nodes Information records for each node in the VNS's area or domain. (The example menu is actually a Browse Data Base record; the Add an entry Nodes Information Menu will not have the State of Node field shown here.) This menu must be completed first because the Node Name field is linked to other menus.

Nodes Information Menu ############################################################################## # # # # # # # # # Node Name [ ganges ] # # IP Address [ 192.168.200.200 ] State of Node [ 2 ] # # # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # # # ?##############################################################################

The Nodes Information menu contains the following fields:


Note The State of Node field is a read-only field that only shows up when you Browse Data Base and are viewing a completed Nodes Information record.

Cards Information

The Cards Information menu, shown in the following example, contains information about a specific voice or frame relay card (e.g., a CVM in an IGX switch or a CDP in an IPX switch) in the VNS's area. The Nodes Information menu must have been completed before you can complete this menu. You will not be able to delete a Cards Information record if it is being used for redundancy. Also there can not be any ports configured on that card (see Ports Information Submenu) if you want to delete a Cards Information record.

Cards Information Example Menu ############################################################################## # # # # # # # # # Card Descriptor [ ganges.8 ] # # Card State [ 1 ] Card Type [ 1 ] # # # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # # # # # # # ?##############################################################################

The Cards Information menu contains the following fields:

VNS Information

The VNS Information menu, shown in the following example, provides configuration information about a specific VNS. There will be a separate VNS Information screen for each VNS in the VNS WAN switching network. When completing this menu, press Return for fields that do not have to be changed. The Nodes Information and Cards Information menus must have been completed before you complete this menu.

VNS Information Example Menu ############################################################################## # # # # # # # # # VNS Name [ vnslab8 ] # # Node Name [ dasipx1 ] # # Node IP Address [ 192.168.200.111 ] # # Shut Down Timer [ 3 ] Statistics [ 2 ] # # CDR File Count [ 10 ] CDR File Interval [ 1 ] # # SPNNI Type [ 1 ] Compression Type [ 6 ] # # Read Comm String [ public ] # # Write Comm String [ private ] # # Keep Alive Timer [ 2 ] State Change Timer[ 30 ] # # RRP_UDP Port [ 5134 ] RRP Retry Count [ 10 ] # # Config Redundancy?[ 1 ] Enable MultiDomain[ 2 ] # # Operational Status[ 2 ] Operational Role [ 1 ] # # VNS IP Address [ 192.168.4.68 ] CVM Redundancy [ 2 ] # # Enter 's' to skip record or 'q' to quit [ ] # # # # # ?##############################################################################

The VNS Information menu contains the following fields:


Note The only statistics generated in this release are Call Detail Records (CDRs).

Note If you are using the QSIG protocol package, you must make sure that the SPNNI Type is set to QSIG and that the
Port Information submenu's Stack Type Field is also set to QSIG.
Options 14 through 18require IGX UVM with model C or model D firmware at both ends of the connection.

Note The VNS provides support for 16k LDCELP connections only between IGX UVM cards. Therefore, once this compression type is specified, it is assumed that all SVCs are being made from UVM to UVM cards. If there are a mixture of CVM/CDP and UVM cards in the WAN switching network, the VNS will automatically fall back to a type of ADPCM compression supported by all card types in the network.

Note Voice connection parameters are described in greater detail in the Cisco WAN Switching System Overview, in the Voice Connections chapter of the Cisco WAN Switching Command Reference, and in the reference document for the Cisco wide-area switch. For instance, the Cisco IPX Reference describes voice connection parameters within the description of the Channelized Data Pad (CDP) card. To see the actual voice parameters of a specific switched software release (for example, 8.2 or 9.1), you have to see the Cisco IGX 8400 Series Reference manual for that release.

Note When completing the VNS Information menu, typically you do not change the RRP_UDP Port field from its default (5134). Simply press Return when the cursor reaches that field.
To complete the redundancy configuration, you have to complete the More VNS Info and Redundancy Information menu for both VNSs in the redundant pair. (Chapter 8 contains a procedure for configuring redundancy in the section, Configure Redundancy.)
This Enable MultiDomain field has the following options:
During an initial installation, if you are not using multidomain service, leave this field alone.

Note The CVM Redundancy field (and feature) also applies to UVM cards.

More VNS Info and Redundancy Information

The More VNS Info and Redundancy Information menu, shown in the following example, provides information for the VNS and its redundant peer. (The Nodes Information and Cards Information must be completed before you complete this menu.) This menu has to be completed for both VNSs in a redundant pair. Make sure the redundant VNS is turned off while configuring the active VNS. When completing the More VNS Info and Redundancy Information menu, make sure to enter the Peer IP Address correctly. Also make sure to set the Admin Role to 1 (active). Save the record.

Open and complete another More VNS Info and Redundancy Information record that corresponds to the peer VNS. Enter the Peer IP Address so that it points back to the Active VNS. Set the Admin Role to 2 (standby). Save the record.

When these records have been completed, you can turn on the redundant (peer) VNS.

An active redundancy record for the active VNS must exist, you can not delete it. Also you cannot delete a standby redundancy record when the standby VNS is In Service.

More VNS Information and Redundancy Information Example Menu ############################################################################## # # # # # # # # # VNS Name [ vnslab8 ] # # Voice Port#1 [ dasipx1.4.1 ] # # Voice Port#2 [ ] # # Frame Relay Port [ dasipx1.5.1 ] # # Operational Status[ 2 ] Operational Role [ 1 ] # # Admin Status [ 1 ] Admin Role [ 1 ] # # Peer IP Address [ 0.0.0.0 ] # # VNS FR-IP Address [ 0.0.0.0 ] # # Peer FR-IP Address[ 0.0.0.0 ] # # # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # ?##############################################################################

The More VNS Info and Redundancy Information menu contains the following fields:

Configuring UNI or PBX Addressing

The UNI (User Network Interface) or PBX addressing configuration menus must be completed in the following order:

Ports Information Submenu

The Ports Information submenu, shown in the following example, leads to other menus that provide information about the UNI ports in a VNS's area.

Ports Information Menu ################################################################################ # # # ciscoSystems/StrataCom V N S # # Configuration Interface, Release 3.0.00 # # # # 1. Port Information # # # # 2. Screening Type Information # # # # 3. Return to Main Menu # # # # Enter your selection: # # # # # # # # # # # # # # # # # # # # # # # ?###############################################################################

The Ports Information menu contains the following options:

    1. Port Information

    2. Screening Type Information

    3. Return to Previous menu

To access one of the options, enter the selection index number and press Enter.

Port Information

The Port Information menu, shown in the following example, creates a record information about a UNI port in a VNS's area. You must create one of these records for each UNI port in the VNS's service area. The Nodes Information and Cards Information menus must have already been completed before you can complete this menu.

Port Information Example Menu ################################################################################ # # # # # # # # # Port Descriptor [ vnsigx11.9.1 ] # # Port Type [ 1 ] Port State [ 2 ] # # UNI Channel [ 16 ] VNS Channel [ 1 ] # # First Channel [ 1 ] Last Channel [ 31 ] # # Channel Alloc Role[ 3 ] Channel Allocation[ 3 ] # # Interface ID [ 1 ] # # Statistics [ 2 ] Stats Interval [ 60 ] # # Stack Type [ 13 ] Record Oper State [ 0 ] # # PBX Type [ seimenspbx ] # # # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # ?###############################################################################

The Port Information menu contains the following fields:

Other values are reserved for future use.

Note DPNSS X - Y is not configurable. Side A is always side x and side B is always side y.

Note With CAS signaling, as described in Appendix I,
Channel Associated Signaling Voice Switching, the protocol is operating between the IGX's UVM card and the VNS. The UVM always performs the master role, so the VNS must be set to slave.

Note For ISDN preferred/exclusive is not configurable. For incoming requests both preferred and exclusive will be processed. All outgoing calls are exclusive.

Note To complete this menu, you must enter one of the options for the Statistic's field. This choice does not affect the operation of the VNS, however.
You can delete a record only when it is in the 0 or 4 state. Once a port has been deleted the port record will no longer be accessible.
A typical use of the PBX Type field is to create a cause code file for a specific type of PBX, then reference that file, by entering the appropriate PBX Type, for each PBX of the same type in your network.

Screening Type Information

Screening allows you to screen addresses, that is, filter calling party and called party numbers. In other words, you can create lists of numbers from which or to which you will allow calls, or lists of numbers from which or to which you will not allow calls. Using the Screening Type Information menu, shown in the example, you can select the type of screening you are going to do for calling parties (that is, source) or the called parties (that is, destination) for a UNI port. (The Address Screening Information menu is used to specify the actual addresses that are going to be screened.) Typically, you use this menu to select the type of screening which will allow you to create the shorter screening list. For example, if you have a small number of addresses (called party numbers) to which you do not want to allow calls, you would select Destination Screen Type disallowed; then use the Address Screening Information menu to specify these addresses.


Note Address screening does not work in multidomain VNS networks.

Screening Type Information Example Menu ############################################################################## # # # # # # # # # Port Descriptor [dasigx1.7.1 ] # # Source Screen Type [2 ] Destination Screen [2 ]# # # # Enter 'c' to commit changes or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # # # # # # # ?##############################################################################

The Screening Type Information menu contains the following fields:

Address Information

The Address Information menu, shown in the following example, describes the addresses, the telephone number format, assigned to a UNI port in a VNS's area. When you browse the Address Information records, they will be displayed in a sorted, descending order. For example, Address 8000 will be displayed before Address 7999, which will be displayed before Address 900, and so on.


Note A local address must be different than a network address; network addresses are described in the section
Network Prefixes Information. The VNS does not check local addresses against network addresses. Therefore, if they are identical, the VNS will not be able to route to the local address.

The Nodes Information, Cards Information, and Ports Information menus must be completed before you can complete this menu.

Address Information Example Menu ############################################################################## # # # # # Address [069****** ] # # Port Descriptor [dasigx1.7.1 ] # # # # Enter 'c' to commit changes or 'q' to quit [ ] # # # # # # # # # # # # # # # # KEY: The address configured on the local VNS. # # # # # ?##############################################################################

The Address Information menu contains the following fields:

When the QSIG protocol is used, to avoid having to enter very complex numbering plans and to speed up the call routing process, the VNS allows the use of wildcards (that is, the * symbol) in an address. For instance, you could enter Address 069***** to route all calls beginning with 069 to the PBX attached to UNI port dasigx1.7.1.
For exceptions you add another Address Information record, specifying the complete address and port. For instance, you could add Address 069-123456 and Port Descriptor dasigx1.6.1 and Address 069124*** and Port Descriptor dasigx1.5.1 to route those calls to different PBX's.
When using wildcards, you must observe the following rules:

  • All addresses must start with a digit.

  • The exception digits cannot exceed the length of the default string. That is, if the default entry is 069*** (7 digits), any specific entries have to be 7 digits or less. If the specific entry is less than 7 digits, use the wildcard symbol (*) to fill out the string, such as 069124***. In other words, the default string must be as long or longer than the largest exception.

  • One wildcard symbol needs to be entered for every digit that needs to be processed. For example, **** indicates four digits.

  • The wildcard symbols must be entered as consecutive digits. Thus, 069****** is allowed, but 069**5*** is not allowed.

Address Screening Information

The Address Screening Information menu, shown in the following example, is used together with the Screening Type Information menu to create the lists of called party (that is, source) and calling party (that is, destination) addresses that you are going to filter (allow or disallow) for the specified UNI port. The Screening Type Information must have been completed before you can complete this menu. This menu specifies the address (that is, the called or calling party number) that is allowed or not allowed for a specific port, while the Screening Type Information menu specifies the type of screening that will be performed. This menu creates one record for your screening list. You must complete one record for each number you want to screen.

Address Screening Information Example Menu ############################################################################## # # # # # # # # # Address Screening Rule # # [5551234 ] # # Port Descriptor [dasigx1.7.1 ] # # Screening Type [2 ] # # # # Enter 'c' to commit changes or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # KEY: The address screening rule. # # # # # ?##############################################################################

The Address Screening Information menu contains the following fields:

Address Screening Example

As an example of Address Screening, say that there is one local address of 20* being routed to port vnsigx1.10.1. When your are configuring Address Screening for this port, the following rules would be valid:

    1. Address Screening Rule = 20*
    Port Descriptor = vnsigx1.10.1
    Screening Type = 2

    2. Address Screening Rule = 2*
    Port Descriptor = vnsigx1.10.1
    Screening Type = 1

    3. Address Screening Rule = 433
    Port Descriptor = vnsigx1.10.1
    Screening Type = 2

The following illustrates an invalid configuration:

    1. Address Screening Rule = 2000
    Port Descriptor = vnsigx1.10.1
    Screening Type = 2


Note Both calling and called party numbers should be configured on the Address Screening Information menu for both Source and Destination ports.

For Example, if the Calling Party number is 500 at Port sltigx5.5.1 and the Called Party number is 600 at Port sltigx6.6.1, then to make a filtered call from an address 500 to address 600, while Address screening is ALLOWED (see the Screening Type Information menu), you would configure 4 Address Screening Information records as follows:

    1. Address Screening Rule = 500
    Port Descriptor = sltigx7.5.1
    Screening Type = 1

    2. Address Screening Rule = 600
    Port Descriptor = sltigx7.5.1
    Screening Type = 2

    3. Address Screening Rule = 500
    Port Descriptor = sltigx7.6.1
    Screening Type = 1

    4. Address Screening Rule = 600
    Port Descriptor = sltigx7.6.1
    Screening Type = 2

Transformation Rules Information

The VNS provides address (that is, number) translation to route public network telephone numbers over a VNS private networks. This translation feature can be used to translate a public number to a private number for Break-In and a private number to a public number for Break-Out. (The Break-Out/Break-In feature is described in Chapter 1 in the section, Break-Out/Break-In Feature.)

The Transformation Rules Information menu, shown in the following example menu, specifies the way a number is transformed, that is converted from one number to another. Transformation rules applied to a particular UNI port and can be applied to calling party or called party numbers. The Nodes Information, Cards Information, and Ports Information menus must be completed before you can complete this menu.

Transformation rules can not be applied between VNS domains.

Transformation Rules Information Example Menu ############################################################################## # # # # # # # # # Port Descriptor [dasigx1.7.1 ] # # Priority [1 ] # # # # Pattern to Locate # # [^123 ] # # Pattern to be Replaced # # [$0 ] # # Replacement Digits # # [1234 ] # # Direction [4 ] Application [3 ]# # # # Enter 'c' to commit changes or 'q' to quit [ ] # # # # # # # # KEY: The port descriptor to which transformation rule is to be applied # # # # # ?##############################################################################

The Transformation Rules Information menu contains the following fields:


Note There are not other types of addresses supported by the Application field.
If any bit is set then the Transformation Rule will be applied to that number. Although the Application field is implemented as a bit mask, it is entered as a decimal number, with a range of 0 to 65535. Therefore to select "called party number," you would enter 1, and to select "calling party number," you would enter 2. To select both "calling party number" and "called party number", you would enter 3, the sum of the decimal equivalent of the two set bits.

Wildcard Translations

The wildcard `*' character is supported in translation patterns. To use wildcard translations, follow these guidelines:

The use of wildcards greatly simplifies the use of transformation rules. For instance, if you wanted to translate all the numbers between 200 and 299 to the same address, without wildcards you would have to create 100 Transformation Rule records, one for 200, another for 201, another for 202....until you reached 299. With wildcards, a single record can use 2** to translate all the numbers between 200 and 299.

Translation Limitations

The number of digits in a translation rule should not exceed the number of digits in a local or network address or the call will be routed before the number is translated. Also if the number coming in to be translated does not match a route address, the call will be rejected when the first number that does not match is found. Thus a call which needs to be translated, could be rejected before the translation has been performed.

To avoid these limitations, careful planning of network addressing and transformation rules is necessary.

Multihome Port Configurations

The Multihome Port Configurations menu, option 13 on the VNS Records menu, shown in the following example, is used when configuring Multihomed E1 UNI port pairs. Multihoming E1 Ports is described in Chapter 1 in section Multihomed E1 Links. Multihomed ports typically have the same address configured for them and are used to increase the hit ration of successful calls to a specific address, load-sharing, or backup for a particular link.

You must create one of these records for each of ports in a multihomed pair. For instance, to multihome dasigx2.7 to dasigx2.8, after committing the record shown below, you would create a record for dasigx2.8 with dasigx2.7 as the multihomed port, also with a select policy of 8. If you were going to multihome 3 UNI ports, A, B, and C, you would complete 6 Multihome Port Configuration records. Two for A & B, two for B & C, and two for A & C.

The Nodes Information, Cards Information, and Ports Information menus must already have been configured before you can complete this menu.

Multihome Port Configurations Example Menu ############################################################################## # # # # # # # # # CPE Port # # [dasigx2.7 ] # # Multihomed Port [dasigx2.81 ] # # Select Policy [8 ] # # # # Enter 'c' to commit changes or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # # # ?##############################################################################

This menu includes the following fields:

Multihome Policy Configurations

The Multihome Policy Configurations menu, option 14 on the VNS Records menu, shown in the following example, is used to provide a weight for a Select Policy when more than one Select Policy is specified for a multihomed port pair. Multihoming E1 Ports is described in Chapter 1 in section Multihomed E1 Links.

The Nodes Information, Cards Information, and Ports Information menus must already have been configured before you can complete this menu.

Multihome Policy Configurations Example Menu ############################################################################## # # # # # # # # # Port Description # # [dasigx1.7.1 ] # # Policy [8 ] # # Weightage [100 ] # # # # Enter 'c' to commit changes or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # KEY: The port descriptor where the policy is linked. # # # # # ?##############################################################################

This menu includes the following fields:

On a specific port, each of the Select Policies could be assigned a different weight. When there are more than one pair of multihomed ports configured for the same primary port, the VNS will consider all the selection policies and all of their weights before routing a call to a specific port.

Configuring Multiple Domains

The multiple domain configuration menus must be completed in the following order:

Naturally if there were only a single VNS domain in your VNS WAN switching network, these menus would not have to be completed.

Local Adjacency Information

The Local Adjacency Information menu, shown in the following example, provides information about locally adjacent VNS's, that is VNS's controlling separate VNS domains and connected to one another through a Frame Relay PVC (that is, a SPNNI connection). After committing this record, the VNS instructs the node (IGX or IPX switch) to build the Frame Relay connection to the remote VNS. (The example is actually a Local Adjacency Information record; the VNS State field will not appear on the Local Adjacency Information menu.) Local Adjacency menus have to completed at both ends of the SPNNI connection. (Chapter 8 contains an example of counterpart Local Adjacency records in the section Local Adjacency Example.)


Note In this release, the VNS signaling is done over a full-mesh network. Every VNS has a frame relay PVC to every other VNS controlling a separate domain in the network. Thus every VNS is considered "locally adjacent" to every other VNS.
Local Adjacency Information Example Menu ############################################################################## # # # # # # # # # VNS Name [ boysen ] Standby VNS Name [ ] # # Local Port Type [ 3 ] Local DLCI [ 100 ] # # Remote Port Desc [ dasigx1.4.1 ] Remote DLCI [ 200 ] # # Link Weight [ 1 ] VNS State [ 0 ] # # Rmt Stby Port Desc[ ] # # # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # ?##############################################################################

This menu contains the following fields:


Note Since the VNS frame relay signaling network is full mesh, every link (i.e., frame relay PVC between VNSs) will have the same weight or preference.

Network Prefixes Information

The Network Prefixes menu, shown in the following example, is used to organize addresses in VNS areas in the network. These VNS prefixes (or addresses) help to organize the numbering plan for the VNS WAN switching network. Unique prefixes are typically assigned to each VNS area, much like an area code in plain old telephone service (POTS).


Note A network address must be different than a local address; local addresses are described in the section
Address Information. The VNS does not check local addresses against network addresses. Therefore, if they are identical, the VNS will not be able to route to the local address.
Network Prefixes Information Example Menu ############################################################################## # # # # # # # # # Network Address [ 30 ] # # VNS Name [ boysen ] # # # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # # # # # # # ?##############################################################################

The Network Prefixes Information menu contains the following fields:

Network Adjacency Information

This menu is reserved for use when the VNS supports alternate signaling links between VNS areas. It can not be used in VNS Release 3.0.

The Network Adjacency Information menu, shown in the following example, provides information about the link (frame relay PVC signaling connection) between two VNSs in the network.


Note In this release, where a full-mesh signaling network is required, this menu has no use. Do not complete it.
Network Adjacency Information Example Menu ############################################################################## # # # # # # # # # First VNS Name [dasigx1 ] Second VNS Name [dasigx2 ]# # Link Weight [1 ] # # # # Enter 'c' to commit changes or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # # KEY: Unique name of the first VNS, up to 8 chars long # # # # # ?##############################################################################

This menu contains the following fields:

Configuring Preferred D Channel Routes

The Preferred Route Configurations menu leads to menus that let you specify a preferred route for the signaling channel between a UNI port and the VNS, or between two locally adjacent VNS's. The VNS system adds these preferred routes as signaling PVCs in the network. Preferred routing of these signaling channels provides the flexibility needed to avoid network congestion, and to provide load balancing and resiliency across network trunks.


Note Preferred routes will fail if a trunk they are traversing fails, such as when the trunk is deleted or upped but not added.

From the Preferred Route Configurations menu, shown in the following example menu, you can select either:

    1. Local Adjacency Preferred Route Information

    2. Port Preferred Route Information

Preferred Route Configurations Example Menu ################################################################################ # # # ciscoSystems/StrataCom V N S # # Configuration Interface, Release 3.0.00 # # # # 1. Local Adjacency Preferred Route Information # # # # 2. Port Preferred Route Information # # # # 3. Return to Main Menu # # # # Enter your selection: # # # # # # # # # # # # # # # # # # # # # # # ?###############################################################################

Local Adjacency Preferred Route Information

The Local Adjacency Preferred Route option allows you to specify a preferred route for a SPNNI connection between two locally adjacent VNS's. Local Adjacency must be configured with the Local Adjacency Information menu before you can configure a preferred route. Figure 7-1 provides a simple example where the Local Adjacency Preferred Route option could be used. In this example, rather than use E1 Trunk 1, you want to route the SPNNI channel between vnslab1 and vnslab2 (that is, the locally adjacent VNS's) through vnsigx3. The numbers in the example indicate the IGX slot number of the NTMs, that is, the trunk cards. For instance, the 14 below vnsigx1 indicates that the NTM (that is, the trunk card is in slot 14.


Figure 7-1: Local Adjacency Preferred Route Example


You use the Local Adjacency Preferred Route Information menu, shown in the following example menu, to configure a preferred local adjacency route. The Local Adjacency Preferred Route record must be configured on both of the locally adjacent VNS's.

Local Adjacency Preferred Route Information Example Menu ############################################################################## # # # # # # # # # Remote VNS Name [ vnslab2 ] # # Local VNS Name [ vnslab1 ] # # Local node [ vnsigx1.14 ] Remote node [ vnsigx2 ] # # 1st Hop [ vnsigx3.12 ] 2nd Hop [ ] # # 3rd Hop [ ] 4th Hop [ ] # # 5th Hop [ ] 6th Hop [ ] # # 7th Hop [ ] 8th Hop [ ] # # 9th Hop [ ] # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # # # # # ?##############################################################################

The Local Adjacency Preferred Route Information menu contains the following fields:

The preferred route for the Local Adjacency PVC then becomes the concatenation of Local Node, all non-empty hop fields (1st Hop, etc.), and the Remote Node. When the Local Adjacency PVC is built either at boot time or at configuration time, the VNS will send the node (IGX or IPX switch) SNMP commands to build the connection over the preferred route. If the node fails to set up the preferred route signaling PVC, it will try to build a PVC through another route. Also if the preferred route fails after it has been built, the node will build another route.

Port Preferred Route Information

The Port Preferred Route option allows you to specify a preferred route for the signaling channel from a port (that is, a UNI attached to a PBX) to a VNS. The port must be configured with the Ports Information Submenu before you can configure a preferred route for it. Figure 7-2 illustrates a simple example where Port Preferred Routing could be used. In this example, there are a couple ways that the signaling channel (that is, the D channel) could be routed from PBX 2 to vnslab6. Depending on your traffic loading and network requirements, you could specify either E1 Trunk 1 or E1 Trunk 2 to be the preferred route. In the example, the numbers at either end of the E1 trunk indicate the slot numbers of the NTM, that is, the trunk cards.


Figure 7-2: Port Preferred Route Example


In this case, you would use the Port Preferred Routing menu to specify the preferred route. The Port Preferred Route Information menu is shown in the following example menu.

Port Preferred Route Information Example Menu ############################################################################## # # # # # # # # # Port descriptor [ vnsigx3.8.1 ] # # Local VNS Name [ vnslab6 ] # # Local node [ vnsigx2.14 ] Remote node [ vnsigx3 ] # # 1st Hop [ ] 2nd Hop [ ] # # 3rd Hop [ ] 4th Hop [ ] # # 5th Hop [ ] 6th Hop [ ] # # 7th Hop [ ] 8th Hop [ ] # # 9th Hop [ ] # # Enter 's' to skip record or 'q' to quit [ ] # # # # # # # # # # # # # # # # # ?##############################################################################

The Port Preferred Route Information menu has the following fields:

The preferred route for the UNI port PVC (that is, the D-channel from the UNI port to the VNS) then becomes the concatenation of Local Node, all non-empty Hop fields (1st Hop, etc.), and the Remote Node. When the port PVC is built either at boot time or at configuration time, the VNS will send the node (IGX or IPX switch) SNMP commands to build the connection over the preferred route. If the node fails to set up the preferred route signaling PVC, it will try to build a PVC through another route. Also if the preferred route fails after it has been built, the node will build another route.

Cause Code Mapping

When a call is terminated abnormally, some PBXs can re-route the call on a different trunk based on the cause code that is contained in the disconnection message. Often, the re-route has to be done for different disconnection causes, but PBXs can be configured to re-route on a limited set of cause codes. The VNS allows you to configure specific cause codes to be returned to specific PBX types. This configuration is done on a per-port basis (see the PBX Type field of the Port Information menu). Cause codes from the far-end PBX as will as cause codes generated by the VNS will be translated as configured before being delivered to the near-end PBX.

Configuring cause codes requires the following items:

Cause Code Information Menu

Option 16, Cause Code Information, on the VNS Record Menu allows you to edit or view the cause code mapping file for a specific PBX type or port. (Note that this process is taking a default file which has cause codes 2, 3, 38, 41, 42, 111 translated to 34 and allows you to modify it for your application.) Here you enter the exact PBX type, which is a text string that is identical to a PBX Type field already configured on a Port Information menu. This string forms the file name of the cause code mapping file for the specified PBX type.

In the Cause Code Information Example Menu, seimenspbx is the PBX Type. This PBX Type must have been previously configured on a Port Information menu.

Cause Code Information Example Menu ################################################################################ # # # # # # # # # Enter PBX Type :seimenspbx # # # # # # # # # # # # # # # # # # # # # # # # # ?###############################################################################

After entering the PBX Type (such as, seimenspbx), when you press Enter, you are prompted to enter a cause code to translate from as shown in the Translate From/Translate To Example Menu. Next you are prompted to enter the cause code to translate to. In this example, cause code 112 will be translated to cause code 34 when returned to a port configured with "seimenspbx" PBX Type. Finally, as shown in the example, you are prompted to enter more cause codes to translate. You commit each cause code mapping pair individually. Repeat the process for every cause code you want translated, then press any other key to quit and save the file.

Translate From/Translate To Example Menu +##############################################################################+ # # # # # # # # # Enter PBX Type : seimenspbx # # # # Enter Cause Code to Translate From : 112 # # # # Enter Cause Code to Translate To : 34 # # # # # # # # Enter 'm' for More, any other key to Quit # # # # # # # # # +##############################################################################+

You can use the Browse Data Base option from the Main Menu to see the entire list of cause codes that are mapped for a particular PBX Type file. As shown in the Browse Cause Code Example file, the translated-from cause codes and the translated-to cause codes are shown in two columns. This example shows the default list of translated cause codes (2, 3, 38, 41, 42, 111 translated to 34), as well as the 112 being translated to 34.

Browse Cause Code Example File +##############################################################################+ # # # # # # # # # Enter PBX Type : seimenspbx # # # # Translate From Translate To # # # # 2 34 # # 3 34 # # 38 34 # # 41 34 # # 42 34 # # 111 34 # # 112 34 # # # # Type any key to Exit.. # # # # # # # # # # # +##############################################################################+

Delete an Entry

The Delete an Entry option of the VNS main menu allows you to delete completed entries in the VNS database.

When you choose this option, you get the same list of menus that you get when you select Add and entry. However choosing an item, such as VNS Information, pulls up a completed menu. You can then delete that entry to remove it from the data base.

Modify an Entry

The Modify an Entry option of the VNS main menu allows you to modify completed entries in the VNS database.

When you choose this option, you get the same list of menus that you get when you select Add and entry. However choosing an item, such as VNS Information, pulls up a completed menu. You can then modify that entry and save the modifications in the data base.

Browse Data Base

The Browse the Data Base option of the VNS main menu allows you to view the entries in the VNS database.

When you choose this option, you get the same list of menus that you get when you select Add and entry. However choosing an item, such as VNS Information, pulls up a completed menu. You can then look at it without modifying the data base.


Note There are a couple of read-only status fields that appear on Browse Data Base menus that do not appear on Add an Entry menus.

Validate Data Base

The Validate Data Base option of the VNS main menu allows you check the integrity of the VNS database. This command will return either a DATA BASE IS VALID or DATA BASE IS INVALID, PLEASE RESTORE FROM BACKUP message. When the database is invalid, you will have to restore it from a backup or recreate it. The following example shows the DATA BASE IS VALID message.

Validate Data Base Response ############################################################################## # # # # # DATABASE IS VALID... # # # Hit any key to continue # # # # # # # # # # # # # # # # # # # ?##############################################################################

Debug Mode


Note The Debug Mode menu is reserved for use by Support Personnel. Misuse of this menu could seriously degrade the performance of your VNS and WAN switching network.
Debug Mode Example Menu ############################################################################## # # # # # # # # # VNS Name [ vnslab8 ] # # Debug Level [ 0 ] # # Log Information [ 0 ] # # Dump Sys Table [ 0 ] # # # # Type 'c' to commit,'s' to skip,'q' to quit [ ] # # # # # # # # # # # # # # # # # # # # # # # # # ?##############################################################################

Exit the Program

Select this option from the VNS main menu to close the VNS Configuration Interface and return to the VNS's UNIX prompt.

VNS Parameter Ranges and Defaults

Table 7-2 lists all the parameters (including their menu index number) in the VNS Configuration Interface, along with their ranges and defaults. The table lists each relevant menu in the left column. the menus are listed in the same order in which they are described in this chapter; this is the order in which they are completed and not the numerical sequence in which they appear on the Main Menu. The right column lists the parameter with its index number in parenthesis (that is, the index number returned in VNS Configuration Interface error messages identifying the field), the applicable range, and the default in bold text. Only those menus that have user-changeable fields are listed. Fields which are described as read-only display information but are not user-configurable.


Table 7-2: VNS Configuration Parameters
Menu Field (and index number), Range, and Default

Nodes Information

Node Name (1): 10-character text string
IP Address (2):
State of Node: read-only field (1 = outOfService, 2 = inService)

Cards Information

Card Descriptor (1): node.slot notation
Card State: read-only field
Card Type (2):

VNS Information

VNS Name (1): 8-character VNS name
Node Name (2): 10 character IGX/IPX name
Node IP Address(3): IGX/IPX's LAN port IP address in dotted decimal notation
Shut Down Timer (4): 0 - 65535
Statistics (5): On
CDR File Count (6):
CDR File Interval (7):
SPNNI Type (8):
Compression Type (9):
Read Comm String (10): 1 - 32 characters
Write Comm String (11): 1 - 32 characters
Keep Alive Timer (12): 1 -60 seconds, 5
State Change Timer (13): 10 - 120 seconds, 30
RRP_UDP Port (14): 3000 to 65535, 5134
RRP Retry Count (15): 1 -100, 5
Config Redundancy (16): 0 = No, 1 = Yes
Enable MultiDomain (17): 1 = Disabled, 2 = Enabled
CVM Redundancy: 1 = Disabled, 2 = Enabled
Operational Status: 0 = Unknown, 1 = outOfService, 2 = InService
Operational Role: 0 = Unknown, 1 = active, 2 = standby
VNS IP Address (18): read-only field

More VNS and Redundancy Information

VNS Name (1): 8-character for VNS
Voice Port #1 (2): node.slot.port of Voice Card on IGX/IPX switch
Voice Port #2 (3): node.slot.port of Voice Card on IGX/IPX switch
Frame Relay Port (4): node.slot.port of Frame Relay Port on IGX/IPX switch
Operational Status: read-only field
Operational Role: read-only field
Admin Role (5): 1 = active, 2 = standby
Admin Status (6): 1 = outOfService, 2 = inService, 3 = resetconfig, 4 = shutdown
Peer IP Address (7): dotted decimal format
VNS FR-IP Address (8): Not used
Peer FR-IP Address (9): Not used

Port Information

Port Descriptor (1): node.slot.port notation
Port Type (2): 0 = unknown, 1 = UNI
Port State: 0 = unknown, 1 = outOfService, 2 = inService
UNI Channel (3): 1 - 31
VNS Channel (4): 1 -31
First Channel (5): 1 -31
Last Channel (6): 1 - 31
Channel Alloc Role (7): 1 = unknown, 2 = side B (slave or user), 3 = side A (master or network)
Channel Allocation (8): 1 = unknown, 2 = low end, 3 = high end
Interface ID (9): 1 = Voice Port 1, 2 = Voice Port 2
Statistics (10) 2 = on, 3 = off
Statistics Interval (11): 1 to 65535 minutes
Stack Type (12): 1 = DPNSS, 2 = QSIG, 3 = JISDN (Q931A), 4 = Reserved, 5 = EISDN,
13 = AT&T 4ESS ISDN
PBX Type (13):

Screening Type Information

Port Descriptor (1): node.slot.port of the port
Source Screen Type (2): 1 = allowed, 2 = disallowed
Destination Screen (3): 1 = allowed, 2 = allowed

Address Information

Address (1): 1 - 40 digit E.164 number
Port Descriptor (2): Node.slot.port of the UNI port

Address Screening Information

Address Screening rule (1): 1 = 30 digits or characters
Port Descriptor (2): node.slot.port of UNI port
Screening Type (3): 0 = unknown, 1 = source screening, 2 = destination screening, 3 = both source and destination screening

Transformation Rules Information

Port Descriptor (1): node.slot.port of UNI port
Priority (2): 1 - 500
Patter to Locate (3): 0- 30 digits or characters
Pattern to be Replaced (4): 0 - 30 digits or characters
Replacement Digits (5): 0 - 30 digits
Direction (6): 2 = inComing, 3 = outGoing, 4 = both directions
Application (7): 0 - 65535 decimal number for bit pattern

Multihome Port Configurations

CPE Port (1): node.slot.port
Multihomed Port (2): node.slot.port
Select Policy (3): 1 = round robin alternation between ports, 2 = port with most available bandwidth, 4 = port with least amount of calls to it, 8 = port with least errors

Multihome Policy Configurations

Port Descriptor (1): node.slot.port notation
Policy (2):1 = round robin alternation between ports, 2 = port with most available bandwidth, 4 = port with least amount of calls to it, 8 = port with least errors
Weightage (3): 0 - 100

Local Adjacency Information

VNS Name (1): 8-character name of adjacent VNS
Standby VNS Name (2): 8-character name of adjacent VNS's peer unit
Local Port Type (3): 2 = U-SPNNI, 3 = N-SPNNI
Local DLCI (4):
Remote Port Desc (5):
Remote DLCI (6)
VNS State: 0 = unknown, 1 = outOfService, 2 = inService
Link Weight (7): 1 - 65535
Rmt Stby Port Desc (8): node.slot.port

Network Prefixes Information

Network Address (1): 1 - 30 character or digit prefix
VNS Name (2):

Network Adjacency Information

Not used in this release.

Local Adjacency Preferred Route Information

Remote VNS Name (1): configured VNS name of remote VNS
Local VNS Name (2): configured name of this VNS
Local Node (3): node.slot of local node
Remote Node (4):
1st Hop through 9th Hop (5 - 13): node.slot of the preferred trunks

Port Preferred Route Information

Port descriptor (1): node.slot.port notation of the UNI port
Local VNS Name (2):
Local Node (3): node.slot of local node
Remote Node (4):
1st Hop through 9th Hop (5 - 13): node.slot of the preferred trunks

Cause Code Information

Enter PBX Type (1): Match a PBX Type previously configured with the Ports Information menu.


hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1998 © Cisco Systems Inc.