схема базы данных OVN_Northbound (OVN_Northbound database schema)
Logical_Router_Port TABLE
A port within an L3 logical router.
Exactly one Logical_Router
row must reference a given logical
router port.
Summary:
name
string (must be unique within
table)
gateway_chassis
set of Gateway_Chassis
s
ha_chassis_group
optional HA_Chassis_Group
networks
set of 1 or more strings
mac
string
enabled
optional boolean
ipv6_ra_configs:
ipv6_ra_configs : address_mode
optional string
ipv6_ra_configs : mtu
optional string
ipv6_ra_configs : send_periodic
optional string
ipv6_ra_configs : max_interval
optional string
ipv6_ra_configs : min_interval
optional string
Options:
options : redirect-chassis
optional string
options : reside-on-redirect-chassis
optional string
Attachment:
peer
optional string
Common Columns:
external_ids
map of string-string pairs
Details:
name
: string (must be unique within table)
A name for the logical router port.
In addition to provide convenience for human interaction
with the northbound database, this column is used as
reference by its patch port in Logical_Switch_Port
or
another logical router port in Logical_Router_Port
.
gateway_chassis
: set of Gateway_Chassis
s
This column is ignored if the column ha_chassis_group
. is
set.
If set, this indicates that this logical router port
represents a distributed gateway port that connects this
router to a logical switch with a localnet port. There may
be at most one such logical router port on each logical
router.
Several Gateway_Chassis
can be referenced for a given
logical router port. A single Gateway_Chassis
is
functionally equivalent to setting options:redirect-
chassis
. Refer to the description of options:redirect-
chassis
for additional details on gateway handling.
Defining more than one Gateway_Chassis
will enable gateway
high availability. Only one gateway will be active at a
time. OVN chassis will use BFD to monitor connectivity to
a gateway. If connectivity to the active gateway is
interrupted, another gateway will become active. The
priority
column specifies the order that gateways will be
chosen by OVN.
ha_chassis_group
: optional HA_Chassis_Group
If set, this indicates that this logical router port
represents a distributed gateway port that connects this
router to a logical switch with a localnet port. There may
be at most one such logical router port on each logical
router. The HA chassis which are part of the HA chassis
group will provide the gateway high availability. Please
see the HA_Chassis_Group
for more details.
When this column is set, the column gateway_chassis
will
be ignored.
networks
: set of 1 or more strings
The IP addresses and netmasks of the router. For example,
192.168.0.1/24
indicates that the router's IP address is
192.168.0.1 and that packets destined to 192.168.0.x
should be routed to this port.
A logical router port always adds a link-local IPv6
address (fe80::/64) automatically generated from the
interface's MAC address using the modified EUI-64 format.
mac
: string
The Ethernet address that belongs to this router port.
enabled
: optional boolean
This column is used to administratively set port state. If
this column is empty or is set to true
, the port is
enabled. If this column is set to false
, the port is
disabled. A disabled port has all ingress and egress
traffic dropped.
ipv6_ra_configs:
This column defines the IPv6 ND RA address mode and ND MTU Option
to be included by ovn-controller
when it replies to the IPv6
Router solicitation requests.
ipv6_ra_configs : address_mode
: optional string
The address mode to be used for IPv6 address
configuration. The supported values are:
• slaac
: Address configuration using Router
Advertisement (RA) packet. The IPv6 prefixes
defined in the Logical_Router_Port
table's networks
column will be included in the RA's ICMPv6 option -
Prefix information.
• dhcpv6_stateful
: Address configuration using
DHCPv6.
• dhcpv6_stateless
: Address configuration using
Router Advertisement (RA) packet. Other IPv6
options are provided by DHCPv6.
ipv6_ra_configs : mtu
: optional string
The recommended MTU for the link. Default is 0, which
means no MTU Option will be included in RA packet replied
by ovn-controller. Per RFC 2460, the mtu value is
recommended no less than 1280, so any mtu value less than
1280 will be considered as no MTU Option.
ipv6_ra_configs : send_periodic
: optional string
If set to true, then this router interface will send
router advertisements periodically. The default is false.
ipv6_ra_configs : max_interval
: optional string
The maximum number of seconds to wait between sending
periodic router advertisements. This option has no effect
if ipv6_ra_configs:send_periodic
is false. The default is
600.
ipv6_ra_configs : min_interval
: optional string
The minimum number of seconds to wait between sending
periodic router advertisements. This option has no effect
if ipv6_ra_configs:send_periodic
is false. The default is
one-third of ipv6_ra_configs:max_interval
, i.e. 200
seconds if that key is unset.
Options:
Additional options for the logical router port.
options : redirect-chassis
: optional string
If set, this indicates that this logical router port
represents a distributed gateway port that connects this
router to a logical switch with a localnet port. There may
be at most one such logical router port on each logical
router.
Even when a redirect-chassis
is specified, the logical
router port still effectively resides on each chassis.
However, due to the implications of the use of L2 learning
in the physical network, as well as the need to support
advanced features such as one-to-many NAT (aka IP
masquerading), a subset of the logical router processing
is handled in a centralized manner on the specified
redirect-chassis
.
When this option is specified, the peer logical switch
port's addresses
must be set to router
. With this setting,
the external_mac
s specified in NAT rules are automatically
programmed in the peer logical switch's destination lookup
on the chassis where the logical_port
resides. In
addition, the logical router's MAC address is
automatically programmed in the peer logical switch's
destination lookup flow on the redirect-chassis
.
When this option is specified and it is desired to
generate gratuitous ARPs for NAT addresses, then the peer
logical switch port's options:nat-addresses
should be set
to router
.
While options:redirect-chassis
is still supported for
backwards compatibility, it is now preferred to specify
one or more gateway_chassis
instead. It is functionally
equivalent, but allows you to specify multiple chassis to
enable high availability.
options : reside-on-redirect-chassis
: optional string
Generally routing is distributed in OVN
. The packet from a
logical port which needs to be routed hits the router
pipeline in the source chassis. For the East-West traffic,
the packet is sent directly to the destination chassis.
For the outside traffic the packet is sent to the gateway
chassis.
When this option is set, OVN
considers this only if
• The logical router to which this logical router
port belongs to has a distributed gateway port.
• The peer's logical switch has a localnet port
(representing a VLAN tagged network)
When this option is set to true
, then the packet which
needs to be routed hits the router pipeline in the chassis
hosting the distributed gateway router port. The source
chassis pushes out this traffic via the localnet port.
With this the East-West traffic is no more distributed and
will always go through the gateway chassis.
Without this option set, for any traffic destined to
outside from a logical port which belongs to a logical
switch with localnet port, the source chassis will send
the traffic to the gateway chassis via the tunnel port
instead of the localnet port and this could cause MTU
issues.
Attachment:
A given router port serves one of two purposes:
• To attach a logical switch to a logical router. A
logical router port of this type is referenced by
exactly one Logical_Switch_Port
of type router
. The
value of name
is set as router-port
in column
options
of Logical_Switch_Port
. In this case peer
column is empty.
• To connect one logical router to another. This
requires a pair of logical router ports, each
connected to a different router. Each router port
in the pair specifies the other in its peer
column.
No Logical_Switch
refers to the router port.
peer
: optional string
For a router port used to connect two logical routers,
this identifies the other router port in the pair by name
.
For a router port attached to a logical switch, this
column is empty.
Common Columns:
external_ids
: map of string-string pairs
See External IDs
at the beginning of this document.