Configuration for a database connection to an Open vSwitch
Database (OVSDB) client.
The database server can initiate and maintain active connections
to remote clients. It can also listen for database connections.
Summary:
Core Features:
target string (must be unique within
table)
Client Failure Detection and Handling:
max_backoff optional integer, at least 1,000
inactivity_probe optional integer
Status:
is_connected boolean
status : last_error optional string
status : state optional string, one of ACTIVE,
BACKOFF, CONNECTING, IDLE, or VOID
status : sec_since_connect optional string, containing an
integer, at least 0
status : sec_since_disconnect
optional string, containing an
integer, at least 0
status : locks_held optional string
status : locks_waiting optional string
status : locks_lost optional string
status : n_connections optional string, containing an
integer, at least 2
Connection Parameters:
other_config : dscp optional string, containing an
integer
Details:
Core Features:
target: string (must be unique within table)
Connection method for managers.
The following connection methods are currently supported:
ssl:host[:port]
The specified SSL port (default: 6640) on the given
host, which can either be a DNS name (if built with
unbound library) or an IP address.
SSL key and certificate configuration happens
outside the database.
tcp:host[:port]
The specified TCP port (default: 6640) on the given
host, which can either be a DNS name (if built with
unbound library) or an IP address.
pssl:[port][:host]
Listens for SSL connections on the specified TCP
port (default: 6640). If host, which can either be
a DNS name (if built with unbound library) or an IP
address, is specified, then connections are
restricted to the resolved or specified local IP
address.
ptcp:[port][:host]
Listens for connections on the specified TCP port
(default: 6640). If host, which can either be a DNS
name (if built with unbound library) or an IP
address, is specified, then connections are
restricted to the resolved or specified local IP
address.
Client Failure Detection and Handling:
max_backoff: optional integer, at least 1,000
Maximum number of milliseconds to wait between connection
attempts. Default is implementation-specific.
inactivity_probe: optional integer
Maximum number of milliseconds of idle time on connection
to the client before sending an inactivity probe message.
If the Open vSwitch database does not communicate with the
client for the specified number of seconds, it will send a
probe. If a response is not received for the same
additional amount of time, the database server assumes the
connection has been broken and attempts to reconnect.
Default is implementation-specific. A value of 0 disables
inactivity probes.
Status:
is_connected: boolean
true if currently connected to this manager, false
otherwise.
status : last_error: optional string
A human-readable description of the last error on the
connection to the manager; i.e. strerror(errno). This key
will exist only if an error has occurred.
status : state: optional string, one of ACTIVE, BACKOFF,
CONNECTING, IDLE, or VOID
The state of the connection to the manager:
VOID Connection is disabled.
BACKOFF
Attempting to reconnect at an increasing period.
CONNECTING
Attempting to connect.
ACTIVE Connected, remote host responsive.
IDLE Connection is idle. Waiting for response to keep-
alive.
These values may change in the future. They are provided
only for human consumption.
status : sec_since_connect: optional string, containing an
integer, at least 0
The amount of time since this manager last successfully
connected to the database (in seconds). Value is empty if
manager has never successfully connected.
status : sec_since_disconnect: optional string, containing an
integer, at least 0
The amount of time since this manager last disconnected
from the database (in seconds). Value is empty if manager
has never disconnected.
status : locks_held: optional string
Space-separated list of the names of OVSDB locks that the
connection holds. Omitted if the connection does not hold
any locks.
status : locks_waiting: optional string
Space-separated list of the names of OVSDB locks that the
connection is currently waiting to acquire. Omitted if the
connection is not waiting for any locks.
status : locks_lost: optional string
Space-separated list of the names of OVSDB locks that the
connection has had stolen by another OVSDB client. Omitted
if no locks have been stolen from this connection.
status : n_connections: optional string, containing an integer,
at least 2
When target specifies a connection method that listens for
inbound connections (e.g. ptcp: or pssl:) and more than
one connection is actually active, the value is the number
of active connections. Otherwise, this key-value pair is
omitted.
When multiple connections are active, status columns and
key-value pairs (other than this one) report the status of
one arbitrarily chosen connection.
Connection Parameters:
Additional configuration for a connection between the manager and
the database server.
other_config : dscp: optional string, containing an integer
The Differentiated Service Code Point (DSCP) is specified
using 6 bits in the Type of Service (TOS) field in the IP
header. DSCP provides a mechanism to classify the network
traffic and provide Quality of Service (QoS) on IP
networks. The DSCP value specified here is used when
establishing the connection between the manager and the
database server. If no value is specified, a default value
of 48 is chosen. Valid DSCP values must be in the range 0
to 63.
