Each row in this table represents a hypervisor or gateway (a
chassis) in the physical network. Each chassis, via
ovn-controller/ovn-controller-vtep, adds and updates its own row,
and keeps a copy of the remaining rows to determine how to reach
other hypervisors.
When a chassis shuts down gracefully, it should remove its own
row. (This is not critical because resources hosted on the
chassis are equally unreachable regardless of whether the row is
present.) If a chassis shuts down permanently without removing
its row, some kind of manual or automatic cleanup is eventually
needed; we can devise a process for that as necessary.
Summary:
name string (must be unique within
table)
hostname string
nb_cfg integer
external_ids : ovn-bridge-mappings
optional string
external_ids : datapath-type optional string
external_ids : iface-types optional string
external_ids : ovn-cms-options
optional string
transport_zones set of strings
external_ids : ovn-chassis-mac-mappings
optional string
Common Columns:
external_ids map of string-string pairs
Encapsulation Configuration:
encaps set of 1 or more Encaps
Gateway Configuration:
vtep_logical_switches set of strings
Details:
name: string (must be unique within table)
OVN does not prescribe a particular format for chassis
names. ovn-controller populates this column using
external_ids:system-id in the Open_vSwitch database's
Open_vSwitch table. ovn-controller-vtep populates this
column with name in the hardware_vtep database's
Physical_Switch table.
hostname: string
The hostname of the chassis, if applicable. ovn-controller
will populate this column with the hostname of the host it
is running on. ovn-controller-vtep will leave this column
empty.
nb_cfg: integer
Sequence number for the configuration. When ovn-controller
updates the configuration of a chassis from the contents
of the southbound database, it copies nb_cfg from the
SB_Global table into this column.
external_ids : ovn-bridge-mappings: optional string
ovn-controller populates this key with the set of bridge
mappings it has been configured to use. Other applications
should treat this key as read-only. See ovn-controller(8)
for more information.
external_ids : datapath-type: optional string
ovn-controller populates this key with the datapath type
configured in the datapath_type column of the Open_vSwitch
database's Bridge table. Other applications should treat
this key as read-only. See ovn-controller(8) for more
information.
external_ids : iface-types: optional string
ovn-controller populates this key with the interface types
configured in the iface_types column of the Open_vSwitch
database's Open_vSwitch table. Other applications should
treat this key as read-only. See ovn-controller(8) for
more information.
external_ids : ovn-cms-options: optional string
ovn-controller populates this key with the set of options
configured in the external_ids:ovn-cms-options column of
the Open_vSwitch database's Open_vSwitch table. See
ovn-controller(8) for more information.
transport_zones: set of strings
ovn-controller populates this key with the transport zones
configured in the external_ids:ovn-transport-zones column
of the Open_vSwitch database's Open_vSwitch table. See
ovn-controller(8) for more information.
external_ids : ovn-chassis-mac-mappings: optional string
ovn-controller populates this key with the set of options
configured in the external_ids:ovn-chassis-mac-mappings
column of the Open_vSwitch database's Open_vSwitch table.
See ovn-controller(8) for more information.
Common Columns:
The overall purpose of these columns is described under Common
Columns at the beginning of this document.
external_ids: map of string-string pairs
Encapsulation Configuration:
OVN uses encapsulation to transmit logical dataplane packets
between chassis.
encaps: set of 1 or more Encaps
Points to supported encapsulation configurations to
transmit logical dataplane packets to this chassis. Each
entry is a Encap record that describes the configuration.
Gateway Configuration:
A gateway is a chassis that forwards traffic between the OVN-
managed part of a logical network and a physical VLAN, extending
a tunnel-based logical network into a physical network. Gateways
are typically dedicated nodes that do not host VMs and will be
controlled by ovn-controller-vtep.
vtep_logical_switches: set of strings
Stores all VTEP logical switch names connected by this
gateway chassis. The Port_Binding table entry with
options:vtep-physical-switch equal Chassis name, and
options:vtep-logical-switch value in Chassis
vtep_logical_switches, will be associated with this
Chassis.
