ATM Switch Router Software Configuration Guide, 12.0(22)W5(25) - Configuring Resource Management [Cisco Catalyst 8500 Series Multiservice Switch Routers]

Table Of Contents

Configuring Resource Management

Resource Management Functions

Switch Fabric Functionality (Catalyst 8540 MSR)

Processor Feature Card Functionality (Catalyst 8510 MSR and LightStream 1010)

Configuring Global Resource Management

Configuring the Default QoS Objective Table

Configuring the Switch Oversubscription Factor (Catalyst 8510 MSR and LightStream 1010)

Configuring the Service Category Limit (Catalyst 8510 MSR and LightStream 1010)

Configuring the ABR Congestion Notification Mode (Catalyst 8510 MSR and LightStream 1010)

Configuring the Connection Traffic Table

CTT Row Allocations and Defaults

Configuring the Sustainable Cell Rate Margin Factor

Overview of Threshold Groups

Configuring Physical Interfaces

Configuring the Interface Maximum Queue Size (Catalyst 8510 MSR and LightStream 1010)

Configuring the Interface Queue Thresholds per Service Category (Catalyst 8510 MSR and LightStream 1010)

Configuring Interface Output Pacing

Configuring Controlled Link Sharing

Configuring the Scheduler and Service Class

Configuring Physical and Logical Interface Parameters

Configuring the Interface Link Distance

Configuring the Limits of Best-Effort Connections

Configuring the Interface Maximum of Individual Traffic Parameters

Configuring the ATM Default CDVT and MBS

Configuring Interface Service Category Support

Configuring Interface Overbooking

Displaying the Interface Overbooking Configuration

Configuring Framing Overhead

Displaying the Framing Overhead Configuration

Configuring Resource Management

This chapter describes resource management, which involves modeling and managing switch, interface, and connection resources. Such resources include equivalent bandwidth and buffering to support the provision of specified traffic classes.

Note This chapter provides advanced configuration instructions for the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. For detailed descriptions of traffic management mechanisms and their operation, 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:

• Resource Management Functions

• Resource Management Functions

• Switch Fabric Functionality (Catalyst 8540 MSR)

• Processor Feature Card Functionality (Catalyst 8510 MSR and LightStream 1010)

• Configuring Global Resource Management

• Configuring Physical Interfaces

• Configuring Physical and Logical Interface Parameters

• Configuring Interface Overbooking

• Configuring Framing Overhead

Note The traffic and resource management features of the ATM switch router are presented in a different order in this guide and in the Guide to ATM Technology. In this guide the sequence of features follows configuration scope and proceeds from global to per-interface features. In the Guide to ATM Technology the sequence of features follows the phases of a connection and proceeds from traffic contract to management of hardware resources.

Resource Management Functions

The ATM switch router resource management software provides the following functions:

•Network management interface—Includes operational configuration changes (take place immediately), proposed configuration changes (take place on restart), user interface, and status.

•Default quality of service (QoS) objective table management—Since User-Network Interface 3 (UNI 3) signalling does not provide information elements to signal QoS values, resource management provides a table that contains default values for QoS.

•Connection Traffic Table (CTT) management—Rather than store traffic parameters for each connection in that connection's data structure, resource management manages a table of connection traffic parameters, used by network and connection management.

•Hardware resource management (Catalyst 8540 MSR)—The switch processor feature card provides functionality that include statistic collection, and traffic policing usage parameter control (UPC). See the "Configuring Global Resource Management" section for detailed information.

•Hardware resource management (Catalyst 8510 MSR and LightStream 1010)—Different sets of functionality are available with feature card per-class queueing (FC-PCQ) and feature card per-flow queueing (FC-PFQ). FC-PCQ features include switch cell priority limits, interface queue sizes, and thresholds. FC-PFQ features include threshold group configuration. The interface pacing feature is available with both feature cards. See the "Processor Feature Card Functionality (Catalyst 8510 MSR and LightStream 1010)" section for detailed information.

•Resource Call Admission Control (RCAC)—Determines whether a virtual channel connection/virtual path connection (VCC/VPC) can be admitted (allowed to be set up), based on the available connection resources and requested traffic characteristics.

•Logical interface creation and deletion.

•Private Network-Network Interface (PNNI) metrics—resource management supplies PNNI with link metrics for connection routing.

Switch Fabric Functionality (Catalyst 8540 MSR)

The switch fabric for the Catalyst 8540 MSR provides the required ATM Forum Traffic Management features as described in Table 8-1.

Table 8-1 Switch Processor Feature Card

Feature

Description

Traffic classes:

CBR¹, VBR-RT², VBR-NRT³, UBR⁴, ABR⁵(EFCI)⁶

