Ethernet Adapter Policy

An Ethernet Adapter Policy governs host-side VIC adapter behavior, controlling interrupt handling, transmit and receive queue sizes, TCP offloads, and advanced features such as RoCE, RSS, VXLAN, NVGRE, ARFS, and PTP. It is applied per vNIC via a LAN Connectivity Policy and is independent of the network VLAN configuration.

Location in Intersight GUI: Policies » Ethernet Adapter

Diagram

Classes

policies (compute.intersight.organizations)

Name	Type	Constraint	Mandatory	Default Value
ethernet_adapter	List	`[ethernet_adapter]`	No

ethernet_adapter (compute.intersight.organizations.policies)

Name	Type	Constraint	Mandatory	Default Value
name	String	Regex: `^[a-zA-Z0-9_.:-]{1,64}$`	Yes
description	String		No
managed	Boolean	`true`, `false`	No	`true`
tags	List	`[tags]`	No
advanced_filter	Boolean	`true`, `false`	No
ether_channel_pinning	Boolean	`true`, `false`	No
geneve	Boolean	`true`, `false`	No
interrupt_scaling	Boolean	`true`, `false`	No
rss	Boolean	`true`, `false`	No
uplink_failback_timeout	Integer	min: `0`, max: `600`	No
arfs	Boolean	`true`, `false`	No
completion_queue_settings	Class	`[completion_queue_settings]`	No
interrupt_settings	Class	`[interrupt_settings]`	No
nvgre	Boolean	`true`, `false`	No
ptp	Boolean	`true`, `false`	No
roce_settings	Class	`[roce_settings]`	No
rss_hash_settings	Class	`[rss_hash_settings]`	No
rx_queue_settings	Class	`[rx_queue_settings]`	No
tcp_offload_settings	Class	`[tcp_offload_settings]`	No
tx_queue_settings	Class	`[tx_queue_settings]`	No
vxlan	Boolean	`true`, `false`	No

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

Name	Type	Constraint	Mandatory	Default Value
key	String		Yes
value	String		Yes

completion_queue_settings (compute.intersight.organizations.policies.ethernet_adapter)

Name	Type	Constraint	Mandatory	Default Value
nr_count	Integer	min: `1`, max: `2000`	No
ring_size	Integer	min: `1`, max: `256`	No

interrupt_settings (compute.intersight.organizations.policies.ethernet_adapter)

Name	Type	Constraint	Mandatory
coalescing_time	Integer	min: `0`, max: `65535`	No
coalescing_type	Choice	`MIN`, `IDLE`	No
nr_count	Integer	min: `1`, max: `1024`	No
mode	Choice	`MSIx`, `MSI`, `INTx`	No

roce_settings (compute.intersight.organizations.policies.ethernet_adapter)

Name	Type	Constraint	Mandatory
enabled	Boolean	`true`, `false`	No
class_of_service	Choice	`1`, `2`, `4`, `5`, `6`	No
memory_regions	Integer	min: `1`, max: `524288`	No
queue_pairs	Integer	min: `1`, max: `8192`	No
resource_groups	Integer	min: `1`, max: `128`	No
version	Integer	min: `1`, max: `2`	No

rss_hash_settings (compute.intersight.organizations.policies.ethernet_adapter)

Name	Type	Constraint	Mandatory
ipv4_hash	Boolean	`true`, `false`	No
ipv6_ext_hash	Boolean	`true`, `false`	No
ipv6_hash	Boolean	`true`, `false`	No
tcp_ipv4_hash	Boolean	`true`, `false`	No
tcp_ipv6_ext_hash	Boolean	`true`, `false`	No
tcp_ipv6_hash	Boolean	`true`, `false`	No
udp_ipv4_hash	Boolean	`true`, `false`	No
udp_ipv6_hash	Boolean	`true`, `false`	No

rx_queue_settings (compute.intersight.organizations.policies.ethernet_adapter)

Name	Type	Constraint	Mandatory	Default Value
nr_count	Integer	min: `1`, max: `1000`	No
ring_size	Integer	min: `64`, max: `4096`	No

tcp_offload_settings (compute.intersight.organizations.policies.ethernet_adapter)

Name	Type	Constraint	Mandatory
large_receive	Boolean	`true`, `false`	No
large_send	Boolean	`true`, `false`	No
rx_checksum	Boolean	`true`, `false`	No
tx_checksum	Boolean	`true`, `false`	No

tx_queue_settings (compute.intersight.organizations.policies.ethernet_adapter)

Name	Type	Constraint	Mandatory	Default Value
nr_count	Integer	min: `1`, max: `1000`	No
ring_size	Integer	min: `64`, max: `4096`	No

Examples

Example-1: The example below demonstrates a high-performance adapter policy for Linux workloads, tuning interrupt coalescing, queue depths, and enabling TCP offloads.

compute:
  intersight:
    organizations:
      - name: MyOrganization
        policies:
          ethernet_adapter:
            - name: linux-high-perf
              description: High-performance settings for Linux workloads
              rss: true
              uplink_failback_timeout: 5
              interrupt_settings:
                mode: MSIx
                coalescing_time: 125
                coalescing_type: MIN
                nr_count: 8
              rx_queue_settings:
                nr_count: 4
                ring_size: 512
              tx_queue_settings:
                nr_count: 4
                ring_size: 512
              completion_queue_settings:
                nr_count: 8
              tcp_offload_settings:
                large_receive: true
                large_send: true
                rx_checksum: true
                tx_checksum: true
              tags:
                - key: env
                  value: prod

Example-2: The example below demonstrates a VMware adapter policy with RoCE v2 enabled for RDMA over the converged Ethernet fabric.

compute:
  intersight:
    organizations:
      - name: MyOrganization
        policies:
          ethernet_adapter:
            - name: vmware-roce
              description: VMware with RoCE v2 enabled
              rss: true
              roce_settings:
                enabled: true
                version: 2
                class_of_service: 5
                memory_regions: 131072
                queue_pairs: 1024
                resource_groups: 2