Skip to content

System QoS Policy

A System QoS Policy configures the global Quality of Service classes for a Cisco UCS Fabric Interconnect, defining bandwidth allocation, CoS values, MTU, packet drop behavior, and weight for each traffic class (Best Effort, FC, Platinum, Gold, Silver, Bronze). It is assigned to domain profiles or domain templates.

Location in Intersight GUI: Policies » System QoS

Diagram
NameTypeConstraintMandatoryDefault Value
intersightClassintersightNo

NameTypeConstraintMandatoryDefault Value
organizationsListorganizationsNo

NameTypeConstraintMandatoryDefault Value
policiesClasspoliciesNo

policies (compute.intersight.organizations)

Section titled “policies (compute.intersight.organizations)”
NameTypeConstraintMandatoryDefault Value
system_qosListsystem_qosNo

system_qos (compute.intersight.organizations.policies)

Section titled “system_qos (compute.intersight.organizations.policies)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
descriptionStringNo
managedBooleantrue, falseNotrue
tagsListtagsNo
classesListclassesNo
pfc_watchdogClasspfc_watchdogNo

tags (compute.intersight.organizations.policies.system_qos)

Section titled “tags (compute.intersight.organizations.policies.system_qos)”
NameTypeConstraintMandatoryDefault Value
keyStringYes
valueStringNo
typeChoiceKeyValue, PathTagNo

classes (compute.intersight.organizations.policies.system_qos)

Section titled “classes (compute.intersight.organizations.policies.system_qos)”
NameTypeConstraintMandatoryDefault Value
priorityChoiceBest Effort, FC, Platinum, Gold, Silver, BronzeYes
enabledBooleantrue, falseNotrue
cosIntegermin: 0, max: 255No
bandwidth_percentIntegermin: 0, max: 100No
mtuIntegermin: 1500, max: 9216No
multicast_optimizeBooleantrue, falseNo
packet_dropBooleantrue, falseNotrue
weightIntegermin: 1, max: 10No5

pfc_watchdog (compute.intersight.organizations.policies.system_qos)

Section titled “pfc_watchdog (compute.intersight.organizations.policies.system_qos)”
NameTypeConstraintMandatoryDefault Value
enabledBooleantrue, falseNofalse
watchdog_intervalIntegermin: 100, max: 1000No500
shutdown_multiplierIntegermin: 1, max: 10No1

Example-1: Configure a system QoS policy with recommended class settings for a UCS domain with FC storage traffic, with environment tags.

compute:
intersight:
organizations:
- name: MyOrg
policies:
system_qos:
- name: MySystemQosPolicy
tags:
- key: env
value: prod
classes:
- priority: Best Effort
enabled: true
cos: 255
weight: 5
packet_drop: true
- priority: FC
enabled: true
cos: 3
mtu: 2240
weight: 10
packet_drop: false
- priority: Platinum
enabled: true
cos: 5
weight: 10
packet_drop: false
- priority: Gold
enabled: true
cos: 4
weight: 9
packet_drop: true
- priority: Silver
enabled: true
cos: 2
weight: 8
packet_drop: true
- priority: Bronze
enabled: true
cos: 1
weight: 7
packet_drop: true

Example-2: Configure a system QoS policy with PFC watchdog enabled and Platinum reserved for lossless NVMe-oF traffic.

compute:
intersight:
organizations:
- name: MyOrg
policies:
system_qos:
- name: MyNvmeQosPolicy
classes:
- priority: Best Effort
enabled: true
cos: 255
weight: 5
packet_drop: true
- priority: FC
enabled: true
cos: 3
mtu: 2240
weight: 10
packet_drop: false
- priority: Platinum
enabled: true
cos: 5
mtu: 9000
weight: 10
packet_drop: false
- priority: Gold
enabled: false
- priority: Silver
enabled: false
- priority: Bronze
enabled: false
pfc_watchdog:
enabled: true
watchdog_interval: 500
shutdown_multiplier: 2