ovs-vswitchd(8)

NAME
ovs-vswitchd - Open vSwitch daemon

SYNOPSIS
ovs-vswitchd [database]

DESCRIPTION
A daemon that manages and controls any number of Open vSwitch switches on the local machine.

The database argument specifies how ovs-vswitchd connects to ovsdb-server. The default is unix:@RUNDIR@/db.sock. The following forms are accepted:

ovs-vswitchd retrieves its configuration from database at startup. It sets up Open vSwitch datapaths and then operates switching across each bridge described in its configuration files. As the database changes, ovs-vswitchd automatically updates its configuration to match.

Upon receipt of a SIGHUP signal, ovs-vswitchd reopens its log file, if one was specified on the command line.

ovs-vswitchd switches may be configured with any of the following features:

•   L2 switching with MAC learning.

•   NIC bonding with automatic fail-over and source MAC-based TX load balancing ("SLB").

•   802.1Q VLAN support.

•   Port mirroring, with optional VLAN tagging.

•   NetFlow v5 flow logging.

•   sFlow(R) monitoring.

•   Connectivity to an external OpenFlow controller, such as NOX.

Only a single instance of ovs-vswitchd is intended to run at a time. A single ovs-vswitchd can manage any number of switch instances, up to the maximum number of supported Open vSwitch datapaths.

ovs-vswitchd does all the necessary management of Open vSwitch datapaths itself. Thus, external tools, such ovs-dpctl(8), are not needed for managing datapaths in conjunction with ovs-vswitchd, and their use to modify datapaths when ovs-vswitchd is running can interfere with its operation. (ovs-dpctl may still be useful for diagnostics.)

An Open vSwitch datapath kernel module must be loaded for ovs-vswitchd to be useful. Please refer to the INSTALL.Linux file included in the Open vSwitch distribution for instructions on how to build and load the Open vSwitch kernel module.

OPTIONS

--mlockall
    Causes ovs-vswitchd to call the mlockall() function, to attempt to lock all of its process memory into physical RAM, preventing the kernel from paging any of its memory to disk. This helps to avoid networking interruptions due to system memory pressure.

    Some systems do not support mlockall() at all, and other systems only allow privileged users, such as the superuser, to use it. ovs-vswitchd emits a log message if mlockall() is unavailable or unsuccessful.

  Public Key Infrastructure Options

RUNTIME MANAGEMENT COMMANDS
ovs-appctl(8) can send commands to a running ovs-vswitchd process. The currently supported commands are described below. The command descriptions assume an understanding of how to configure Open vSwitch.

  GENERAL COMMANDS

exit
    Causes ovs-vswitchd to gracefully terminate.

coverage/log
    Logs coverage counters at level warn.

qos/show interface
    Queries the kernel for Quality of Service configuration and statistics associated with the given interface.

cfm/show [interface]
    Displays detailed information about Connectivity Fault Management configured on interface. If interface is not specified, then displays detailed information about all interfaces with CFM enabled.

  BRIDGE COMMANDS
These commands manage bridges.

fdb/flush [bridge]
    Flushes bridge MAC address learning table, or all learning tables if no bridge is given.

fdb/show bridge
    Lists each MAC address/VLAN pair learned by the specified bridge, along with the port on which it was learned and the age of the entry, in seconds.

bridge/reconnect [bridge]
    Makes bridge drop all of its OpenFlow controller connections and reconnect. If bridge is not specified, then all bridges drop their controller connections and reconnect.

    This command might be useful for debugging OpenFlow controller issues.

bridge/dump-flows bridge
    Lists all flows in bridge, including those normally hidden to commands such as ovs-ofctl dump-flows. Flows set up by mechanisms such as in-band control and fail-open are hidden from the controller since it is not allowed to modify or override them.

  BOND COMMANDS
These commands manage bonded ports on an Open vSwitch's bridges. To understand some of these commands, it is important to understand a detail of the bonding implementation called ``source load balancing'' (SLB). Instead of directly assigning Ethernet source addresses to slaves, the bonding implementation computes a function that maps an 48-bit Ethernet source addresses into an 8-bit value (a ``MAC hash'' value). All of the Ethernet addresses that map to a single 8-bit value are then assigned to a single slave.

bond/list
    Lists all of the bonds, and their slaves, on each bridge.

bond/show port
    Lists all of the bond-specific information about the given bonded port: updelay, downdelay, time until the next rebalance. Also lists information about each slave: whether it is enabled or disabled, the time to completion of an updelay or downdelay if one is in progress, whether it is the active slave, the MAC hashes assigned to the slave, and the MAC learning table entries that hash to each MAC. Any LACP information related to this bond may be found using the lacp/show command.

bond/migrate port hash slave
    Only valid for SLB bonds. Assigns a given MAC hash to a new slave. port specifies the bond port, hash the MAC hash to be migrated (as a decimal number between 0 and 255), and slave the new slave to be assigned.

    The reassignment is not permanent: rebalancing or fail-over will cause the MAC hash to be shifted to a new slave in the usual manner.

    A MAC hash cannot be migrated to a disabled slave.

bond/set-active-slave port slave
    Sets slave as the active slave on port. slave must currently be enabled.

    The setting is not permanent: a new active slave will be selected if slave becomes disabled.

bond/enable-slave port slave
    Enables (or disables) slave on the given bond port, skipping any updelay (or downdelay).

    This setting is not permanent: it persists only until the carrier status of slave changes.

bond/hash mac [vlan] [basis]
    Returns the hash value which would be used for mac with vlan and basis if specified.

lacp/show [port]
    Lists all of the LACP related information about the given port: active or passive, aggregation key, system id, and system priority. Also lists information about each slave: whether it is enabled or disabled, whether it is attached or detached, port id and priority, actor information, and partner information. If port is not specified, then displays detailed information about all interfaces with CFM enabled.

SEE ALSO
ovs-appctl(8), ovs-brcompatd(8), ovsdb-server(1), INSTALL.Linux in the Open vSwitch distribution.