ATM Switch Router Software Configuration Guide, 12.1(7a)EY
Configuring ATM Routing and PNNI

Table Of Contents

Configuring ATM Routing and PNNI

Overview

ATM Addresses

IISP Configuration

Configuring the Routing Mode

Configuring the ATM Address

Configuring Static Routes

Configuring ATM Address Groups

Basic PNNI Configuration

Configuring PNNI without Hierarchy

Configuring the Lowest Level of the PNNI Hierarchy

Configuring Higher Levels of the PNNI Hierarchy

Advanced PNNI Configuration

Tuning Route Selection

Tuning Topology Attributes

Tuning Protocol Parameters

Configuring ATM PNNI Statistics Collection

Mobile PNNI Configuration

Connecting Mobile PNNI Networks to Fixed PNNI Networks

Configuring ATM Routing and PNNI


This chapter describes the Interim Interswitch Signaling Protocol (IISP) and Private Network-Network Interface (PNNI) ATM routing protocol implementations on the ATM switch router.


Note This chapter provides advanced configuration instructions for the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. For conceptual and background information, refer to the Guide to ATM Technology. For complete descriptions of the commands mentioned in this chapter, refer to the ATM Switch Router Command Reference publication.


This chapter includes the following sections:

Overview

IISP Configuration

Basic PNNI Configuration

Advanced PNNI Configuration

Mobile PNNI Configuration

Overview

To place calls between ATM end systems, signalling consults either IISP, a static routing protocol, or PNNI, a dynamic routing protocol. PNNI provides quality of service (QoS) routes to signalling based on the QoS requirements specified in the call setup request.

For detailed discussions of the following topics, refer to the Guide to ATM Technology:

IISP routing

PNNI signalling and routing

Mechanisms and components of single-level and hierarchical PNNI

ATM Addresses

The autoconfigured ATM address of the ATM switch router suffices when implementing single-level PNNI. Hierarchical PNNI requires an addressing scheme to ensure global uniqueness of the ATM address and to plan for future network expansion.

For detailed discussions of the following related topics, refer to the Guide to ATM Technology:

The autoconfigured ATM address for single-level PNNI

E.164 AESA prefixes

Designing an ATM address plan for hierarchical PNNI

Obtaining registered ATM addresses

IISP Configuration

This section describes the procedures necessary for Interim Interswitch Signaling Protocol (IISP) configuration, and includes the following subsections:

Configuring the Routing Mode

Configuring the ATM Address

Configuring Static Routes

Configuring the Routing Mode

The ATM routing software can be restricted to operate in static mode. In this mode, the call routing is restricted to only the static configuration of ATM routes, disabling operation of any dynamic ATM routing protocols, such as PNNI.

The atm routing-mode command is different from deleting all PNNI nodes using the node command and affects Integrated Local Management Interface (ILMI) autoconfiguration. If the switch is configured using static routing mode on each interface, the switch ILMI variable atmfAtmLayerNniSigVersion is set to IISP. This causes either of the following to happen:

ILMI autoconfiguration on the interfaces between two switches determines the interface type as IISP.

The switch on the other side indicates that the Network-Network Interface (NNI) signalling protocol is not supported.


Note The atm routing-mode command is activated only after the next software reload. The switch continues to operate in the current mode until the software is reloaded.


To configure the routing mode, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm routing-mode static

Configures the ATM routing mode to static.

Step 2

Switch(config)# end

Switch#

Exits configuration mode.

Step 3

Switch# copy system:running-config nvram:startup-config

Writes the running configuration to the startup configuration.

Step 4

Switch# reload

Reloads the switch software.

Example

The following example shows how to use the atm routing-mode static command to restrict the switch operation to static routing mode:

Switch(config)# atm routing-mode static
This Configuration Will Not Take Effect Until Next Reload.
Switch(config)# end
Switch# copy system:running-config nvram:startup-config
Building configuration...
[OK]
Switch# reload

The following example shows how to reset the switch operation back to PNNI if the switch is operating in static mode:

Switch(config)# no atm routing-mode static
This Configuration Will Not Take Effect Until Next Reload.
Switch(config)# end
Switch# copy system:running-config nvram:startup-config
Building configuration...
[OK]
Switch# reload

Displaying the ATM Routing Mode Configuration

To display the ATM routing mode configuration, use the following privileged EXEC command:

Command
Purpose

more system:running-config

Displays the ATM routing mode configuration.


Example

The following example shows the ATM routing mode configuration using the more system:running-config privileged EXEC command:

Switch# more system:running-config
Building configuration...