Output queuing

Per-VC or per-VP

Output scheduling

RS⁷ and WRR⁸

Intelligent early packet discard

Multiple dynamic thresholds

Intelligent tail (partial) packet discard

Supported

Selective cell marking and discard

Multiple, weighted, dynamic thresholds

Shaping

Per-port pacing, per-CBR VC, per-CBR transit VP, per-shaped CBR VP tunnel (128 shaped VP tunnels total), and hierarchical VP tunnels

Policing (UPC⁹)¹⁰

Dual leaky bucket

Frame mode VC-merge

Supported

Point-to-multipoint VC (multicast)

Multiple leafs per output port, per point-to-multipoint

Network clock switchover¹⁰

Programmable clock selection criteria

Nondisruptive snooping

Per-VC or per-VP

Hierarchical VP tunnel

Maximum of 240 VP tunnels.

¹CBR = constant bit rate

²VBR-RT = variable bit rate real time

³VBR-NRT = variable bit rate non-real time

⁴UBR = unspecified bit rate

⁵ABR = available bit rate

⁶EFCI = explicit forward congestion indication

⁷RS = rate scheduling

⁸WRR = weighted round-robin

⁹UPC = usage parameter control

¹⁰Performed by feature card

Processor Feature Card Functionality (Catalyst 8510 MSR and LightStream 1010)

Two types of feature cards are available for the Catalyst 8510 MSR and LightStream 1010 ATM switch routers: FC-PCQ and FC-PFQ. Each card provides the required ATM Forum Traffic Management features. FC-PCQ contains a subset of the FC-PFQ features, as described in Table 8-2.

Note To determine which feature card you have installed, enter the show hardware EXEC command. Either FeatureCard1, for FC-PCQ, or FC-PFQ displays in the Ctrlr-Type column.

Table 8-2 FC-PCQ and FC-PFQ Feature Comparison

Feature

FC-PCQ

FC-PFQ

Traffic classes

CBR¹, VBR-RT², VBR-NRT³, ABR⁴ (EFCI⁵ and RR⁶), UBR⁷

CBR, VBR-RT, VBR-NRT, ABR (EFCI and RR), UBR

Output queuing

Four classes per port

Per-VC or per-VP

Output scheduling

SP⁸

RS⁹ and WRR¹⁰

Intelligent early packet discard

Multiple fixed thresholds

Multiple dynamic thresholds

Intelligent tail (partial) packet discard

Supported

Supported

Selective cell marking and discard

Multiple fixed thresholds

Multiple, weighted, dynamic thresholds

Shaping

Per-port (pacing)

Per-port pacing, per-CBR VC, per-CBR transit VP, per-shaped CBR VP tunnel (128 shaped VP tunnels total), and hierarchical VP tunnels

Policing (UPC¹¹)

Dual mode, single leaky bucket

Dual leaky bucket

Point-to-multipoint VC (multicast)

One leaf per output port, per point-to-multipoint

Multiple leafs per output port, per point-to-multipoint

Network clock switch over

Automatic upon failure

Programmable clock selection criteria

Nondisruptive snooping

Per-port transmit or receive

Per-VC or per-VP

Hierarchical VP tunnel¹²

-

Maximum of 62 VP tunnels

¹CBR = constant bit rate

²VBR-NT = variable bit rate real time

³VBR-NRT = variable bit rate non-real time

⁴ABR = available bit rate

⁵EFCI = explicit forward congestion indication

⁶RR = relative rate

⁷UBR = unspecified bit rate

⁸SP = strict priority

⁹RS = rate scheduling

¹⁰WRR = weighted round-robin

¹¹UPC = usage parameter control

¹²Available with FC-PFQ only

Configuring Global Resource Management

Global resource management configurations affect all interfaces on the switch. The following sections describe global resource management tasks:

• Configuring the Default QoS Objective Table

• Configuring the Switch Oversubscription Factor (Catalyst 8510 MSR and LightStream 1010)

• Configuring the Service Category Limit (Catalyst 8510 MSR and LightStream 1010)

• Configuring the ABR Congestion Notification Mode (Catalyst 8510 MSR and LightStream 1010)

• Configuring the Connection Traffic Table

• Configuring the Connection Traffic Table

• Configuring the Sustainable Cell Rate Margin Factor

• Overview of Threshold Groups

Configuring the Default QoS Objective Table

Resource management provides a table of default objective values for quality of service (QoS) for guaranteed service categories. These default values—either metrics or attributes—are used as the criteria for connection setup requirements when values are not present the in received setup message.

Note Default objective values for QoS for guaranteed service categories can be configured for for UNI signalling.

