Go to main content

Oracle® VM Server for SPARC 3.6 Administration Guide

Exit Print View

Updated: September 2019
 
 

Modifying Ethernet SR-IOV Virtual Functions

The ldm set-io vf-name command modifies the current configuration of a virtual function by changing the property values or by setting new properties. This command can modify both the network-specific properties and the device-specific properties. For information about device-specific properties, see Advanced SR-IOV Topics: Ethernet SR-IOV.

If you cannot use this dynamic method, use the static method instead. See Static SR-IOV.

    You can use the ldm set-io command to modify the following properties:

  • mac-addr, alt-mac-addrs, and mtu

    To change these virtual function properties, stop the domain that owns the virtual function, use the ldm set-io command to change the property values, and start the domain.

  • pvid and vid

    You can dynamically change these properties while the virtual functions are assigned to a domain. Note that doing so might result in a change to the network traffic of an active virtual function; setting the pvid property enables a transparent VLAN. Setting the vid property to specify VLAN IDs permits VLAN traffic to those specified VLANs.

  • Device-specific properties

    Use the ldm list-io -d pf-name command to view the list of valid device-specific properties. You can modify these properties for both the physical function and the virtual function. You must use the static method to modify device-specific properties. See Static SR-IOV. For more information about device-specific properties, see Advanced SR-IOV Topics: Ethernet SR-IOV.

How to Modify Ethernet SR-IOV Virtual Function Properties

  1. Identify the physical function device.
    primary# ldm list-io

    Note that the name of the physical function includes the location information for the PCIe SR-IOV card or on-board device.

  2. Modify a virtual function property.
    ldm set-io name=value [name=value...] vf-name
Example 13  Modifying Ethernet Virtual Function Properties

    These examples describe how to use the ldm set-io command to set properties on an Ethernet virtual function.

  • The following example modifies properties of the specified virtual function, /SYS/MB/NET0/IOVNET.PF0.VF0, to be part of VLAN IDs 2, 3, and 4.

    primary# ldm set-io vid=2,3,4 /SYS/MB/NET0/IOVNET.PF0.VF0

    Note that this command dynamically changes the VLAN association for a virtual function. To use these VLANs, the VLAN interfaces in the I/O domains must be configured by using the appropriate Oracle Solaris OS networking commands.

  • The following example sets the pvid property value to 2 for the /SYS/MB/NET0/IOVNET.PF0.VF0 virtual function, which transparently makes the virtual function part of VLAN 2. Namely, the virtual function will not view any tagged VLAN traffic.

    primary# ldm set-io pvid=2 /SYS/MB/NET0/IOVNET.PF0.VF0
  • The following example assigns three automatically allocated alternate MAC addresses to a virtual function. The alternate addresses enable the creation of Oracle Solaris 11 virtual network interface cards (VNICs) on top of a virtual function. Note that to use VNICs, you must run the Oracle Solaris 11 OS in the domain.


    Note - Before you run this command, stop the domain that owns the virtual function.
    primary# ldm set-io alt-mac-addrs=auto,auto,auto /SYS/MB/NET0/IOVNET.PF0.VF0
  • The following example sets the device-specific unicast-slots property to 12 for the specified virtual function. To find the device-specific properties that are valid for a physical function, use the ldm list-io -d pf-name command.

    primary# ldm set-io unicast-slots=12 /SYS/MB/NET0/IOVNET.PF0.VF0
    
    All configuration changes for other domains are disabled until the primary
    domain reboots, at which time the new configuration for the primary domain
    will also take effect.