Current configuration:
!
version 11.2
<information deleted>
!
hostname Switch
!
username dtate
ip rcmd remote-username dplatz
!
atm e164 translation-table
 e164 address 1111111 nsap-address 11.111111111111111111111111.112233445566.11
 e164 address 2222222 nsap-address 22.222222222222222222222222.112233445566.22
 e164 address 3333333 nsap-address 33.333333333333333333333333.112233445566.33
!
atm routing-mode static
atm address 47.0091.8100.0000.0040.0b0a.2b81.0040.0b0a.2b81.00
!
<information deleted>

Configuring the ATM Address

If you are planning to implement only a flat topology network (and have no future plans to migrate to PNNI hierarchy), you can skip this section and use the preconfigured ATM address assigned by Cisco Systems.


Note For information about ATM address considerations, see ATM Addresses.


To change the active ATM address, create a new address, verify that it exists, and then delete the current active address. Follow these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm address new-address-template

Configures the ATM address for the switch.

Step 2

Switch(config)# end

Switch#

Returns to privileged EXEC mode.

Step 3

Switch# show atm addresses

Verifies the new address.

Step 4

Switch# configure terminal

Switch(config)#

Enters configuration mode from the terminal.

Step 5

Switch(config)# no atm address old-address-template

Removes the old ATM address from the switch.

Example

The following example shows how to add the ATM address prefix 47.0091.8100.5670.000.0ca7.ce01. Using the ellipses (...) adds the default Media Access Control (MAC) address as the last six bytes.

Switch(config)# atm address 47.0091.8100.5670.0000.0ca7.ce01...
Switch(config)# no atm address 47.0091.8100.0000.0041.0b0a.1081...

Displaying the ATM Address Configuration

To display the ATM address configuration, use the following EXEC command:

Command
Purpose

show atm addresses

Displays the ATM address configuration.


Example

The following example shows the ATM address configuration using the show atm addresses EXEC command:

Switch# show atm addresses

Switch Address(es):
  47.00918100000000410B0A1081.00410B0A1081.00 active
  47.00918100567000000CA7CE01.00410B0A1081.00 

Soft VC Address(es):
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.0000.00 ATM0/0/0
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.0000.63 ATM0/0/0.99
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.0010.00 ATM0/0/1
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.0020.00 ATM0/0/2
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.0030.00 ATM0/0/3
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.1000.00 ATM0/1/0
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.1010.00 ATM0/1/1
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.1020.00 ATM0/1/2
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.1030.00 ATM0/1/3
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.8000.00 ATM1/0/0
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.8010.00 ATM1/0/1
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.8020.00 ATM1/0/2
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.8030.00 ATM1/0/3
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.9000.00 ATM1/1/0
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.9010.00 ATM1/1/1
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.9020.00 ATM1/1/2
  47.0091.8100.0000.0041.0b0a.1081.4000.0c80.9030.00 ATM1/1/3

ILMI Switch Prefix(es):
  47.0091.8100.0000.0041.0b0a.1081
  47.0091.8100.0000.0060.3e5a.db01

ILMI Configured Interface Prefix(es):

LECS Address(es):

Configuring Static Routes

Use the atm route command to configure a static route. A static route attached to an interface allows all ATM addresses matching the configured address prefix to be reached through that interface.


Note For private User-Network Interface (UNI) interfaces where ILMI address registration is not used, internal-type static routes should be configured to a 19-byte address prefix representing the attached end system.


To configure a static route, use the following global configuration command:

Command
Purpose

atm route addr-prefix atm card/subcard/port
[e164-address address-string [number-type numtype]] [internal] [scope org-scope] [aesa-gateway aesa-address]

Specifies a static route to a reachable address prefix.


Examples

The following example uses the atm route command to configure a static route to the 13-byte switch prefix 47.00918100000000410B0A1081 to ATM interface 0/0/0:

Switch(config)# atm route 47.0091.8100.0000.0041.0B0A.1081 atm 0/0/0

The following example uses the atm route command to configure a static route to the 13-byte switch prefix 47.00918100000000410B0A1081 to ATM interface 0/0/0 configured with a scope 1 associated:

Switch(config)# atm route 47.0091.8100.0000.0041.0B0A.1081 atm 0/0/0 scope 1

Displaying the Static Route Configuration

To display the ATM static route configuration, use the following EXEC command:

Command
Purpose

show atm route

Displays the static route configuration.


Examples

The following example shows the ATM static route configuration using the show atm route privileged EXEC command:

Switch# show atm route