Table 8-3 lists the default values of the QoS objective table.

Table 8-3 Default QoS Objective Table Row Contents

Service
Category

Max Cell Transfer
Delay (clp01)

Peak-to-Peak Cell Delay Variation (clp01)

Cell Loss
Ratio (clp0)

Cell Loss Ratio
(clp0+1)

CBR

Undefined

Undefined

Undefined

Undefined

VBR-RT

Undefined

Undefined

Undefined

Undefined

VBR-NRT

—

—

Undefined

Undefined

Each objective can have a default defined or undefined value. If undefined, the objective is not considered in connection setup. The table should be configured with the same default values for an entire network.

To configure the default QoS objective table, perform the following tasks in global configuration mode:

Command

Purpose

Step 1

Switch(config)# atm qos default {cbr | vbr-rt} max-cell-transfer-delay {microseconds | any}

Configures the ATM QoS default CBR or VBR-RT maximum cell transfer delay value.

Step 2

Switch(config)# atm qos default {cbr | vbr-rt} peak-to-peak- cell-delay variation {microseconds | any}

Configures the ATM QoS default CBR or VBR-RT peak-to-peak cell delay variation value.

Step 3

Switch(config)# atm qos default {cbr | vbr-rt | vbr-nrt} max-cell-loss-ratio [clp0 | clp1plus0] {loss-ratio-exponent | any}

Configures the ATM QoS default CBR, VBR-RT, or VBR-NRT maximum cell loss ratio value.

Example

The following example shows how to configure the default constant bit rate (CBR) maximum cell loss ratio objective for cell loss priority (CLP) = 0+1 to 10^-12 cells per second:
Switch(config)# atm qos default cbr max-cell-loss-ratio clp1plus0 12
Displaying the ATM QoS Objective Table

To display the default QoS objective table, use the following EXEC command:

Command

Purpose

show atm qos-defaults

Displays the ATM QoS objective table configuration.

The per-service category, maximum cell transfer delay, peak-to-peak cell delay variation, and maximum cell loss ratio objectives are displayed.

Example

The ATM QoS objective table configuration is displayed in the following example:
Switch> show atm qos-defaults
Default QoS objective table:
    Max cell transfer delay (in microseconds): any cbr, any vbr-rt
    Peak-to-peak cell  delay variation (in microseconds): any cbr, any vbr-rt
    Max cell loss ratio for CLP0 cells: any cbr, any vbr-rt, any vbr-nrt
    Max cell loss ratio for CLP0+1 cells:  10**(-12) cbr, any vbr-rt, any vbr-nrt
Configuring the Switch Oversubscription Factor (Catalyst 8510 MSR and LightStream 1010)

The switch oversubscription factor (OSF) feature on the Catalyst 8510 MSR and LightStream 1010 ATM switch routers is used in determining initial port maximum queue sizing for variable bit rate non-real time (VBR-NRT) and available bit rate/unspecified bit rate (ABR/UBR) queues.

Note Over subscription factor configuration is only possible on switches with FC-PCQ installed.

The size of the VBR-NRT queue and ABR/UBR queues is determined by the following equations, where the default size of the CBR and VBR-RT queues vary by interface type, as listed in Table 8-4:
Default Size (VBR-NRT) = 0.25 * ((OSF * 2048) - DefaultSize(CBR) - DefaultSize (VBR-RT))
Default Size (ABR-UBR) = 0.75 * ((OSF * 2048) - DefaultSize(CBR) - DefaultSize (VBR-RT))
Table 8-4 Default CBR and VBR Determined by Interface Type

Interface Type

Default Max Size CBR Queue

Default Max Size Type
VBR-RT Queue

SONET

256

256

DS3/E3

256

512

To configure the OSF, use the following global configuration command:

Command

Purpose

atm over-subscription-factor o-value

Configures the switch OSF from 1 to 32.

Note This value can be changed at any time, but it is only used at start-up and when a module is hot-swapped from the chassis.

Example

The following example shows how to set the switch oversubscription factor to 16:
Switch(config)# atm over-subscription-factor 16
Displaying the OSF Configuration (Catalyst 8510 MSR and LightStream 1010)

To display the OSF configuration, use the following EXEC command:

Command

Purpose

show atm resource

Displays the OSF configuration.

Note The following examples differ depending on the feature card installed in your switch.

Examples

The following example shows the switch OSF configuration with FC-PCQ installed:
Switch> show atm resource
Resource configuration:
    Over-subscription-factor 16  Sustained-cell-rate-margin-factor 1%
    Abr-mode:   relative-rate
    Atm service-category-limit (in cells):
         64544 cbr 64544 vbr-rt 64544 vbr-nrt 64544 abr-ubr
