ovs-vsctl 命令详解
Open vSwitch中有多个命令，分别有不同的作用，大致如下：
ovs-vsctl用于控制ovs dbovs-ofctl用于管理OpenFlow switch 的 flowovs-dpctl用于管理ovs的datapathovs-appctl用于查询和管理ovs daemon
本文主要介绍ovs-vsctl。以下命令查询主机上已有的 OVS bridge，以及其中的 port。
ovs-vsctl show
例子
$ ovs-vsctl show
fc562da8-fb36-4d62-8b47-5502e72069dc
Bridge br-vxlan
Port "vxlan0"
Interface "vxlan0"
type: vxlan
options: {remote_ip="10.10.10.1"}
Port br-vxlan
Interface br-vxlan
type: internal
Port "veth2"
Interface "veth2"
ovs_version: "2.5.0"
Bridge 相关命令
创建 bridge
创建bridge(或switch，以下统称为bridge) br0
使用选项
--may-exist后，若欲创建的bridge已存在，该命令什么也不做，也不报错。
ovs-vsctl [--may-exist] add-br br0
删除bridge
删除 bridge br0
使用选项
--if-exists后，若欲删除的bridge不存在，该命令什么也不做，也不报错。
ovs-vsctl [--if-exists] del-br br0
查询已有的 bridge
ovs-vsctl list-br
端口相关命令
添加端口
添加端口(物理端口或vNIC)eth1到bridge eth1中
ovs-vsctl [--may-exist] add-port br0 eth1
创建 bond
在br0上创建一个bond了eth0,eth1和eth2的bond端口bond0
# ovs-vsctl add-bond <bridge> <port> <iface...>
ovs-vsctl add-bond br0 bond0 eth0 eth1 eth2
移除端口
从br0上移除端口eth1
ovs-vsctl [--if-exists] del-port br0 eth1
列出端口
列出br0上的端口（不包括internal port）
ovs-vsctl list-ports br0
查看端口详细数据
列出OVS中端口eth1的详细数据
$ ovs-vsctl list interface eth1
OpenFlow 控制器相关
添加控制器
# ovs-vsctl set-controller <bridge> <target...>
ovs-vsctl set-controller br0 tcp:1.2.3.4:6633
# 设置多个controller
ovs-vsctl set-controller br0 tcp:1.2.3.4:6633 tcp:4.3.2.1:6633
# 添加使用unix socket通信的controller
ovs-vsctl set-controller br0 unix:/var/run/xx/xx.sock
移除控制器
ovs-vsctl del-controller br0
查询 brige 上已配置的控制器
ovs-vsctl get-controller br0
VLAN 相关
配置端口为Access口
设置br0中的端口eth0为VLAN 10的access口
ovs-vsctl set port eth0 tag=10
添加eth1到指定bridge br0中，同时将其配置成指定VLAN 10的access端口
ovs-svctl add-port br0 eth1 tag=10
配置端口为Trunk口
在br0上添加port eth1为VLAN 9,10,11的trunk
ovs-vsctl add-port br0 eth1 trunk=9,10,11
VXLAN 相关
在bridge ovs0中添加远端IP为10.10.10.1的VXLAN endpoint端口vxlan0
# key=100表示设置vni为100，不设置默认为0
ovs-vsctl add-port ovs0 vxlan0 -- set interface vxlan0 type=vxlan options:remote_ip=10.10.10.1 options:key=100
# 不设key值，vni默认为0
ovs-vsctl add-port ovs0 vxlan0 -- set interface vxlan0 type=vxlan options:remote_ip=10.10.10.1
# key=flow的话，表示该port的vni可以通过openflow的actions来进行设置
# 如： actions=set_field:100->tun_id
# 或： actions=set_tunnel:100
ovs-vsctl add-port ovs0 vxlan0 -- set interface vxlan0 type=vxlan options:remote_ip=10.10.10.1 options:key=flow
其他
Atomic operation
一条命令创建bridge br0的，并添加eth0到br0中
ovs-vsctl add-br br0 -- add-port br0 eth0
创建 internal port
OVS internal port 可以配置IP地址，普通 port 上配置的IP地址是不起作用的。在 br0 上创建一个internal port in0:
ovs-vsctl add-br br0 in0 -- set interface in0 type=internal
ip addr add 10.10.10.10/24 dev in0
# 创建internal port的同时将其设置为VLAN 10的access port
ovs-vsctl add-br br0 in1 tag=10 -- set interface in1 type=internal
ip addr add 20.20.20.20/24 dev in1
设置 OpenFlow port id
# 将已在ovs中的端口veth1的OpenFlow端口设置成100
ovs-vsctl set interface veth1 ofport_request=100
# 将端口veth1添加到bridge br0中，并将veth1的OpenFlow端口设置成200
ovs-vsctl add-port br0 veth1 -- set interface veth1 ofport_request=200
{% admonition note Note %} OpenFlow的端口 id 在设置 flow 的匹配字段 in_port 以及 actions 字段的 output 中都会用到。
可以通过命令ovs-ofctl show br0来查看 br0 中各端口的 OpenFlow 端口 id，该 id 并不求是按顺序的。 {% endadmonition %}
设置OpenFlow版本
ovs-vsctl set bridge br0 protocols=OpenFlow10,OpenFlow12,OpenFlow13
