starlingx/docs
Code Issues Proposed changes

Added new content for primary reselect

Browse Source 
'Configure AE Interfaces using CLI' and 'Link Aggregation Settings'
Included example for primary_reselect option
Created new table (table 3)

Patch 3: acted on comments from review (Teresa).

Patch 4: fixed wrong command line.

Patch 5: acted on comments from Greg (added links to 'Link aggregation settings).

Patch 7: acted on new comments to restructure the topics

Story: 2008706
Task: 42208

https://review.opendev.org/c/starlingx/docs/+/784824


Signed-off-by: Adil <mohamed.adilassakkali@windriver.com>
Change-Id: Id0041bef2a51657e3aa5cf929856c84f71e2a893
This commit is contained in:
Adil
2021-04-05 17:40:04 -03:00
committed by Mohamed Adil Assakkali
parent f9d1b4905d
commit be194a5ee1
2 changed files with 73 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
doc/source/node_management/kubernetes/node_interfaces/configuring-aggregated-ethernet-interfaces-using-the-cli.rst
View File

@@ -59,7 +59,7 @@ Settings <link-aggregation-settings>`.
.. code-block:: none
~(keystone_admin)$ system host-if-add <hostname> -m <mtu> -a <aemode> -x <txhashpolicy> <ifname> ae <ethname1> <ethname2>
~(keystone_admin)$ system host-if-add <hostname> -m <mtu> -a <aemode> -x <txhashpolicy> --primary-reselect <reselect_option> <ifname> ae <ethname1> <ethname2>
where the following options are available:
@@ -79,10 +79,16 @@ Settings <link-aggregation-settings>`.
|MTU| of the provider network to which the interface is attached.
**aemode**
The link aggregation mode.
The link aggregation mode. For information on valid values, see :ref:`Link Aggregation Settings <link-aggregation-settings>`.
**policy**
The balanced tx distribution hash policy.
The balanced tx distribution hash policy. For information on valid values, see :ref:`Link Aggregation Settings <link-aggregation-settings>`.
**reselect_option**
The parameter that specifies the reselection policy for the primary
slave of an aggregated ethernet active standby interface. For
information on valid values, see :ref:`Link Aggregation Settings
<link-aggregation-settings>`.
**hostname**
The name or UUID of the host.
@@ -110,6 +116,16 @@ Settings <link-aggregation-settings>`.
~(keystone_admin)$ system interface-datanetwork-assign controller-0 ae0 providernet-net-a
~(keystone_admin)$ system interface-datanetwork-assign controller-0 ae0 providernet-net-b
For example, to attach an aggregated Ethernet interface named **bond0** to
the platform management network, using member interfaces **enp0s8**
and **enp0s11** on **controller-0**:
.. code-block:: none
~(keystone_admin)$ system host-if-add controller-0 -c platform -a active_standby --primary-reselect failure bond0 ae enp0s8 enp0s11
~(keystone_admin)$ system interface-network-assign controller-0 bond0 mgmt
.. only:: partner
../../../_includes/configuring-aggregated-ethernet-interfaces-using-the-cli.rest

85
doc/source/node_management/kubernetes/node_interfaces/link-aggregation-settings.rst
View File

@@ -22,37 +22,6 @@ kernel Ethernet Bonding Driver documentation available online
.. _link-aggregation-settings-section-N10050-N10029-N10001:
-----------------------------------------
LAG Configurations for AIO Duplex Systems
-----------------------------------------
For a duplex-direct system set-up, use a |LAG| mode with active-backup for the
management interface when attaching cables between the active and standby
controller nodes. When both interfaces are enabled, the system automatically
selects the primary interface within the |LAG| with the lowest |MAC| address on
the active controller to connect to the primary interface within the |LAG| with
the lowest |MAC| address on the standby controller.
The controllers act independently of each other when selecting the primary
interface. Therefore, it is critical that the inter-node cabling is completed
to ensure that both nodes select a primary interface that is attached to the
primary interface of the opposite node. The inter-node management cabling
attachments must be from the lowest |MAC| address to the lowest |MAC| address
for the first cable, and the next lowest |MAC| address to the next lowest |MAC|
address for the second cable. Failure to follow these cabling requirements
will result in a loss of communication between the two nodes.
In addition to the special cabling requirements, the node BIOS settings may
need to be configured to ensure that the node attempts to network boot from
the lowest |MAC| address interface within the |LAG|. This may be required only on
systems that enable all hardware interfaces during network booting rather than
only enabling the interface that is currently selected for booting.
Configure the cables associated with the management |LAG| so that the primary
interface within the |LAG| with the lowest |MAC| address on the active
controller connects to the primary interface within the |LAG| with the lowest
|MAC| address on standby controller.
.. _link-aggregation-settings-table-kb5-rwb-ln:
.. list-table:: Table 1. Supported Link Aggregation Operational Modes
@@ -127,3 +96,57 @@ controller connects to the primary interface within the |LAG| with the lowest
- Hashes on source and destination IP addresses, and on source and
destination ports.
- |OAM|, internal management, and cluster-host
.. list-table:: Table 3. primary_reselect Options
:widths: auto
:header-rows: 1
* - Options
- Description
- Supported Interface Types
* - Always
\(default value\)
- The primary slave becomes an active slave whenever it comes back up.
- |OAM|, internal management, and cluster-host
* - Better
- The primary slave becomes active slave whenever it comes back up, if the
speed and the duplex of the primary slave is better than the speed duplex of the current active slave.
- |OAM|, internal management, and cluster-host
* - Failure
- The primary slave becomes the active slave only if the current active
slave fails and the primary slave is up.
- |OAM|, internal management, and cluster-host
-----------------------------------------
LAG Configurations for AIO Duplex Systems
-----------------------------------------
For a duplex-direct system set-up, use a |LAG| mode with active-backup for the
management interface when attaching cables between the active and standby
controller nodes. When both interfaces are enabled, the system automatically
selects the primary interface within the |LAG| with the lowest |MAC| address on
the active controller to connect to the primary interface within the |LAG| with
the lowest |MAC| address on the standby controller.
The controllers act independently of each other when selecting the primary
interface. Therefore, it is critical that the inter-node cabling is completed
to ensure that both nodes select a primary interface that is attached to the
primary interface of the opposite node. The inter-node management cabling
attachments must be from the lowest |MAC| address to the lowest |MAC| address
for the first cable, and the next lowest |MAC| address to the next lowest |MAC|
address for the second cable. Failure to follow these cabling requirements
will result in a loss of communication between the two nodes.
In addition to the special cabling requirements, the node BIOS settings may
need to be configured to ensure that the node attempts to network boot from
the lowest |MAC| address interface within the |LAG|. This may be required only on
systems that enable all hardware interfaces during network booting rather than
only enabling the interface that is currently selected for booting.
Configure the cables associated with the management |LAG| so that the primary
interface within the |LAG| with the lowest |MAC| address on the active
controller connects to the primary interface within the |LAG| with the lowest
|MAC| address on standby controller.