9.3. QoS Fabric Profile Command Reference
9.3.1. Command Hierarchies
9.3.1.1. Configuration Commands
The config>qos>fabric-profile command applies only to the 7705 SAR-8 and 7705 SAR-18; it does not apply to the fixed platforms. The config>system>qos command applies only to the fixed platforms, with the exception of the 7705 SAR-X. The 7705 SAR-X does not support fabric aggregate rate configuration; its shaper rate is set permanently to 16 Gb/s.
9.3.1.2. Operational Commands
9.3.1.3. Show Commands
The show>qos>fabric-profile command applies only to the 7705 SAR-8 and 7705 SAR-18; it does not apply to the fixed platforms. The show>system>qos command applies only to the fixed platforms, with the exception of the 7705 SAR-X. The 7705 SAR-X does not support fabric aggregate rate configuration; its shaper rate is set permanently to 16 Gb/s.
9.3.2. Command Descriptions
9.3.2.1. Configuration Commands
9.3.2.1.1. Generic Commands
description
Syntax
Context
Description
This command creates a text description stored in the configuration file for a configuration context.
The no form of this command removes any description string from the context.
Default
n/a
Parameters
9.3.2.1.2. QoS Fabric Profile Commands
fabric-profile
Syntax
Context
Description
This command is used to configure a QoS fabric profile policy.
The default mode is aggregate-mode, which means that the access-ingress and network-ingress fabric shapers on all adapter cards are set to the same rate, either by default or via the aggregate-rate command. Selecting destination-mode allows each adapter card to have its fabric shapers set to a different rate for unicast traffic and a common rate for BMU traffic, either by default or via the dest-mda rate command.
The default fabric profile is preconfigured and non-modifiable. It cannot be deleted. All other fabric profiles must be explicitly created before use.
The create keyword must follow each new profile configuration.
Default
policy-id 1
aggregate-mode
Parameters
aggregate-rate
Syntax
Context
Description
This command sets the rate of the fabric shapers in aggregate mode, in kb/s. The aggregate-rate represents the maximum bandwidth that an adapter card can switch through its fabric interface. Each fabric shaper is set to the same aggregate rate. Using the default keyword sets the aggregate rate to 200 000 kb/s.
The unshaped-sap-cir command is optional. When used, it assigns an aggregate CIR to all unshaped 4-priority SAPs so that the unshaped SAP aggregate rate can compete with the shaped SAPs’ aggregate CIR when the fabric scheduler selects traffic to forward to the switching fabric.
The default cir-rate value is 0 kb/s. If the cir-rate is max, then the maximum possible backplane speed for the adapter card, based on the associated fabric policy, is used.
The aggregate-rate can be higher or lower than the cir-rate. If the cir-rate is higher than the aggregate-rate, then the cir-rate is used by the network processor but the end result is that backpressure from the fabric shaper is applied indirectly to the per-SAP queues, as explained below:
- per-SAP (aggregate) shapers—that is, unshaped SAP aggregate CIR or individual shaped SAP CIRs—prioritize traffic towards the fabric shaper based on the cir-rate
- the fabric shaper shapes the traffic at the configured rate
- when the fabric shaper becomes congested, it applies backpressure to individual SAP shapers—that is, it applies backpressure to the shaped SAPs and to the unshaped SAP aggregate, which in turn apply backpressure to individual unshaped queues
The same fabric-profile binding can be used for either network or access on a per-adapter card basis. However, the unshaped-sap-cir is not applicable when bound to network ingress.
Default
200000 (“default”) for aggregate-rate
0 for cir-rate
Parameters
dest-mda
Syntax
Context
Description
This command enables the context for setting the rate for per-destination mode shapers on a specific adapter card or all adapter cards. Using the slot/mda parameter specifies a particular destination adapter card. Using the multipoint keyword specifies that all adapter cards are destination cards and they will have their rate configured to the same value. The value of the rate is configured using the rate command.
Parameters
rate
Syntax
Context
Description
This command sets the rate of the fabric shapers in per-destination mode, in kb/s. When the multipoint keyword is used in the dest-mda command, rate sets the bandwidth available to multipoint traffic through the fabric shapers; all adapter card shapers are set to the same value.
Using the default keyword sets the rate to 200 000 kb/s.
Default
200000 (“default”)
Parameters
9.3.2.1.3. Fixed Platform Fabric Shaping Commands
access-ingress-aggregate-rate
Syntax
Context
Description
This command sets the rate for fabric shapers on the 7705 SAR-A, 7705 SAR-Ax, 7705 SAR-H, 7705 SAR-Hc, 7705 SAR-M, 7705 SAR-W, or 7705 SAR-Wx for access ingress traffic. The rate represents the maximum bandwidth that the node can switch through its fabric interface. Only aggregate mode is supported.
This command is not supported on the 7705 SAR-X, where the shaper rate is set permanently to 16 Gb/s.
The unshaped-sap-cir command is optional. When used, it assigns a cir-rate to the unshaped SAP aggregate so that the unshaped SAP aggregate rate can compete with the shaped SAPs when the round-robin fabric scheduler selects traffic to forward to the switching fabric. When not used, the cir-rate is set to its default value of 0 kb/s. If the cir-rate is max, the maximum possible backplane speed is used.
The access-ingress-aggregate-rate can be higher or lower than the cir-rate. If the cir-rate is higher than the access-ingress-aggregate-rate, then the cir-rate is used by the network processor, but backpressure from the fabric shaper is applied indirectly to the per-SAP queues, as follows:
- per-SAP (aggregate) shapers—that is, unshaped SAP aggregate CIR or individual shaped SAP CIRs—prioritize traffic towards the fabric shaper based on the cir-rate
- the fabric shaper shapes the traffic at the configured rate
- when the fabric shaper becomes congested, it applies backpressure to individual SAP shapers—that is, it applies backpressure to shaped SAPs and to unshaped SAP aggregate, which in turn applies backpressure to individual unshaped queues
Default
500000 (“default”) for access-ingress-aggregate-rate
0 for cir-rate
Parameters
 | Note: The actual supported maximum rates depend on the platform:
|
network-ingress-aggregate-rate
Syntax
Context
Description
This command sets the rate for fabric shapers on the 7705 SAR-A, 7705 SAR-Ax, 7705 SAR-H, 7705 SAR-Hc, 7705 SAR-M, 7705 SAR-W, or 7705 SAR-Wx for network ingress traffic, in kb/s. The rate represents the maximum bandwidth that the node can switch through its fabric interface. Only aggregate mode is supported.
This command is not supported on the 7705 SAR-X, where the shaper rate is set permanently to 16 Gb/s.
Default
2000000 (“default”)
Parameters
| Note: The actual supported maximum rates depend on the platform:
|
9.3.2.2. Operational Commands
copy
Syntax
Context
Description
This command copies a source QoS fabric profile into a destination QoS fabric profile. If the destination profile was already defined, the keyword overwrite must be appended for the copy to complete.
The copy command is a configuration level maintenance tool used to create new profiles using existing profiles. It also allows bulk modifications to an existing profile with the use of the overwrite keyword.
Parameters
9.3.2.3. Show Commands
| Note: The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration. |
fabric-profile
Syntax
Context
Description
This command displays QoS fabric profile information. If policy-id is not included in the command, the CLI shows a list of fabric policies.
Parameters
Output
The following output is an example of QoS fabric profile information, and Table 63 describes the fields.
Table 63: QoS Fabric Profile Command Output
Label | Description |
Policy-id | The fabric profile QoS policy number |
Mode | The fabric profile mode, either aggregate or destination |
Description | The description associated with the fabric profile |
Aggregate-rate | The rate of the fabric shapers in aggregate mode, in kb/s |
Unshaped-sap-cir | The CIR rate of the aggregate SAP shaper for all unshaped 4-priority SAPs, in kb/s |
Destination MDA/Rate (Kbps) | The slot/mda number of the destination adapter card, and the rate of the fabric shapers in per-destination mode, in kb/s |
Associations | The adapter cards to which the specified fabric profile is assigned and in which direction, that is, network ingress to fabric or access ingress to fabric |
qos
Syntax
Context
Description
This command displays system QoS information for the 7705 SAR-A, 7705 SAR-Ax, 7705 SAR-H, 7705 SAR-Hc, 7705 SAR-M, 7705 SAR-W, and 7705 SAR-Wx.
This command is not supported on the 7705 SAR-X.
Output
The following output is an example of system QoS information, and Table 64 describes the fields.
Table 64: QoS Fabric Profile Command Output
Label | Description |
Access Ingress Aggregate Rate | The rate of the access ingress fabric shapers in aggregate mode, in kb/s |
Access Ingress Unshaped Sap CIR | The CIR rate of the access ingress unshaped SAP shapers in aggregate mode, in kb/s |
Network Ingress Aggregate Rate | The rate of the network ingress fabric shapers in aggregate mode, in kb/s |