Codes: P - installing Protocol (S - Static, P - PNNI, R - Routing control),
       T - Type (I - Internal prefix, E - Exterior prefix, SE -
                 Summary Exterior prefix, SI - Summary Internal prefix,
                 ZE - Suppress Summary Exterior, ZI - Suppress Summary Internal)

P  T Node/Port        St Lev Prefix
~ ~~ ~~~~~~~~~~~~~~~~ ~~ ~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
S  E 1   ATM0/0/0     DN 56  47.0091.8100.0000/56
S  E 1   ATM0/0/0     DN 0   47.0091.8100.0000.00/64
                             (E164 Address 1234567)
R SI 1   0            UP 0   47.0091.8100.0000.0041.0b0a.1081/104
R  I 1   ATM0         UP 0   47.0091.8100.0000.0041.0b0a.1081.0041.0b0a.1081/152
R  I 1   ATM0         UP 0   47.0091.8100.0000.0041.0b0a.1081.4000.0c/128
R SI 1   0            UP 0   47.0091.8100.5670.0000.0000.0000/104
R  I 1   ATM0         UP 0   47.0091.8100.5670.0000.0000.0000.0040.0b0a.1081/152
R  I 1   ATM0         UP 0   47.0091.8100.5670.0000.0000.0000.4000.0c/128

Configuring ATM Address Groups

ATM address groups allow more than one interface to have the same internal address prefix for the same static route. These multiple static routes provide load balancing for traffic from an end station.

Configure the interfaces in a group by performing the following tasks, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# interface atm card/subcard/port[.vpt#]

Switch(config-if)#

Specifies an ATM interface and enters interface configuration mode.

Step 2

Switch(config-if)# atm interface-group number

Configures the ATM address group.

Example

The following example shows how to configure ATM interface 1/1/0 and ATM interface 3/0/1 in ATM address group 5:

Switch(config)# interface atm 1/1/0
Switch(config-if)# atm interface-group 5
Switch(config-if)# exit
Switch(config)# interface atm 3/0/1
Switch(config-if)# atm interface-group 5

Displaying ATM Address Group Configuration

To determine if an interface is a member of an ATM address group, use the following privileged EXEC command:

Command
Purpose

show running-config interface atm card/subcard/port

Shows the ILMI configuration on a per-port basis.


Example

The following example shows the ATM address group configuration for ATM interface 1/1/0 and ATM interface 3/0/1:

Switch# show running-config interface atm 1/1/0 
Building configuration...

Current configuration:
!
interface ATM1/1/0
 no ip address
 no ip directed-broadcast
 no atm ilmi-keepalive
 atm prefix 47.0091.8100.5670.0000.0000.1122...
 atm interface-group 5
 clock source free-running
end
Switch# show running-config interface atm 3/0/1
Building configuration...

Current configuration:
!
interface ATM3/0/1
 no ip address
 no ip directed-broadcast
 no atm ilmi-keepalive
 atm prefix 47.0091.8100.5670.0000.0000.1122...
 atm interface-group 5
 clock source free-running
end

Basic PNNI Configuration

This section describes all the procedures necessary for a basic PNNI configuration and includes the following subsections:

Configuring PNNI without Hierarchy

Configuring the Lowest Level of the PNNI Hierarchy

Configuring Higher Levels of the PNNI Hierarchy

Configuring PNNI without Hierarchy

The ATM switch router defaults to a working PNNI configuration suitable for operation in isolated flat topology ATM networks. The switch comes with a globally unique preconfigured ATM address. Manual configuration is not required if you:

Have a flat network topology

Do not plan to connect the switch to a service provider network

Do not plan to migrate to a PNNI hierarchy in the future

If you plan to migrate your flat network topology to a PNNI hierarchical topology, proceed to the next section "Configuring the Lowest Level of the PNNI Hierarchy."

Configuring the Lowest Level of the PNNI Hierarchy

This section describes how to configure the lowest level of the PNNI hierarchy. The lowest-level nodes comprise the lowest level of the PNNI hierarchy. When only the lowest-level nodes are configured, there is no hierarchical structure. If your network is relatively small and you want the benefits of PNNI, but do not need the benefits of a hierarchical structure, follow the procedures in this section to configure the lowest level of the PNNI hierarchy.

To implement multiple levels of PNNI hierarchy, first complete the procedures in this section and then proceed to Configuring Higher Levels of the PNNI Hierarchy.

Configuring an ATM Address and PNNI Node Level

The ATM switch router is preconfigured as a single lowest-level PNNI node (locally identified as node 1) with a level of 56. The node ID and peer group ID are calculated based on the current active ATM address.


Note If you are planning to implement only a flat topology network (and have no future plans to migrate to PNNI hierarchy), you can skip this section and use the preconfigured ATM address.


