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.

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.

If the number of queues was changed from the previous queue profile to the new one, any Ethernet or LAG interfaces with locally applied schedule profiles will program the newly applied global schedule-profile. The show running-config interface command will list the existing apply qos schedule-profile command with a comment describing the actual profile applied:

Examples

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

switch(config)# apply qos queue-profile Q1 schedule-profile S1