</dl>
<p>
- The following mode requires the upstream switch to support 802.3ad with
+ The following modes require the upstream switch to support 802.3ad with
successful LACP negotiation. If LACP negotiation fails then
- <code>balance-slb</code> mode is used as a fallback:
+ <code>balance-slb</code> style flow hashing is used as a fallback:
</p>
<dl>
</dd>
</dl>
+ <dl>
+ <dt><code>stable</code></dt>
+ <dd>
+ <p>Attempts to always assign a given flow to the same slave
+ consistently. In an effort to maintain stability, no load
+ balancing is done. Uses a similar hashing strategy to
+ <code>balance-tcp</code>, falling back to <code>balance-slb</code>
+ style hashing when LACP negotiations are unsuccessful.</p>
+ <p>Slave selection decisions are made based on LACP port ID when LACP
+ negotiations are successful, falling back to openflow port number
+ when unsuccessful. Thus, decisions are consistent across all
+ ovs-vswitchd instances with equivalent port IDs.</p>
+ </dd>
+ </dl>
+
<p>These columns apply only to bonded ports. Their values are
otherwise ignored.</p>
<column name="lacp">
<p>Configures LACP on this port. LACP allows directly connected
- switches to negotiate which links may be bonded. LACP may be enabled
- on non-bonded ports for the benefit of any switches they may be
+ switchs to negotiate which links may be bonded. LACP may be enabled
+ on non-bonded ports for the benefit of any switchs they may be
connected to. <code>active</code> ports are allowed to initiate LACP
negotiations. <code>passive</code> ports are allowed to participate
in LACP negotiations initiated by a remote switch, but not allowed to
<dd> The number of milliseconds between successive attempts to
poll each interface's MII. Only relevant on ports which use
<code>miimon</code> to detect failures. </dd>
+ <dt><code>lacp-system-id</code></dt>
+ <dd> The LACP system ID of this <ref table="Port"/>. The system ID
+ of a LACP bond is used to identify itself to its partners. Must
+ be a nonzero MAC address.</dd>
<dt><code>lacp-system-priority</code></dt>
<dd> The LACP system priority of this <ref table="Port"/>. In
LACP negotiations, link status decisions are made by the system
with the numerically lower priority. Must be a number between 1
and 65535.</dd>
<dt><code>lacp-time</code></dt>
- <dd> The LACP timing which should be used on this
- <ref table="Port"/>. Possible values are <code>fast</code> and
- <code>slow</code>. By default <code>slow</code> is used. When
- configured to be <code>fast</code> more frequent LACP heartbeats
- will be requested causing connectivity problems to be detected more
- quickly.</dd>
+ <dd>
+ <p>The LACP timing which should be used on this
+ <ref table="Port"/>. Possible values are <code>fast</code>,
+ <code>slow</code> and a positive number of milliseconds. By
+ default <code>slow</code> is used. When configured to be
+ <code>fast</code> LACP heartbeats are requested at a rate of once
+ per second causing connectivity problems to be detected more
+ quickly. In <code>slow</code> mode, heartbeats are requested at
+ a rate of once every 30 seconds.</p>
+
+ <p>Users may manually set a heartbeat transmission rate to increase
+ the fault detection speed further. When manually set, OVS
+ expects the partner switch to be configured with the same
+ transmission rate. Manually setting <code>lacp-time</code> to
+ something other than <code>fast</code> or <code>slow</code> is
+ not supported by the LACP specification.</p>
+ </dd>
+ <dt><code>lacp-strict</code></dt>
+ <dd> When <code>true</code>, configures this <ref table="Port"/> to
+ require successful LACP negotiations to enable any slaves.
+ Defaults to <code>false</code> which safely allows LACP to be used
+ with switchs that do not support the protocol.</dd>
</dl>
</column>
</group>
Connectivity monitor configuration for this interface.
</column>
+ <column name="lacp_current">
+ Boolean value indicating LACP status for this interface. If true, this
+ interface has current LACP information about its LACP partner. This
+ information may be used to monitor the health of interfaces in a LACP
+ enabled port. This column will be empty if LACP is not enabled.
+ </column>
+
<column name="external_ids">
Key-value pairs for use by external frameworks that integrate
with Open vSwitch, rather than by Open vSwitch itself. System
<column name="other_config">
Key-value pairs for rarely used interface features.
<dl>
+ <dt><code>lacp-port-id</code></dt>
+ <dd> The LACP port ID of this <ref table="Interface"/>. Port IDs are
+ used in LACP negotiations to identify individual ports
+ participating in a bond. Must be a number between 1 and
+ 65535.</dd>
<dt><code>lacp-port-priority</code></dt>
<dd> The LACP port priority of this <ref table="Interface"/>. In
LACP negotiations <ref table="Interface"/>s with numerically lower
number of seconds, it will send a probe. If a response is not
received for the same additional amount of time, Open vSwitch
assumes the connection has been broken and attempts to reconnect.
- Default is implementation-specific.
+ Default is implementation-specific. A value of 0 disables
+ inactivity probes.
</column>
</group>
will send a probe. If a response is not received for the same
additional amount of time, Open vSwitch assumes the connection has been
broken and attempts to reconnect. Default is implementation-specific.
+ A value of 0 disables inactivity probes.
</column>
</group>
projects / openvswitch / blobdiff