To configure a node in a higher level of the PNNI hierarchy, the value of the node level must be a smaller number. For example, a three-level hierarchical network could progress from level 72 to level 64 to level 56. Notice that the level numbers graduate from largest at the lowest level (72) to smallest at the highest level (56).

To change the active ATM address you must create a new address, verify that it exists, and then delete the current active address. After you have entered the new ATM address, disable node 1 and then reenable it. At the same time, you can change the node level if required for your configuration. The identifiers for all higher level nodes are recalculated based on the new ATM address.


Caution Node IDs and peer group IDs are not recalculated until the node is disabled and then reenabled.

To change the active ATM address, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm address new-address-template

Configures the new ATM address for the switch.

Step 2

Switch(config)# end

Switch#

Returns to privileged EXEC mode.

Step 3

Switch# show atm addresses

Verifies the new address.

Step 4

Switch# configure terminal

Switch(config)#

Enters configuration mode from the terminal.

Step 5

Switch(config)# no atm address old-address-template

Removes the old ATM address from the switch.

Step 6

Switch(config)# atm router pnni

Switch(config-atm-router)#

Enters ATM router PNNI mode from the terminal.

Step 7

Switch(config-atm-router)# node 1 disable

Switch(config-pnni-node)#

Disables the PNNI node.

Step 8

Switch(config-pnni-node)# node 1 level number enable

Reenables the node. You can also change the node level if required for your configuration.

Example

The following example changes the ATM address of the switch from the autoconfigured address 47.0091.8100.0000.0041.0b0a.1081.0041.0b0a.1081.00 to the new address prefix 47.0091.8100.5670.0000.0000.1122.0041.0b0a.1081.00, and causes the node identifier and peer group identifier to be recalculated:

Switch(config)# atm address 47.0091.8100.5670.0000.0000.1122...
Switch(config)# no atm address 47.0091.8100.0000.0041.0b0a.1081...
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1 disable
Switch(config-pnni-node)# node 1 enable

Displaying the PNNI Node Configuration

To display the ATM PNNI node configuration, use the following privileged EXEC command:

Command
Purpose

show atm pnni local-node

Displays the ATM PNNI node configuration.


Example

The following example shows the PNNI node configuration using the show atm pnni local-node privileged EXEC command:

Switch# show atm pnni local-node

PNNI node 1 is enabled and running
  Node name: eng_1
  System address          47.0091810000000002EB1FFE00.0002EB1FFE00.01
  Node ID          56:160:47.0091810000000002EB1FFE00.0002EB1FFE00.00
  Peer group ID        56:160:47.0000.0000.0000.0000.0000
  Level 56, Priority 0 0, No. of interfaces 1, No. of neighbors 0
  Parent Node Index: 2
  Node Allows Transit Calls
  Node Representation: simple

  Hello interval 15 sec, inactivity factor 5,
  Hello hold-down 10 tenths of sec
  Ack-delay 10 tenths of sec, retransmit interval 5 sec,
  Resource poll interval 5 sec
  SVCC integrity times: calling 35 sec, called 50 sec,
  Horizontal Link inactivity time 120 sec,
  PTSE refresh interval 1800 sec, lifetime factor 200 percent,
  Min PTSE interval 10 tenths of sec
  Auto summarization: on, Supported PNNI versions: newest 1, oldest 1
  Default administrative weight mode: uniform
  Max admin weight percentage: -1
  Next resource poll in 3 seconds
  Max PTSEs requested per PTSE request packet: 32
  Redistributing static routes: Yes

Configuring Static Routes

Because PNNI is a dynamic routing protocol, static routes are not necessary between nodes that support PNNI. However, you can extend the routing capability of PNNI beyond nodes that support PNNI to:

Connect to nodes outside of a peer group that do not support PNNI

Define routes to end systems that do not support Integrated Local Management Interface (ILMI)

Use the atm route command to configure a static route. A static route attached to an interface allows all ATM addresses matching the configured address prefix to be reached through that interface.


Note Two PNNI peer groups can be connected using the IISP protocol. Connecting PNNI peer groups requires that a static route be configured on the IISP interfaces, allowing connections to be set up across the IISP link(s).


To configure a static route connection, use the following global configuration command:

Command
Purpose

atm route addr-prefix atm card/subcard/port [e164-address address-string [number-type numtype]] [internal] [scope org-scope]

Specifies a static route to a reachable address prefix.


Examples

The following example uses the atm route command to configure a static route to the 13-byte switch prefix 47.00918100000000410B0A1081 to ATM interface 0/0/0:

