apply qos

Syntax

apply qos [queue-profile <QUEUE-NAME>] schedule-profile <SCHEDULE-NAME>

no apply qos schedule-profile <SCHEDULE-NAME>

Description

Applies a queue profile and schedule profile globally to all Ethernet and LAG interfaces on the switch, or applies a schedule profile to a specific interface. When applied globally, the specified schedule profile is configured only on Ethernet interfaces and LAGs that do not already have their own schedule profile.

The same profile can be applied both globally and locally to an interface. This guarantees that an interface always uses the specified profile, even if the global profile is changed.

The no form of this command removes the specified schedule profile from an interface and the interface uses the global schedule profile. This is the only way to remove a schedule profile override from the interface.

When applying QoS settings to a port configured to support priority-based flow control, specific configuration settings must be respected when defining a CoS map and queue profile. See the command flow-control in the ArubaOS-CX Command-Line Interface Guide for details.

Interfaces may shut down briefly during reconfiguration.

Command context

config

config-if

config-lag-if

Parameters

queue-profile <QUEUE-NAME>

Specifies the name of the queue profile to apply. Range: 1 to 64 alphanumeric characters, including period (.), underscore (_), and hyphen (-). This parameter is not supported in the config-if context.

schedule-profile <SCHEDULE-NAME>

Specifies the name of the schedule profile to apply. Range: 1 to 64 alphanumeric characters, including period (.), underscore (_), and hyphen (-).

Authority

Administrators or local user group members with execution rights for this command.

Usage

  • The switch must always have a globally-applied queue and schedule profile. To stop using a given profile, apply a different profile.
  • For a queue profile to be complete and ready to be applied, all eight local priorities must be mapped to a queue.
  • For a schedule profile to be complete and ready to be applied, it must define all queues specified in the queue profile. All queues must use the same algorithm, except for the highest numbered queue, which can be strict.
  • Both the queue profile and the schedule profile must specify the same number of queues.
  • Schedule profiles can be modified while applied, but only in ways where a single command will not result in the profile becoming invalid. For example, queue 7 can have the algorithm changed, and weighted queues can have their weights changed.

If there are interfaces running with priority-based flow control (PFC) and a new queue profile to be applied maps a local priority used by the PFC traffic to another queue, all PFC interfaces must be shutdown before applying the new queue profile. If the new queue profile was applied before shutting down the PFC interfaces, PFC traffic will still use the same queue from the previous profile until the interfaces are shutdown then re-enabled.

Examples

The following commands illustrate a valid configuration where every local priority value is assigned to a queue and all assigned queues are defined.

switch(config) map queue 0 local-priority 0

switch(config) map queue 1 local-priority 1

switch(config) map queue 1 local-priority 2

switch(config) map queue 3 local-priority 3

switch(config) map queue 4 local-priority 4

switch(config) map queue 5 local-priority 5

switch(config) map queue 5 local-priority 6

switch(config) map queue 5 local-priority 7

 

switch(config) wfq queue 0 weight 5

switch(config) wfq queue 1 weight 10

switch(config) wfq queue 3 weight 15

switch(config) wfq queue 4 weight 25

switch(config) wfq queue 5 weight 50

The following commands illustrate an invalid configuration because local priority 2 is not assigned to a queue.

switch(config) qos cos-map 1 local-priority 1

switch(config) qos queue-profile Q1

switch(config) map queue 0 local-priority 0

switch(config) map queue 1 local-priority 1

switch(config) map queue 3 local-priority 3

switch(config) map queue 4 local-priority 4

switch(config) map queue 5 local-priority 5

switch(config) map queue 5 local-priority 6

switch(config) map queue 5 local-priority 7

 

switch(config) wfq queue 0 weight 5

switch(config) wfq queue 1 weight 10

switch(config) wfq queue 3 weight 15

switch(config) wfq queue 4 weight 25

switch(config) wfq queue 5 weight 50

Applying the QoS profile myprofile and the schedule profile myschedule to all interfaces that do not have an applied interface-specific schedule profile:

switch(config)# apply qos queue-profile myprofile schedule-profile myschedule