This section describes how to perform the following tasks for an elastic virtual switch:
Displaying information about an elastic virtual switch
Setting properties for an elastic virtual switch
Displaying elastic virtual switch properties
You use the evsadm show-evs command to display elastic virtual switch information. The command syntax is:
# evsadm show-evs [-f {fname=value[,...]}[,...]] [-L] [[-c] -o field[,...]] [EVS-switch-name]
A comma-separated name-value pair used to filter the output (row selection). If multiple filters are specified, then the displayed output is a result of an AND operation among the filters. If the filter value is multivalued, then the displayed output is a result of an OR operation among the filter values. The supported filters are:
tenant
evs
host
ipnet
vport
Displays the L2 segment associated with an elastic virtual switch. Additionally, the VLAN IDs or VXLAN segment IDs associated with an elastic virtual switch is displayed.
Specifies a case-insensitive, comma-separated list of output fields to display. You can specify the following fields, which appear as columns in the output:
Displays all the output fields.
Name of the elastic virtual switch.
Name of the tenant that owns the elastic virtual switch.
Status of the elastic virtual switch, whether it is idle or busy. The elastic virtual switch is busy if it has at the least one VPort that has a VNIC connected to it.
Number of virtual ports associated with the elastic virtual switch.
The list of IP networks associated with the EVS. Currently only one IP network can be associated with an elastic virtual switch.
The list of hosts that the elastic virtual switch spans across multiple systems.
The following example displays information for the elastic virtual switch ORA.
# evsadm show-evs ORA EVS TENANT STATUS NVPORTS IPNETS HOST ORA sys-global busy 1 ora_ipnet s11-client
The following example displays the VLAN ID associated with the elastic virtual switch ORA.
# evsadm show-evs -L EVS TENANT L2TYPE VID VNI ORA tenantA VLAN 200 --
The output shows the following information:
Name of the elastic virtual switch
Name of the tenant that owns the elastic virtual switch
Type of the L2 network
VLAN ID used to implement the elastic virtual switch
VXLAN segment ID used to implement the elastic virtual switch
You use the evsadm set-evsprop command to set properties for an elastic virtual switch. The command syntax is:
# evsadm set-evsprop [-T tenant-name] -p prop=value[,...] EVS-switch-name
Sets the values of a property on the specified elastic virtual switch.
EVS supports the following properties:
maxbw – Sets the full-duplex bandwidth for all the virtual ports that connect to the specified elastic virtual switch. The bandwidth is specified as an integer with a scale suffix (K, M, or G for Kbps, Mbps, and Gbps). If no units are specified, the input value is read as Mbps. The default is no bandwidth limit.
priority – Sets the default priority for all the virtual ports that connect to the specified elastic virtual switch. The possible values are high, medium, or low. The default value is medium. The priority is not reflected in any protocol priority fields on the wire but is used for packet processing scheduling within the system. A VPort with a high priority offers a better latency depending on the availability of system resources.
This example shows how to set properties for the elastic virtual switch ORA.
# evsadm set-evsprop -p maxbw=200 ORA # evsadm set-evsprop -p priority=high ORA
You use the evsadm show-evsprop command to display the properties of an elastic virtual switch. The command syntax is:
# evsadm show-evsprop [-f {fname=value[,...]}[,...] [[-c] -o field[,...]] \ [-p prop[,...]] [EVS-switch-name]
A comma-separated name-value pair used to filter the output (row selection). If multiple filters are specified, then the displayed output is a result of an AND operation among the filters. If the filter value is multivalued, then the displayed output is a result of an OR operation among the filter values. The supported filters are:
tenant – Filter the elastic virtual switch properties by the tenant name
evs – Filter the elastic virtual switch properties by the elastic virtual switch name
host – Filter the elastic virtual switch properties by the host name
Example 58, Displaying Elastic Virtual Switch Properties shows output based on the filter value.
Specifies a case-insensitive, comma-separated list of output fields to display. You can specify the following fields, which appear as columns in the output:
Displays all the output fields.
Name of the elastic virtual switch.
Name of the tenant that owns the elastic virtual switch.
Name of the elastic virtual switch property.
The read or write permissions of the property. The value shown is either r- or rw.
The current property value. If the value is not set, it is shown as --. If the value is unknown, it is shown as ?.
The default value of the property. If the property has no default value, -- is shown.
A comma-separated list of possible values for the property. If the possible values are unknown or unbounded, -- is shown.
The following example displays the properties configured for the elastic virtual switch ORA.
# evsadm show-evsprop ORA EVS TENANT PROPERTY PERM VALUE DEFAULT POSSIBLE ORA sys-global maxbw rw 200 -- -- ORA sys-global priority rw high medium low,medium,high ORA sys-global tenant r- -- -- --
The following example displays the output for the elastic virtual switches HR and ORA. In this example, the evs filter is specified to obtain the output for elastic virtual switches HR and ORA.
# evsadm show-evsprop -f evs=HR,ORA EVS TENANT PROPERTY PERM VALUE DEFAULT POSSIBLE HR tenantA maxbw rw 300 -- -- HR tenantA priority rw -- medium low,medium,high HR tenantA tenant r- -- -- -- ORA sys-global maxbw rw -- -- -- ORA sys-global priority rw -- medium low,medium,high ORA sys-global tenant r- -- -- --Example 59 Displaying the UUID of an Elastic Virtual Switch
This example shows how to display the UUID of the elastic virtual switch evs1.
# evsadm show-evsprop -p uuid -o evs,tenant,property,perm,value evs1 EVS TENANT PROPERTY PERM VALUE evs1 sys-global uuid r- 5c5b7120-95cc-11e4-ab91-171c32874415