Switch(config)# atm route 47.0091.8100.0000.0041.0B0A.1081 atm 0/0/0

The following example uses the atm route command to configure a static route to the 13-byte switch prefix 47.00918100000000410B0A1081 to ATM interface 0/0/0 configured with a scope 1 associated:

Switch(config)# atm route 47.0091.8100.0000.0041.0B0A.1081 atm 0/0/0 scope 1

Displaying the Static Route Configuration

To display the ATM static route configuration, use the following EXEC command:

Command
Purpose

show atm route

Displays the static route configuration.


Example

The following example shows the ATM static route configuration using the show atm route EXEC command:

Switch# show atm route

Codes: P - installing Protocol (S - Static, P - PNNI, R - Routing control),
       T - Type (I - Internal prefix, E - Exterior prefix, SE -
                 Summary Exterior prefix, SI - Summary Internal prefix,
                 ZE - Suppress Summary Exterior, ZI - Suppress Summary Internal)

P  T Node/Port        St Lev Prefix
~ ~~ ~~~~~~~~~~~~~~~~ ~~ ~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
S  E 1   ATM0/0/0     DN 56  47.0091.8100.0000/56
S  E 1   ATM0/0/0     DN 0   47.0091.8100.0000.00/64
                             (E164 Address 1234567)
R SI 1   0            UP 0   47.0091.8100.0000.0041.0b0a.1081/104
R  I 1   ATM0         UP 0   47.0091.8100.0000.0041.0b0a.1081.0041.0b0a.1081/152
R  I 1   ATM0         UP 0   47.0091.8100.0000.0041.0b0a.1081.4000.0c/128
R SI 1   0            UP 0   47.0091.8100.5670.0000.0000.0000/104
R  I 1   ATM0         UP 0   47.0091.8100.5670.0000.0000.0000.0040.0b0a.1081/152
R  I 1   ATM0         UP 0   47.0091.8100.5670.0000.0000.0000.4000.0c/128

Configuring a Summary Address

You can configure summary addresses to reduce the amount of information advertised by a PNNI node and contribute to scalability in large networks. Each summary address consists of a single reachable address prefix that represents a collection of end system or node addresses. We recommend that you use summary addresses when all end system addresses that match the summary address are directly reachable from the node. However, this is not always required because routes are always selected by nodes advertising the longest matching prefix to a destination address.

By default, each lowest-level node has a summary address equal to the 13-byte address prefix of the ATM address of the switch. This address prefix is advertised into its peer group.

You can configure multiple addresses for a single switch which are used during ATM address migration. ILMI registers end systems with multiple prefixes during this period until an old address is removed. PNNI automatically creates 13-byte summary address prefixes from all of its ATM addresses.

You must configure summary addresses (other than the defaults) on each node. Each node can have multiple summary address prefixes. Use the summary-address command to manually configure summary address prefixes.


Note The no auto-summary command removes the default summary address(es). Use the no auto-summary command when systems that match the first 13-bytes of the ATM address(es) of your switch are attached to different switches. You can also use this command for security purposes.


To configure a summary address, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm router pnni

Switch(config-atm-router)#

Enters ATM router PNNI mode.

Step 2

Switch(config-atm-router)# node node-index

Switch(config-pnni-node)#

Enters node configuration mode.

Step 3

Switch(config-pnni-node)# no auto-summary

Removes the default summary address(es).

Step 4

Switch(config-pnni-node)# summary-address address-prefix

Configures the ATM PNNI summary address prefix.

Example

The following example shows how to remove the default summary address(es) and add summary address 47.009181005670:

Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# no auto-summary
Switch(config-pnni-node)# summary-address 47.009181005670

Displaying the Summary Address Configuration

To display the ATM PNNI summary address configuration, use the following privileged EXEC command:

Command
Purpose

show atm pnni summary

Displays a summary of the PNNI hierarchy.


Example

The following example shows the ATM PNNI summary address configuration using the show atm pnni summary privileged EXEC command:

Switch# show atm pnni summary

Codes: Node - Node index advertising this summary
       Type - Summary type (INT - internal, EXT - exterior)
       Sup  - Suppressed flag (Y - Yes, N - No)
       Auto - Auto Summary flag (Y - Yes, N - No)
       Adv  - Advertised flag (Y - Yes, N - No)

 Node Type Sup Auto Adv  Summary Prefix
 ~~~~ ~~~~ ~~~ ~~~~ ~~~  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1   Int   N   Y    Y   47.0091.8100.0000.0040.0b0a.2a81/104
  2   Int   N   Y    N   47.01b1.0000.0000.0000.00/80

Configuring Scope Mapping