Resource state:
    Cells per service-category:
         0 cbr 0 vbr-rt 0 vbr-nrt 0 abr-ubr
Configuring the Service Category Limit (Catalyst 8510 MSR and LightStream 1010)

The service category limit configuration restricts the number of cells admitted into the switch, as determined by the type of output queues.

Note Service category limit configuration is only possible on switches with FC-PCQ installed.

Caution Setting a service category limit to 0 causes the connection requests for the associated service categories to be rejected.

To configure the service category limits, use the following global configuration command:

Command

Purpose

atm service-category-limit {cbr | vbr-rt | vbr-nrt | abr-ubr} value

Configures ATM service category limits for a specific output queue.

Note The atm service-category-limit command affects all connections, including those already established.

Example

The following example shows how to change the service category limit for the CBR cells within the switch fabric to 3000 cells:
Switch(config)# atm service-category-limit cbr 3000
Displaying the Service Category Limit Configuration (Catalyst 8510 MSR and LightStream 1010)

To display the service category limit configuration, use the following EXEC command:

Command

Purpose

show atm resource

Displays the service category limits configuration.

Example

The following example shows the service category limits configuration:
Switch> show atm resource
Resource configuration:
    Over-subscription-factor 16  Sustained-cell-rate-margin-factor 1%
    Abr-mode:   relative-rate
    Atm service-category-limit (in cells):
         3000 cbr 64544 vbr-rt 64544 vbr-nrt 64544 abr-ubr
Resource state:
    Cells per service-category:
         0 cbr 0 vbr-rt 0 vbr-nrt 0 abr-ubr
Configuring the ABR Congestion Notification Mode (Catalyst 8510 MSR and LightStream 1010)

The available bit rate (ABR) congestion notification mode changes the type of notification used on ABR connections to alert the end station of congestion. ABR mode configuration determines whether ABR uses explicit forward congestion indication (EFCI) marking, relative-rate marking, or both, for rate management on ABR connections.

The global configuration function is used to modify the ABR mode selection for all ABR connections.

To configure the ABR mode, use the following global configuration command:

Command

Purpose

atm abr-mode {efci | relative-rate | all}

Configures ABR congestion notification mode.

Note The atm abr-mode command affects all connections, including those already established.

Example

The following example shows how to configure the entire switch to set the EFCI bit whenever a cell arrives on a congested ABR connection:
Switch(config)# atm abr-mode efci
Displaying the ABR Congestion Notification Mode Configuration (Catalyst 8510 MSR and LightStream 1010)

To display the ABR congestion notification mode configuration, use the following EXEC command:

Command

Purpose

show atm resource

Displays the ABR congestion notification mode configuration.

Note The following examples differ depending on the feature card installed in your switch.

Examples

The following example shows the ABR mode configuration with FC-PCQ installed:
Switch> show atm resource
Resource configuration:
    Over-subscription-factor 16  Sustained-cell-rate-margin-factor 1%
    Abr-mode: efci
    Atm service-category-limit (in cells):
         3000 cbr 64544 vbr-rt 64544 vbr-nrt 64544 abr-ubr
Resource state:
    Cells per service-category:
         0 cbr 0 vbr-rt 0 vbr-nrt 0 abr-ubr
The following example shows the ABR mode configuration with FC-PFQ installed:
Switch> show atm resource
Resource configuration:
    Over-subscription-factor 8  Sustained-cell-rate-margin-factor 1%
    Abr-mode:   efci
    Service Category to Threshold Group mapping:
     cbr 1 vbr-rt 2 vbr-nrt 3 abr 4 ubr 5
    Threshold Groups:
    Group Max    Max Q  Min Q  Q thresholds  Cell  Name
          cells  limit  limit  Mark Discard  count
          instal instal instal
    ---------------------------------------------------
     1    65535  63     63     25 %  87 %      0     cbr-default-tg
     2    65535  127    127    25 %  87 %      0     vbrrt-default-tg
     3    65535  511    31     25 %  87 %      0     vbrnrt-default-tg
     4    65535  511    31     25 %  87 %      0     abr-default-tg
     5    65535  511    31     25 %  87 %      0     ubr-default-tg
     6    65535  1023   1023   25 %  87 %      0     well-known-vc-tg
Configuring the Connection Traffic Table

A row in the connection traffic table (CTT) must be created for each unique combination of traffic parameters. Virtual path links (VPLs) and virtual channel links (VCLs) then specify traffic by specifying a row in the table per flow (receive and transmit). Many VCL/VPLs can refer to the same row in the traffic table.

The following two subsections outline the differences in the CTT feature according to platform and feature card.

CTT Supported Features (Catalyst 8540 MSR)

