Managing Network Virtualization and Network Resources in Oracle^® Solaris 11.3

EVS Administrative Commands

You manage an elastic virtual switch by using the following administrative commands:

• evsadm

• evsstat

• dladm

• zonecfg

For information about how to configure an elastic virtual switch, see How to Configure an Elastic Virtual Switch.

evsadm Command

You use the evsadm command to communicate with the EVS controller and manage the elastic virtual switch, IPnet, and VPorts. This section describes the subcommands you use to perform activities with this command. For more information, see the evsadm(1M) man page.

evsadm Subcommands for Managing an Elastic Virtual Switch

The evsadm subcommands for managing a virtual switch are:

create-evs

Creates an elastic virtual switch

delete-evs

Deletes an elastic virtual switch

show-evs

Displays information about an elastic virtual switch

set-evsprop

Enables you to set the maxbw and priority properties for an elastic switch

For more information about these properties, see Setting Properties for an Elastic Virtual Switch.

show-evsprop

Displays the properties of the elastic virtual switch

evsadm Subcommands for Managing an IPnet

The evsadm subcommands for managing an IPnet are:

add-ipnet

Adds an IPnet to the elastic virtual switch and enables you to set the subnet, defrouter, and pool properties

For more information about these properties, see Adding an IPnet to an Elastic Virtual Switch.

set-ipnetprop

Sets properties for an IPnet

show-ipnetprop

Displays properties of an IPnet

remove-ipnet

Removes an IPnet

show-ipnet

Displays information about an IPnet

evsadm Subcommands for Managing a VPort

The evsadm subcommands for managing a virtual port are:

add-vport

Adds a VPort

remove-vport

Removes a VPort

show-vport

Displays information about a VPort

set-evsprop

Enables you to set the following properties for a VPort:

• cos

• maxbw

• priority

For more information about these properties, see Figure 4, Table 4, VPort Properties.

show-vportprop

Displays the properties of the VPort

reset-vport

Resets a VPort

evsadm Subcommands for Managing EVS Client Properties

The evsadm subcommands for managing EVS client properties are:

set-prop

Enables you to set the controller property

show-prop

Displays EVS client properties

evsadm Subcommands for Managing EVS Controller Properties

The evsadm subcommands for managing EVS controller properties are:

set-controlprop

Enables you to set the following properties for the controller:

• l2-type

• vlan-range

• vxlan-range

• vxlan-mgroup

• vxlan-addr

• vxlan-ipvers

• uplink-port

For more information about these properties, see Figure 5, Table 5, EVS Controller Properties.

show-controlprop

Displays the properties of the EVS controller

evsstat Command

The evsstat command displays the network traffic statistics for all the VPorts in a data center or multitenant cloud environment or for all the VPorts of the specified elastic virtual switch. It also reports the statistics of VNICs associated with the VPorts. For more information, see Monitoring Elastic Virtual Switches. For more information about the evsstat command, see the evsstat(1M) man page.

dladm Command

You can administer the VNICs connected to an elastic virtual switch by using the following dladm commands:

• dladm create-vnic command – Enables you to create a VNIC and specify the elastic virtual switch name to which you need to connect the VNIC. Optionally, you can specify the VPort of the elastic virtual switch.

• dladm show-vnic command – Enables you to display the elastic virtual switch information for a specific VNIC. The output of the dladm show-vnic command also displays the fields TENANT, EVS, and VPORT. However, these fields are not visible from within a zone.

For more information, see the dladm(1M) man page.

For more information about how to configure a VNIC for an elastic virtual switch, see How to Create a VNIC for an Elastic Virtual Switch.

zonecfg Command

You use the enhanced zonecfg command to configure a zone's VNIC anet resource for an elastic virtual switch. You can set the following properties for the VNIC anet resource:

• tenant – Specifies the name of the tenant. If you do not specify a value when configuring a zone, the system assigns the default value, sys-global.

• vport – Specifies the name of the VPort. If you do not specify a value when configuring a zone, the system generates a VPort for the elastic virtual switch and the VPort inherits the elastic virtual switch properties.

• evs – Specifies the name of an elastic virtual switch to which you must connect the VNIC anet resource.

For more information about the anet resource, see the anet description in Resource Type Properties in Oracle Solaris Zones Configuration Resources.

For more information about how to configure the VNIC anet resource for an elastic virtual switch, see Creating a VNIC anet Resource for an Elastic Virtual Switch. For more information about the zonecfg command, see the zonecfg(1M) man page.

Restrictions for Administering VNICs Connected to an Elastic Virtual Switch

The following restrictions apply on the VNICs that you create and connect to an elastic virtual switch by using the dladm create-vnic command or the zonecfg command:

• You cannot rename the VNICs by using the dladm rename-link command.

• You cannot change the properties of such VNICs by using the dladm set-linkprop or dladm reset-linkprop commands.

• You cannot modify these VNICs by using the dladm modify-vnic command.

Automatically Generated VXLAN Datalinks

If you implement Layer 2 segments for elastic virtual switches by using VXLANs, EVS automatically creates VXLAN datalinks on the EVS nodes that hosts VNICs for the elastic virtual switch. These datalinks are known as automatically generated VXLAN datalinks and follow the naming convention evs-vxlansegment-ID, where evs is the entity that created the datalink. For example, the name evs-vxlan200 indicates that 200 is the VXLAN ID and evs is the entity that has created this datalink. You can use the dladm show-vxlan command to display the automatically generated VXLAN datalinks. For more information, see Displaying VXLAN Information.

You cannot use the dladm subcommands on automatically generated VXLAN datalinks to delete or rename the datalink. However, you can temporarily set the datalink properties by using the dladm set-linkprop command and the dladm reset-linkprop command.