Go to main content

Managing Network Virtualization and Network Resources in Oracle® Solaris 11.3

Exit Print View

Updated: April 2018
 
 

Setting Hardware SLA Properties for VF VNICs

If a NIC supports hardware SLAs that enable you to set SLA properties for VF VNICs, the SLA implementation is offloaded to the NIC automatically by the system. This behaviour helps you to save CPU cycles.

You can use the dladm show-linkprop command with the –H option to check the capabilities of the underlying datalink. The command syntax is:

# dladm show-linkprop -H -p prop link

where prop refers to the SLA properties such as maxbw, priority, and bwshare.

The output displays the following columns:

HWPOSSIBLE

Displays a value if there is hardware support for the property. The physical NIC does not support the property if the value is displayed as --.

SWPOSSIBLE

Displays a value if there is software support in the networking stack for the property. The datalink does not support the property if the value is displayed as --.


Note -  For both the HWPOSSIBLE and SWPOSSIBLE columns, the step value requirement for the value is displayed after the number range followed by a colon (:), for example, 50-40000:50. Currently, only the maxbw property shows a value for the step value.
MODE

Displays the current mode that is used for the datalink to implement the property. The possible values are sw for software only, hw for hardware only, and none for no support. Note that MODE can be none even though there is hardware or software support.

HWFLAGS or SWFLAGS

Displays o for outbound, i for inbound, and oi for outbound and inbound. Currently, these flags are displayed for the SLA properties maxbw, bwshare, and priority.

If the datalink supports hardware SLAs, you can set the hardware SLA properties on the datalink by using the following command:

# dladm set-linkprop -p prop=value link

where prop refers to the SLA properties such as maxbw, priority, and bwshare.

Example 31  Displaying the Hardware and Software Capabilities of Datalinks

The following example shows the output of the maxbw property for the VF VNIC z1/net1 that is configured over the Intel XL710 10/40 Gigabit Ethernet controller NIC. The output shows that there is both hardware and software support because values are displayed under the columns HWPOSSIBLE and SWPOSSIBLE.

# dladm show-linkprop -H -p maxbw z1/net1
LINK          PROPERTY       MODE  HWPOSSIBLE   HWFLAGS SWPOSSIBLE     SWFLAGS
z1/net1       maxbw          hw    50-40000:50  o       0-40000:0.001  oi

The following example shows the output of the maxbw property for the VF VNIC z2/net2 that is configured over the Niantic NIC. The output shows that there is only software support for the VF VNIC z2/net2 because values are displayed under the column SWPOSSIBLE.

# dladm show-linkprop -H -p maxbw z2/net2
LINK          PROPERTY       MODE  HWPOSSIBLE   HWFLAGS SWPOSSIBLE     SWFLAGS
z2/net2       maxbw          none  --                   0-10000:0.001  oi 

The following example shows the output of the bwshare property for the VF VNIC z1/net1 that is configured over the Intel XL710 10/40 Gigabit Ethernet controller NIC. For information about the bwshare property, see Bandwidth Share for VNICs. The output shows that there is only hardware support for the VF VNIC z1/net1 for the bwshare property. The values are displayed under the column HWPOSSIBLE.

# dladm show-linkprop -H -p bwshare z1/net1
LINK          PROPERTY       MODE  HWPOSSIBLE   HWFLAGS SWPOSSIBLE     SWFLAGS
z1/net1       bwshare        hw    1-100        o       --                    

The following example shows the output of the bwshare property for the VF VNIC z2/net2 that is configured over the Niantic NIC. The output shows that there is no support for the VF VNIC z2/net2 for the bwshare property. The values are not displayed under the columns HWPOSSIBLE and SWPOSSIBLE.

# dladm show-linkprop -H -p bwshare z2/net2
LINK          PROPERTY       MODE  HWPOSSIBLE   HWFLAGS SWPOSSIBLE     SWFLAGS
z2/net2       bwshare        none  --                   --                    
Example 32  Setting Maximum Bandwidth for a VF VNIC

The following example shows how to set the maxbw property for the VF VNIC z1/net21.

# dladm set-linkprop -p maxbw=20 -t z1/net21
# dladm show-linkprop -p maxbw z1/net21
LINK     PROPERTY        PERM VALUE        EFFECTIVE    DEFAULT   POSSIBLE
z1/net21 maxbw           rw   20           50           --        -- 

In certain cases, the effective value for the maxbw property can be different from the set value for the VF VNIC that is configured over a hardware SLA capable link as shown in this example.