The rows corresponding to various service categories support the following features on the Catalyst 8540 MSR.

•Non-zero minimum cell rate (MCR) for UBR+ service categories. UBR+ is a variant of UBR, in which peak cell rate (PCR), MCR, and cell delay variation tolerance (CDVT) are specified in the traffic contract, with a guarantee on MCR.

•Both CDVT and maximum burst size (MBS) for VBR rows. Dual-leaky-bucket UPC is allowed.

•Whether SCR applies to either the CLP0 or CLP0+1 flow of cells. Only one or the other of these flows can be policed.

CTT Supported Features (Catalyst 8510 MSR and LightStream 1010)

ATM switch routers with feature card per-flow queuing (FC-PFQ) and software version 11.2(8) or later have more rows of various service categories that allow you to specify the following features:

•Non-zero minimum cell rate (MCR) for ABR and UBR+ service categories. UBR+ is a variant of UBR, in which peak cell rate (PCR), MCR, and cell delay variation tolerance (CDVT) are specified in the traffic contract, with a guarantee on MCR.

•Both CDVT and maximum burst size (MBS) for VBR rows. FC-PFQ allows dual-leaky-bucket UPC.

•Whether SCR applies to either the CLP0 or CLP0+1 flow of cells. FC-PFQ can police one or the other of these flows.

If your switch has FC-PCQ installed on the route processor you cannot take advantage of these new capabilities. CTT rows specifying these new parameters can be configured with FC-PCQ installed, with the following effect:

•Non-zero MCR is not supported. Requests for connections specifying non-zero MCR are rejected.

•On VBR connections, only SCR and MBS are used for UPC, and policing is done only on the CLP0+1 flow of cells.

PVC Connection Traffic Rows

The CTT in a permanent virtual channel (PVC) setup requires storing PVC traffic values in a CTT data structure. Rows used for PVCs are called stable rows, and contain traffic parameters.

SVC Connection Traffic Rows

The CTT in a switched virtual channel (SVC) setup provides a row identifier that Simple Network Management Protocol (SNMP) or the user interface can use to read or display SVC traffic parameters. A CTT row index is stored in the connection-leg data structure for each flow of the connection.

Note Rows cannot be deleted while in use by a connection.

CTT Row Allocations and Defaults

To make CTT management software more efficient, the CTT row-index space is split into rows allocated as a result of signalling and rows allocated from the command-line interface (CLI) and SNMP. Table 8-5 describes the row-index range for both.

Table 8-5 CTT Row-Index Allocation

Allocated by

Row-index range

ATOMMIB Traffic Descriptor Table or CLI connection-traffic-table-row creation

1 through 1,073,741,823

Signalling VxL creation

1,073,741,824 through 2,147,483,647

Table 8-6 describes the well-known, predefined ATM CTT rows.

Table 8-6 Default ATM Connection Traffic Table Rows

CTT Row
Index

Service
Category

Peak-Cell-Rate
(clp01)

Sustained-
Cell-Rate
(clp01)

Tolerance

Use

1

UBR

7,113,539

—

None

Default PVP/PVC row index

2

CBR

424 kbps

—

None

CBR tunnel well-known (WK) VCs

3

VBR-RT

424 kbps

424 kbps

50

Physical interface/VBR-RT WK VCs

4

VBR-NRT

424 kbps

424 kbps

50

VBR-NRT tunnel WK VCs

5

ABR

424 kbps

—

None

—

6

UBR

424 kbps

—

None

UBR tunnel WK VCs

The atm connection-traffic-table-row command supports these service categories: CBR, VBR-RT, VBR-NRT, ABR, and UBR. To create or delete an ATM CTT row, perform the following tasks in global configuration mode:

Note Your CTT feature set depends on the type of feature card that is installed on the Catalyst 8510 MSR and LightStream 1010 ATM switch routers route processor.

Command

Purpose

Step 1

Switch(config)# atm connection-traffic-table-row [index row-index] {vbr-rt | vbr-nrt} pcr pcr-value {scr0 | scr10} scr-value [mbs mbs-value] [cdvt cdvt_value]

Configures an ATM CTT VBR row.

Step 2

Switch(config)# atm connection-traffic-table-row [index row-index] cbr pcr pcr-value [cdvt cdvt-value]

Configures an ATM CTT CBR row.

Step 3

Switch(config)# atm connection-traffic-table-row [index row-index] abr pcr pcr-value [mcr mcr-value] [cdvt cdvt-value]

Configures an ATM CTT ABR row.

Step 4

Switch(config)# atm connection-traffic-table-row [index row-index] ubr pcr pcr-value [mcr mcr-value] [cdvt cdvt-value]