The PNNI address scope allows you to restrict advertised reachability information within configurable boundaries.


Note On UNI and IISP interfaces, the scope is specified in terms of organizational scope values ranging from 1 (local) to 15 (global). (Refer to the ATM Forum UNI Signalling 4.0 specification for more information.)


In PNNI networks, the scope is specified in terms of PNNI levels. The mapping from organizational scope values used at UNI and IISP interfaces to PNNI levels is configured on the lowest-level node. The mapping can be determined automatically (which is the default setting) or manually, depending on the configuration of the scope mode command.

In manual mode, whenever the level of node 1 is modified, the scope map should be reconfigured to avoid unintended suppression of reachability advertisements. Misconfiguration of the scope map might cause addresses to remain unadvertised.

In automatic mode, the UNI to PNNI level mapping is automatically reconfigured whenever the level of the node 1 is modified. The automatic reconfiguration avoids misconfigurations caused by node level modifications. Automatic adjustment of scope mapping uses the values shown in Table 10-1.

Table 10-1 Scope Mapping Table

Organizational
Scope
ATM Forum PNNI 1.0
Default Level
Automatic Mode PNNI
Level

1 to 3

96

Minimum (l,96)

4 to 5

80

Minimum (l,80)

6 to 7

72

Minimum (l,72)

8 to 10

64

Minimum (l,64)

11 to 12

48

Minimum (l,48)

13 to 14

32

Minimum (l,32)

15 (global)

0

0


Entering the scope mode automatic command ensures that all organizational scope values cover an area at least as wide as the current node's peer group. Configuring the scope mode to manual disables this feature and no changes can be made without explicit configuration.

To configure the PNNI scope mapping, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm router pnni

Switch(config-atm-router)#

Enters ATM router PNNI mode.

Step 2

Switch(config-atm-router)# node node-index

Switch(config-pnni-node)#

Enters node configuration mode.

Step 3

Switch(config-pnni-node)# scope mode manual

Configures scope mode as manual.1

Step 4

Switch(config-pnni-node)# scope map low-org-scope [high-org-scope] level number

Configures node scope mapping.

1 You must enter the scope mode manual command to allow scope mapping configuration.

Example

The following example shows how to configure PNNI scope mapping manually so that organizational scope values 1 through 8 map to PNNI level 72:

Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# scope mode manual
Switch(config-pnni-node)# scope map 1 8 level 72

Displaying the Scope Mapping Configuration

To display the PNNI scope mapping configuration, use the following privileged EXEC command:

Command
Purpose

show atm pnni scope

Displays the node PNNI scope mapping configuration.


Example

The following example shows the ATM PNNI scope mapping configuration using the show atm pnni scope privileged EXEC command:

Switch# show atm pnni scope

UNI scope   PNNI Level
~~~~~~~~~   ~~~~~~~~~~
(1  - 10)      56
(11 - 12)      48
(13 - 14)      32
(15 - 15)      0

Scope mode: manual

Configuring Higher Levels of the PNNI Hierarchy

Once you have configured the lowest level of the PNNI hierarchy, you can configure the higher levels. To do so, you must configure peer group leaders (PGLs) and logical group nodes (LGNs).

For an explanation of PGLs and LGNs, as well as guidelines for creating a PNNI hierarchy, refer to the Guide to ATM Technology.

Configuring a Logical Group Node and Peer Group Identifier

The LGN is created only when the child node in the same switch (that is, the node whose parent configuration points to this node) is elected PGL of the child peer group.

The peer group identifier defaults to a value created from the first part of the child peer group identifier, and does not need to be specified. If you want a nondefault peer group identifier, you must configure all logical nodes within a peer group with the same peer group identifier.

Higher level nodes are only active if:

A lower-level node specifies the higher-level node as a parent.

The election leadership priority of the child node is configured with a non-zero value and is elected as the PGL.

To configure a LGN and peer group identifier, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm router pnni

Switch(config-atm-router)#

Enters ATM router PNNI mode.

Step 2

Switch(config-atm-router)# node node-index level number [lowest] [peer-group-identifier dd:xxx] [enable | disable]

Configures the logical node and optionally its peer group identifier. Configures each logical node in the peer group with the same peer group identifier. When you have more than one logical node on the same switch, you must specify a different index number to distinguish it from node 1.

Examples

The following example shows how to create a new node 2 with a level of 56 and a peer group identifier of 56:47009111223344:

Switch(config)# atm router pnni
Switch(config-atm-router)# node 2 level 56 peer-group-identifier 56:47009111223344 enable
Switch(config-pnni-node)# end

