How to Configure an EVS Controller

Language:

This procedure assumes that the steps are performed by you as evsuser. The evsuser has the necessary authorizations to perform EVS configuration and to run the evsadm command.

Before You Begin

The following must be completed:

Required EVS packages are installed. See Installing the Required Packages.
SSH authentication for evsuser is completed. See About SSH Authentication and the evsuser.

Specify the connection information for the controller.
If you are on a separate node from the controller, issue the following command to enable you to configure the EVS controller remotely.
```
$ evsadm set-prop -p controller=value
```
The property value can be one of the following:
- ssh://evsuser@evs-controller-host-name
- ssh://evsuser@evs-controller-IP-address
- unix://
  
  Specify this setting if all the EVS components are hosted on the same system.

Become evsuser and connect to the controller.

$ su - evsuser
evsuser@host ssh controller

Configure controller properties.
1. Set the Layer 2 type and the uplink ports.
```
evsuser@controller$ evsadm set-controlprop [-h host] \
   -p l2-type=value,uplink-port=value
```
  –h host
  
  Host name for which the properties are being set.
  
  l2-type
  
  Layer 2 segment type, which can be vxlan, vlan, or flat.
  
  uplink-port
  
  Datalink to which EVS nodes connect.
  
  You can configure multiple uplink ports.
2. Configure other properties relevant to the l2-type setting.
```
evsuser@controller$ evsadm set-controlprop -p property=value[,property=value,…]
```
  For example, for a VXLAN L2 segment, you would also configure vxlan-range, vxlan-addr, and so on.
  
  To list all configurable properties, type the command evsadm show-controlprop. Or, refer to Figure 5, Table 5, EVS Controller Properties.
  
  See the examples for configuring specific L2 segment types.

(Optional) Display the configuration information.

evsuser@controller$ evsadm show-controlprop [-p property]

Example 50 Configuring an EVS Controller With a VXLAN L2 Segment Type

The following example shows how to configure the host s11-server as the EVS controller, whose L2 segments are created by using a VXLAN. Note that the displayed controller properties are only an extract of the entire output.

The example assumes that you have already specified the controller connections and you are connected to s11-server as evsuser.

evsuser@s11-server$ evsadm set-controlprop -p l2-type=vxlan 
evsuser@s11-server$ evsadm set-controlprop -p vxlan-range=10000-20000 
evsuser@s11-server$ evsadm set-controlprop -p vxlan-addr=192.0.2.0/24
evsuser@s11-server$ evsadm set-controlprop -h s11-server -p uplink-port=net3
evsuser@s11-server$ evsadm set-controlprop -h s11-client -p uplink-port=net4

evsuser@s11-server$ evsadm show-prop
PROPERTY            PERM   VALUE                      DEFAULT
controller          rw     ssh://evsuser@s11-server   -- 

evsuser@s11-server$ evsadm show-controlprop
PROPERTY            PERM VALUE                   DEFAULT     HOST
l2-type             rw   vxlan                   vlan        --
uplink-port         rw   --                      --          --
uplink-port         rw   net3                    --          s11-server
uplink-port         rw   net4                    --          s11-client
uri-template        rw   ssh://                  ssh://      --
uuid                r-   b3fda654-c14c-11e4      --          --
                         -ae16-5f67bed8a8e9
vlan-range          rw   --                       --         --
vlan-range-avail    r-   --                       --         --
vxlan-addr          rw   192.0.2.0/24 0.0.0.0     --
vxlan-ipvers        rw   v4                       v4         --
vxlan-mgroup        rw   0.0.0.0                  0.0.0.0    --
vxlan-range         rw   10000-20000              --         --
vxlan-range-avail   r-   10000-20000              --         --

Example 51 Configuring an EVS Controller With a VLAN L2 Segment Type

The following example shows how to configure the controller in s11-server to host a VLAN L2 segment.

The example assumes that you have already specified the controller connections and you are connected to s11-server as evsuser.

evsuser@s11-server$ evsadm set-controlprop -p l2-type=vlan
evsuser@s11-server$ evsadm set-controlprop -p vlan-range=200-300,400-500
evsuser@s11-server$ evsadm set-controlprop -p uplink-port=net2
evsuser@s11-server$ evsadm set-controlprop -h host2.example.com -p uplink-port=net3 
evsuser@s11-server$ evsadm set-controlprop -h host3.example.com -p uplink-port=net4

Example 52 Configuring an EVS Controller With a Flat L2 Segment Type

This example shows how to configure a flat EVS network. All the EVS components are on s11-server. Note that in this example, the flat L2 type segment is simultaneously configured with the uplink port by specifying flat=yes.

The example assumes that you have become evsuser.

evsuser@s11-server$ evsadm set-prop -p controller=unix://
evsuser@s11-server$ evsadm set-controlprop -p uplink-port=net4,flat=yes

evsuser@s11-server$ evsadm show-controlprop -p uplink-port
PROPERTY          VALUE       FLAT VLAN_RANGE  VXLAN_RANGE  HOST
uplink-port       net4        yes   --         --           --

evsuser@s11-server$ evsadm create-evs -p l2-type=flat evs0

evsuser@s11-server$ evsadm show-evsprop -p l2-type
EVS     TENANT        PROPERTY   PERM VALUE     DEFAULT      POSSIBLE
evs0    sys-global    l2-type    r-   flat      --           --

evsuser@s11-server$ evsadm show-evs -L
EVS           TENANT        L2TYPE VID  VNI
evs0          sys-global    flat   --   --