Configures an ATM CTT UBR row.

If you do not specify an index row number, the system software determines if one is free and displays it in the allocated index field if the command is successful.

Example

The following example shows how to configure an ATM CTT row with an ABR peak cell rate of 30,000 kilobits per second:
Switch(config)# atm connection-traffic-table-row abr pcr 30000
 Allocated index = 63999
Displaying the ATM Connection Traffic Table

To display the CTT configuration, use the following EXEC command:

Command

Purpose

show atm connection-traffic-table [row row-index | from-row row-index]

Displays the CTT configuration.

Example

The following example shows how to display the CTT configuration table:
Switch> show atm connection-traffic-table
Row      Service-category    pcr        scr/mcr       mbs         cdvt
1            ubr          7113539        none                     none
2            cbr              424                                 none
3            vbr-rt           424         424          50         none
4            vbr-nrt          424         424          50         none
5            abr              424           0                     none
6            ubr              424        none                     none
64000        cbr             1741                                 none
2147483645*  ubr                0        none                     none
2147483646*  ubr                1        none                     none
2147483647*  ubr          7113539        none                     none
Configuring the Sustainable Cell Rate Margin Factor

The sustained cell rate margin factor determines the aggressiveness of weighting sustainable cell rate (SCR) compared to peak cell rate (PCR). It uses the connection admission control algorithm in admitting VBR connections.

To configure the SCR for your ATM switch router, use the following global configuration command:

Command

Purpose

atm sustained-cell-rate-margin-factor s-value

Configures the sustained cell rate margin factor.

Note The atm sustained-cell-rate-margin-factor command affects subsequent connections but not connections that are already established.

Example

The following example shows how to configure the SCR margin factor as 85 percent of maximum:
Switch(config)# atm sustained-cell-rate-margin-factor 85
Displaying the SCR Margin Configuration

To display the SCR margin factor configuration, use the following EXEC command:

Command

Purpose

show atm resource

Displays the SCR margin factor configuration.

Example

The following example shows the SCR margin factor configuration:
Switch> show atm resource
Resource configuration:
Sustained-cell-rate-margin-factor 85%
    Abr-mode:   EFCI
    Service Category to Threshold Group mapping:
     cbr 1 vbr-rt 2 vbr-nrt 3 abr 4 ubr 5
    Threshold Groups:
 Module   Group Max    Max Q  Min Q  Q thresholds  Cell  Name
  ID            cells  limit  limit  Mark Discard  count
                instal instal instal
 ------------------------------------------------------------
  1        1    131071  63     63     25 %  87 %      0     cbr-default-tg
           2    131071  127    127    25 %  87 %      0     vbrrt-default-tg
           3    131071  511    31     25 %  87 %      0     vbrnrt-default-tg
           4    131071  511    31     25 %  87 %      0     abr-default-tg
           5    131071  511    31     25 %  87 %      0     ubr-default-tg
           6    131071  1023   1023   25 %  87 %      0     well-known-vc-tg
===========================================================
  2        1    131071  63     63     25 %  87 %      0     cbr-default-tg
           2    131071  127    127    25 %  87 %      0     vbrrt-default-tg
           3    131071  511    31     25 %  87 %      0     vbrnrt-default-tg
           4    131071  511    31     25 %  50 %      0     abr-default-tg
           5    131071  511    31     25 %  87 %      0     ubr-default-tg
           6    131071  1023   1023   25 %  87 %      0     well-known-vc-tg
===========================================================
  7        1    131071  63     63     25 %  87 %      0     cbr-default-tg
           2    131071  127    127    25 %  87 %      0     vbrrt-default-tg
           3    131071  511    31     25 %  87 %      0     vbrnrt-default-tg
           4    131071  511    31     25 %  87 %      0     abr-default-tg
           5    131071  511    31     25 %  87 %      0     ubr-default-tg
           6    131071  1023   1023   25 %  87 %      0     well-known-vc-tg
===========================================================
  8        1    131071  63     63     25 %  87 %      0     cbr-default-tg
           2    131071  127    127    25 %  87 %      0     vbrrt-default-tg
           3    131071  511    31     25 %  87 %      0     vbrnrt-default-tg
           4    131071  511    31     25 %  87 %      0     abr-default-tg
           5    131071  511    31     25 %  87 %      0     ubr-default-tg
           6    131071  1023   1023   25 %  87 %      0     well-known-vc-tg
===========================================================
Overview of Threshold Groups

Threshold groups combine VCs/VPs to determine per-connection thresholds, based on the use of memory by the group.

Note Threshold groups are supported on the Catalyst 8540 MSR, and on the Catalyst 8510 MSR and LightStream 1010 ATM switch routers equipped with the FC-PFQ feature card.