Notice that the PNNI level and the first two digits of the peer group identifier are the same.

Displaying the Logical Group Node Configuration

To display the LGN configuration, use the following privileged EXEC command:

Command
Purpose

show atm pnni local-node

Displays the PNNI node information.


Example

The following example shows the PNNI node information using the show atm pnni local-node privileged EXEC command:

Switch# show atm pnni local-node 2

PNNI node 2 is enabled and not running
  Node name: Switch.2.56
  System address          47.009181000000000000000001.000000000001.02
  Node ID            56:0:00.000000000000000000000000.000000000001.00
  Peer group ID        56:47.0091.1122.3344.0000.0000.0000
  Level 56, Priority 0 0, No. of interfaces 0, No. of neighbors 0
  Parent Node Index: NONE
  Node Allows Transit Calls
  Node Representation: simple

  Hello interval 15 sec, inactivity factor 5,
  Hello hold-down 10 tenths of sec
  Ack-delay 10 tenths of sec, retransmit interval 5 sec,
  Resource poll interval 5 sec
  SVCC integrity times: calling 35 sec, called 50 sec,
  Horizontal Link inactivity time 120 sec,
  PTSE refresh interval 1800 sec, lifetime factor 200 percent,
  Min PTSE interval 10 tenths of sec
  Auto summarization: on, Supported PNNI versions: newest 1, oldest 1
  Default administrative weight mode: uniform
  Max admin weight percentage: -1
  Max PTSEs requested per PTSE request packet: 32
  Redistributing static routes: No

Configuring the Node Name

PNNI node names default to names based on the host name. However, you can change the default node name to more accurately reflect the peer group. We recommend you chose a node name of 12 characters or less so that your screen displays remain nicely formatted and easy to read.

After a node name has been configured, it is distributed to all other nodes by PNNI flooding. This allows the node to be identified by its node name in PNNI show commands.


Note See Chapter 3, "Initially Configuring the ATM Switch Router," for information about configuring host names.


To configure the PNNI node name, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm router pnni

Switch(config-atm-router)#

Enters ATM router PNNI mode.

Step 2

Switch(config-atm-router)# node node-index

Switch(config-pnni-node)#

Enters node configuration mode.

Step 3

Switch(config-pnni-node)# name name

Configures the node name.

Example

Configure the name of the node as eng_1 using the name command, as in the following example:

Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# name eng_1

Displaying the Node Name Configuration

To display the ATM PNNI node name configuration, use the following privileged EXEC command:

Command
Purpose

show atm pnni local-node

Displays the ATM PNNI router configuration.


Example

This example shows how to display the ATM node name configuration using the show atm pnni local-node command from user EXEC mode:

Switch# show atm pnni local-node
PNNI node 1 is enabled and running
  Node name: eng_1
  System address          47.0091810000000002EB1FFE00.0002EB1FFE00.01
  Node ID          56:160:47.0091810000000002EB1FFE00.0002EB1FFE00.00
  Peer group ID        56:16.0347.0000.0000.0000.0000.0000
  Level 56, Priority 0 0, No. of interfaces 1, No. of neighbors 0
  Parent Node Index: 2
  Node Allows Transit Calls
  Node Representation: simple

  Hello interval 15 sec, inactivity factor 5,
  Hello hold-down 10 tenths of sec
  Ack-delay 10 tenths of sec, retransmit interval 5 sec,
  Resource poll interval 5 sec
  SVCC integrity times: calling 35 sec, called 50 sec,
  Horizontal Link inactivity time 120 sec,
  PTSE refresh interval 1800 sec, lifetime factor 200 percent,
  Min PTSE interval 10 tenths of sec
  Auto summarization: on, Supported PNNI versions: newest 1, oldest 1
  Default administrative weight mode: uniform
  Max admin weight percentage: -1
  Next resource poll in 3 seconds
  Max PTSEs requested per PTSE request packet: 32
  Redistributing static routes: Yes

Configuring a Parent Node

For a node to be eligible to become a PGL within its own peer group, you must configure a parent node and a nonzero election leadership level (described in the following section, " Configuring the Node Election Leadership Priority"). If the node is elected a PGL, the node specified by the parent command becomes the parent node and represents the peer group at the next hierarchical level.

To configure a parent node, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm router pnni

Switch(config-atm-router)#

Enters ATM router PNNI mode.

Step 2

Switch(config-atm-router)# node node-index

Enters node configuration mode.

Step 3

Switch(config-pnni-node)# parent node-index

Configures the parent node index.

Example

The following example shows how to create a parent node for node 1:

Switch(config)# atm router pnni
Switch(config-pnni-node)# node 1 
Switch(config-pnni-node)# parent 2