The initial default configuration of per-VC queueing on the switch has all connections of a service category assigned to one threshold group. However, the assignment of service categories to threshold groups is configurable. A service category cannot be mapped to more than one threshold group. If you configure a service category to a threshold group more than once, the last configuration stays in effect. The default assigns each service category to a different threshold group. However, you can assign more than one service category to a threshold group.

Note The configuration of threshold groups is static, not dynamic.

For a description of how the threshold group feature works, refer to the Guide to ATM Technology.

Table 8-7 lists the configuration parameter defaults.

Table 8-7 Threshold Group Configuration Parameter Defaults

Group

Maximum Cells¹

Maximum Queue Limit²

Minimum Queue Limit³

Mark Threshold⁴

Discard Threshold⁵

Use

1

65,535

63

63

25%

87%

CBR

2

65,535

127

127

25%

87%

VBR-RT

3

65,535

511

31

25%

87%

VBR-NRT

4

65,535

511

31

25%

87%

ABR

5

65,535

511

31

25%

87%

UBR

6

65,535

1023

1023

25%

87%

well-known VCs

¹Maximum number of cells in threshold group

²Maximum (uncongested) per-VC queue limit in cells

³Minimum (congested) per-VC queue limit in cells

⁴Marking threshold percent full of per-VC queue

⁵Discard threshold percent full of per-VC queue

Configuring the Threshold Group

To configure the threshold groups on a ATM switch router, perform the following tasks in global configuration mode:

Command

Purpose

Step 1

Switch(config)# atm threshold-group service {cbr | vbr-rt | vbr-nrt | abr | ubr} group

Assigns a service category to a threshold group.

Step 2

Switch(config)# atm threshold-group [module-id module]¹ group max-cells number

Configures the maximum number of cells queued for all connections that are members of the threshold group.

Step 3

Switch(config)# atm threshold-group [module-id module]¹ group discard-threshold percent

Configures the threshold of per-connection queue-full at which the queue is considered full for CLP² discard and EPD³.

Step 4

Switch(config)# atm threshold-group [module-id module]¹ group max-queue-limit number

Configures the largest per-VC queue limit that is applied to connections in the threshold group.

Step 5

Switch(config)# atm threshold-group [module-id module]¹ group min-queue-limit number

Configures the smallest per-VC queue-limit that is applied to connections in the threshold group.

Step 6

Switch(config)# atm threshold-group [module-id module]¹ group name name

Configures the name associated with a threshold group.

Step 7

Switch(config)# atm threshold-group [module-id module]¹ group max-cells number

Configures the maximum number of cells queued for specified threshold group for all module-ids.⁴ Optionally, configure for the specified threshold group for the specified module-id.

Step 8

Switch(config)# atm threshold-group [module-id module]¹ group marking-threshold percent

Configures the threshold of per-connection queue-full at which the queue is considered full for EFCI marking and ABR relative-rate marking.

¹The module-id identifier is only supported on the Catalyst 8540 MSR.

²CLP = cell loss priority

³EPD = early packet discard

⁴Each module on the Catalyst 8540 MSR has its own cell memory and threshold groups. There are eight of these modules in a 20 gigabyte configuration. Each module has a 64 kbps cell memory, and the threshold groups can be configured per module. By default, all the threshold groups of all the modules are configured identically.

Example

The following example shows how to configure ATM threshold group 5 with a maximum number of cells before the cells are discarded:
Switch(config)# atm threshold-group 5 max-cells 50000
Displaying the Threshold Group Configuration

To display the threshold group configuration, use the following user EXEC command:

Command

Purpose

show atm resource

Displays the threshold group configuration.

Example

The following example displays the threshold group configuration:
Switch> show atm resource
Resource configuration:
Sustained-cell-rate-margin-factor 1%
    Abr-mode:   EFCI
    Service Category to Threshold Group mapping:
     cbr 1 vbr-rt 2 vbr-nrt 3 abr 4 ubr 5
    Threshold Groups:
 Module   Group Max    Max Q  Min Q  Q thresholds  Cell  Name
  ID            cells  limit  limit  Mark Discard  count
                instal instal instal
 ------------------------------------------------------------
  1        1    131071  63     63     25 %  87 %      0     cbr-default-tg
           2    131071  127    127    25 %  87 %      0     vbrrt-default-tg
           3    131071  511    31     25 %  87 %      0     vbrnrt-default-tg
           4    131071  511    31     25 %  87 %      0     abr-default-tg
           5    131071  511    31     25 %  87 %      0     ubr-default-tg
           6    131071  1023   1023   25 %  87 %      0     well-known-vc-tg