Displaying the Parent Node Configuration

To display the parent node configuration, use the following privileged EXEC command:

Command
Purpose

show atm pnni hierarchy

Displays the PNNI hierarchy.


Example

The following example shows the ATM parent node information using the show atm pnni hierarchy privileged EXEC command:

Switch# show atm pnni hierarchy
Locally configured parent nodes:
  Node          Parent
  Index  Level  Index   Local-node Status     Node Name
  ~~~~~  ~~~~~  ~~~~~~  ~~~~~~~~~~~~~~~~~~~~  ~~~~~~~~~~~~~~~~~~~~~~
  1      80     2       Enabled/ Running      Switch
  2      72     N/A     Enabled/ Running      Switch.2.72

Configuring the Node Election Leadership Priority

Normally the node with the highest election leadership priority is elected PGL. If two nodes share the same election priority, the node with the highest node identifier becomes the PGL. To be eligible for election the configured priority must be greater than zero. You can configure multiple nodes in a peer group with nonzero leadership priority so that if one PGL becomes unreachable, the node configured with the next highest election leadership priority becomes the new PGL.


Note The choice of PGL does not directly affect the selection of routes across the peer group.


The control for election is done through the assignment of leadership priorities. We recommend that the leadership priority space be divided into three tiers:

First tier: 1 to 49

Second tier: 100 to 149

Third tier: 200 to 205

This subdivision is used because when a node becomes PGL, it increases the advertised leadership priority by a value of 50. This avoids instabilities after election.

The following guidelines apply when configuring the node election leadership priority:

Nodes that you do not want to become PGLs should remain with the default leadership priority value of 0.

Unless you want to force one of the PGL candidates to be the PGL, you should assign all leadership priority values within the first tier. After a node is elected PGL, it remains PGL until it goes down or is configured to step down.

If certain nodes should take precedence over nodes in the first tier, even if one is already PGL, leadership priority values can be assigned from the second tier. We recommend that you configure more than one node with a leadership priority value from this tier. This prevents one unstable node with a larger leadership priority value from repeatedly destabilizing the peer group.

If you need a strict master leader, use the third tier.


Note The election leadership-priority command does not take effect unless a parent node has already been configured using the node and parent commands.


To configure the election leadership priority, perform these steps, beginning in global configuration mode:

 
Command
Purpose

Step 1

Switch(config)# atm router pnni

Switch(config-atm-router)#

Enters ATM router PNNI mode from the terminal.

Step 2

Switch(config-atm-router)# node node-index

Switch(config-pnni-node)#

Enters node configuration mode.

Step 3

Switch(config-pnni-node)# election leadership-priority number

Configures the election leadership priority. The configurable range is from 0 to 205.

Example

The following example shows how to change the election leadership priority for node 1 to 100:

Switch(config)# atm router pnni
Switch(config-pnni-node)# node 1
Switch(config-pnni-node)# election leadership-priority 100

Displaying Node Election Leadership Priority

To display the node election leadership priority, use one of the following privileged EXEC commands:

Command
Purpose

show atm pnni election

Displays the node election leadership priority.

show atm pnni election peers

Displays all nodes in the peer group.


Examples

The following example shows the election leadership priority using the show atm pnni election privileged EXEC command:

Switch# show atm pnni election

PGL Status.............: PGL
Preferred PGL..........: (1) Switch
Preferred PGL Priority.: 255
Active PGL.............: (1) Switch
Active PGL Priority....: 255
Active PGL For.........: 00:01:07
Current FSM State......: PGLE Operating: PGL
Last FSM State.........: PGLE Awaiting Unanimity
Last FSM Event.........: Unanimous Vote

Configured Priority....: 205
Advertised Priority....: 255
Conf. Parent Node Index: 2
PGL Init Interval......: 15 secs
Search Peer Interval...: 75 secs
Re-election Interval...: 15 secs
Override Delay.........: 30 secs

The following example shows all nodes in the peer group using the show atm pnni election peers command:

Switch# show atm pnni election peers

  Node No.   Priority   Connected   Preferred PGL
  ~~~~~~~~   ~~~~~~~~   ~~~~~~~~~   ~~~~~~~~~~~~~
  1          255        Yes         Switch
  9          0          Yes         Switch
  10         0          Yes         Switch
  11         0          Yes         Switch
  12         0          Yes         Switch

Configuring a Summary Address

Summary addresses can be used to decrease the amount of information advertised by a PNNI node. Summary addresses should only be used when all end system addresses that match the summary address are directly reachable from this node. However, this is not always required because routes are always selec