===========================================================
  2        1    131071  63     63     25 %  87 %      0     cbr-default-tg
           2    131071  127    127    25 %  87 %      0     vbrrt-default-tg
           3    131071  511    31     25 %  87 %      0     vbrnrt-default-tg
           4    131071  511    31     25 %  50 %      0     abr-default-tg
           5    131071  511    31     25 %  87 %      0     ubr-default-tg
           6    131071  1023   1023   25 %  87 %      0     well-known-vc-tg
===========================================================
<information deleted>
Configuring Physical Interfaces

Physical interface resource management configurations affect only specific interfaces on the switch. The following sections describe physical interface configuration resource management tasks:

• Configuring the Interface Maximum Queue Size (Catalyst 8510 MSR and LightStream 1010)

• Configuring the Interface Queue Thresholds per Service Category (Catalyst 8510 MSR and LightStream 1010)

• Configuring Interface Output Pacing

• Configuring Controlled Link Sharing

• Configuring the Scheduler and Service Class

Configuring the Interface Maximum Queue Size (Catalyst 8510 MSR and LightStream 1010)

Maximum queue size feature on the Catalyst 8510 MSR and LightStream 1010 ATM switch routers is used to determine the following:

•Maximum number of cells in the switch fabric queue

•Maximum cell transfer delay (CTD)

•Peak-to-peak cell delay variation (CDV) provided on an output switch interface

Note Interface maximum queue size configuration is only possible on switches with FC-PCQ installed on your route processor.

Because not all queue size values are supported by the switch fabric, the value installed is displayed, as well as the configuration value requested. The value installed is always greater than or equal to that requested.

To configure the maximum queue size, perform the following tasks, beginning in global configuration mode:

Command

Purpose

Step 1

Switch(config)# interface atm card/subcard/port

Switch(config-if)#

Selects the interface to be configured.

Step 2

Switch(config-if)# atm output-queue [force] {cbr | vbr-rt | vbr-nrt | abr-ubr} max-size number

Configures the ATM output queue maximum size.

Note The atm output-queue command affects all connections, including those already established.

This command is not applicable for subinterface level configuration. For other restrictions, refer to the ATM Switch Router Command Reference publication.

If the interface status is up, the force parameter is required before the request is completed. If the request is forced, output on the interface is briefly disabled, cells on the output queue are discarded, and the queue size is changed to the new limit. Any impact on existing connections by the implicit change in guaranteed maximum CTD and peak-to-peak CDV is not considered before making the change. Subsequent setup of switched virtual channel (SVC) connections will be affected.

Note The queue must be momentarily disabled to change the threshold.

Example

The following example shows how to configure the CBR ATM output queue maximum size to 30,000 cells:
Switch(config)# interface atm 3/0/0
Switch(config-if)# atm output-queue force cbr max-size 30000
Displaying the Output Queue Maximum Configuration (Catalyst 8510 MSR and LightStream 1010)

To display the output queue maximum size configuration, use the following user EXEC command:

Command

Purpose

show atm interface resource atm card/subcard/port

Displays the output queue maximum size configuration.

Example

The following example displays the interface output queue maximum size configuration with FC-PCQ installed:
Switch> show atm interface resource atm 3/0/0
Resource Management configuration:
    Output queues:
               Max sizes(explicit cfg): 30000  cbr, none vbr-rt, none vbr-nrt, none abr-ubr
        Max sizes(installed): 30208 cbr, 256 vbr-rt, 4096 vbr-nrt, 12032 abr-ubr
        Efci threshold: 25% cbr, 25% vbr-rt, 25% vbr-nrt, 25% abr, 25% ubr
        Discard threshold: 87% cbr, 87% vbr-rt, 87% vbr-nrt, 87% abr, 87% ubr
        Abr-relative-rate threshold: 25% abr
    Pacing: disabled   0 Kbps rate configured, 0 Kbps rate installed
    Service Categories supported: cbr,vbr-rt,vbr-nrt,abr,ubr
    Link Distance: 0 kilometers
    Controlled Link sharing:
        Max aggregate guaranteed services: none RX,  none TX
        Max bandwidth: none cbr RX, none cbr TX, none vbr RX, none vbr TX,
                       none abr RX, none abr TX, none ubr RX, none ubr TX
        Min bandwidth: none cbr RX, none cbr TX, none vbr RX, none vbr TX,
                       none abr RX, none abr TX, none ubr RX, none ubr TX
    Best effort connection limit: disabled  0 max connections
    Max traffic parameters by service (rate in Kbps, tolerance in cell-times):
        Peak-cell-rate RX: none cbr, none vbr, none abr, none ubr
        Peak-cell-