Inclusive Language Updates

Patch 1: Worked on Bart and Mary's comments.

Patch 2: Worked on Bart's comments.

Signed-off-by: egoncalv <elisamaraaoki.goncalves@windriver.com>
Change-Id: Ida78101e923dbce32a1c17ba45becb4b62f17c4d
This commit is contained in:
egoncalv 2021-06-11 09:28:12 -03:00
parent ccb1d63cc2
commit cd1f0e68ff
17 changed files with 62 additions and 59 deletions

View File

@ -734,7 +734,7 @@ Controller services management
****************************** ******************************
The following set of commands enables display of services running on the |prod| The following set of commands enables display of services running on the |prod|
controllers/masters. Optional services can be enabled or disabled using these controllers. Optional services can be enabled or disabled using these
commands. commands.
``servicenode-list`` ``servicenode-list``

View File

@ -20,10 +20,10 @@ storage, and worker functionalities are deployed on separate physical hosts
allowing controller nodes, storage nodes, and worker nodes to scale allowing controller nodes, storage nodes, and worker nodes to scale
independently from each other. independently from each other.
The controller nodes provide the master function for the system. Two controller The controller nodes provide the control-plane function for the
nodes are required to provide redundancy. The controller nodes' server and system. Two controller nodes are required to provide redundancy. The controller
peripheral resources such as CPU cores/speed, memory, storage, and network nodes' server and peripheral resources such as CPU cores/speed, memory,
interfaces can be scaled to meet requirements. storage, and network interfaces can be scaled to meet requirements.
Storage nodes provide a large scale Ceph cluster for the storage backend for Storage nodes provide a large scale Ceph cluster for the storage backend for
Kubernetes |PVCs|. They are deployed in replication groups of either two or Kubernetes |PVCs|. They are deployed in replication groups of either two or

View File

@ -29,7 +29,8 @@ are localized for maximum responsiveness. The architecture features:
- Centralized orchestration of edge cloud control planes. - Centralized orchestration of edge cloud control planes.
- Full synchronized control planes at edge clouds (that is, Kubernetes cluster - Full synchronized control planes at edge clouds (that is, Kubernetes cluster
master and nodes), with greater benefits for local services, such as: control-plane and worker nodes), with greater benefits for local
services, such as:
- Reduced network latency. - Reduced network latency.
- Operational availability, even if northbound connectivity - Operational availability, even if northbound connectivity

View File

@ -272,7 +272,7 @@ were used to do time synchronization on the TSN network.
#. Launch ``ptp4l`` on both the TSN switch and ``Node 2 (Ubuntu)`` to #. Launch ``ptp4l`` on both the TSN switch and ``Node 2 (Ubuntu)`` to
synchronize their PTP clocks. The TSN switch's PTP clock was set as the synchronize their PTP clocks. The TSN switch's PTP clock was set as the
master clock by default. primary clock by default.
:: ::

View File

@ -22,8 +22,8 @@ asynchronous |PTP| status notifications and pull for the |PTP| state on demand.
.. _install-ptp-notifications-ul-ydy-ggf-t4b: .. _install-ptp-notifications-ul-ydy-ggf-t4b:
- The |PTP| port must be configured as Subordinate mode \(Slave mode\). For - The |PTP| port must be configured as Subordinate mode \(Secondary mode\).
more information, see, For more information, see,
.. xbooklink :ref:`|prod-long| System Configuration .. xbooklink :ref:`|prod-long| System Configuration
<system-configuration-management-overview>`: <system-configuration-management-overview>`:
@ -58,7 +58,7 @@ Use the following steps to install the **ptp-notification** application.
~(keystone_admin)]$ system host-label-assign controller-1 ptp-registration=true ~(keystone_admin)]$ system host-label-assign controller-1 ptp-registration=true
#. Assign the |PTP| notification label to the node that is configured with #. Assign the |PTP| notification label to the node that is configured with
a Slave |PTP| port. For example: a Secondary |PTP| port. For example:
.. code-block:: none .. code-block:: none

View File

@ -33,7 +33,7 @@ The following prerequisites are required before the integration:
.. _integrate-the-application-with-notification-client-sidecar-ul-iyd-mxf-t4b: .. _integrate-the-application-with-notification-client-sidecar-ul-iyd-mxf-t4b:
- The cloud is configured with a node that supports the Subordinate mode \(Slave mode\). - The cloud is configured with a node that supports the Subordinate mode \(Secondary mode\).
- The cloud is labeled with **ptp-registration=true**, and **ptp-notification=true**. - The cloud is labeled with **ptp-registration=true**, and **ptp-notification=true**.

View File

@ -29,7 +29,7 @@ same pod and communicates with the application via a REST API.
<https://docs.starlingx.io/api-ref/ptp-notification-armada-app/index.html>`__. <https://docs.starlingx.io/api-ref/ptp-notification-armada-app/index.html>`__.
- Supports the **ptp4l** module and |PTP| port that is configured in - Supports the **ptp4l** module and |PTP| port that is configured in
Subordinate mode \(Slave mode\). Subordinate mode \(Secondary mode\).
- The |PTP| status notifications are derived based on the following conditions: - The |PTP| status notifications are derived based on the following conditions:
@ -41,19 +41,19 @@ same pod and communicates with the application via a REST API.
.. table:: .. table::
:widths: auto :widths: auto
+---------------------+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ +---------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| Clock Status | Status | Description | | Clock Status | Status | Description |
+=====================+===================================================+====================================================================================================================================================+ +=====================+===================================================+========================================================================================================================================================+
| Freerun | Clock is out of sync state | - If portState is not "SLAVE" or ClockClass value is NOT "6, 7 or 135" or timeTraceable flag is FALSE. | | Freerun | Clock is out of sync state | - If portState is not "SECONDARY" or ClockClass value is NOT "6, 7 or 135" or timeTraceable flag is FALSE. |
| | | | | | | |
| | | - If holdover time exceeds its provided value. | | | | - If holdover time exceeds its provided value. |
| | | | | | | |
| | | - If PMC, ptp4l.conf, ptp4l or phc2sys are not accessible. | | | | - If PMC, ptp4l.conf, ptp4l or phc2sys are not accessible. |
+---------------------+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ +---------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| Locked | Clock is in sync state | If portState is "SLAVE" and ClockClass value is "6, 7 or 135" and timeTraceable flag is TRUE and PMC, ptp4l.conf, ptp4l or phc2sys are accessible. | | Locked | Clock is in sync state | If portState is "SECONDARY" and ClockClass value is "6, 7 or 135" and timeTraceable flag is TRUE and PMC, ptp4l.conf, ptp4l or phc2sys are accessible. |
+---------------------+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ +---------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| Holdover | Clock is in holdover state | If the state is transitioned from "Locked" to "Freerun" AND phc2sys is accessible, and holdover time does not expire. | | Holdover | Clock is in holdover state | If the state is transitioned from "Locked" to "Freerun" AND phc2sys is accessible, and holdover time does not expire. |
+---------------------+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ +---------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
**Integrated Containerized Applications** **Integrated Containerized Applications**

View File

@ -14,7 +14,7 @@ To configure a management |LAG| interface you
first need to remove the internal management network type from the existing first need to remove the internal management network type from the existing
management Ethernet interface and then add a new |AE| interface, specifying the management Ethernet interface and then add a new |AE| interface, specifying the
mgmt network type, ae interface type, 802.3 |AE| mode, transmit hash policy mgmt network type, ae interface type, 802.3 |AE| mode, transmit hash policy
and the slave interfaces. and the standby interfaces.
.. rubric:: |prereq| .. rubric:: |prereq|

View File

@ -86,7 +86,7 @@ Settings <link-aggregation-settings>`.
**reselect_option** **reselect_option**
The parameter that specifies the reselection policy for the primary The parameter that specifies the reselection policy for the primary
slave of an aggregated ethernet active standby interface. For standby of an aggregated ethernet active standby interface. For
information on valid values, see :ref:`Link Aggregation Settings information on valid values, see :ref:`Link Aggregation Settings
<link-aggregation-settings>`. <link-aggregation-settings>`.

View File

@ -34,20 +34,20 @@ kernel Ethernet Bonding Driver documentation available online
* - Active-backup * - Active-backup
\(default value\) \(default value\)
- Provides fault tolerance. Only one slave interface at a time is - Provides fault tolerance. Only one standby interface at a time is
available. The backup slave interface becomes active only when the available. The backup standby interface becomes active only when the
active slave interface fails. active standby interface fails.
For platform interfaces \(such as, |OAM|, cluster-host, and management For platform interfaces \(such as, |OAM|, cluster-host, and management
interfaces\), the system will select the interface with the lowest interfaces\), the system will select the interface with the lowest
|MAC| address as the primary interface when all slave interfaces are |MAC| address as the primary interface when all standby interfaces are
enabled. enabled.
- Management, |OAM|, cluster-host, and data interface - Management, |OAM|, cluster-host, and data interface
* - Balanced XOR * - Balanced XOR
- Provides aggregated bandwidth and fault tolerance. The same - Provides aggregated bandwidth and fault tolerance. The same
slave interface is used for each destination |MAC| address. standby interface is used for each destination |MAC| address.
This mode uses the default transmit policy, where the target slave This mode uses the default transmit policy, where the target standby
interface is determined by calculating the source |MAC| address XOR'd interface is determined by calculating the source |MAC| address XOR'd
with the destination |MAC| address, modulo 2. with the destination |MAC| address, modulo 2.
@ -108,15 +108,16 @@ kernel Ethernet Bonding Driver documentation available online
* - Always * - Always
\(default value\) \(default value\)
- The primary slave becomes an active slave whenever it comes back up. - The primary standby becomes an active standby whenever it comes back up.
- |OAM|, internal management, and cluster-host - |OAM|, internal management, and cluster-host
* - Better * - Better
- The primary slave becomes active slave whenever it comes back up, if the - The primary standby becomes active standby whenever it comes back up,
speed and the duplex of the primary slave is better than the speed duplex of the current active slave. if the speed and the duplex of the primary standby is better than the
speed duplex of the current active standby.
- |OAM|, internal management, and cluster-host - |OAM|, internal management, and cluster-host
* - Failure * - Failure
- The primary slave becomes the active slave only if the current active - The primary standby becomes the active standby only if the current active
slave fails and the primary slave is up. standby fails and the primary standby is up.
- |OAM|, internal management, and cluster-host - |OAM|, internal management, and cluster-host
----------------------------------------- -----------------------------------------

View File

@ -267,8 +267,8 @@ In the demo
* ``ptp4l`` daemons run on both the edge gateway and edge device to sync * ``ptp4l`` daemons run on both the edge gateway and edge device to sync
the PTP clock based on IEEE 802.1AS Generalized Precision Time Protocol (gPTP), the PTP clock based on IEEE 802.1AS Generalized Precision Time Protocol (gPTP),
with the edge gateway serving as grandmaster clock and the edge device serving with the edge gateway serving as primary clock and the edge device serving
as slave clock. as secondary clock.
* ``phc2sys`` daemons run on both devices to synchronize the system clock with * ``phc2sys`` daemons run on both devices to synchronize the system clock with
the PTP clock. the PTP clock.
@ -353,7 +353,7 @@ interfering best-effort traffic enters the system.
Time Aware Shaper (TAS) demo Time Aware Shaper (TAS) demo
---------------------------- ----------------------------
This demo focuses on the use of IEEE 802.1Qbv or Time Aware Shaper (TAS) and This demo focuses on the use of |IEEE| 802.1Qbv or Time Aware Shaper (TAS) and
the LaunchTime feature of Intel® Ethernet Controller I210 to ensure much more the LaunchTime feature of Intel® Ethernet Controller I210 to ensure much more
bounded and low latency for period control applications. It includes 3 scenarios: bounded and low latency for period control applications. It includes 3 scenarios:
@ -364,9 +364,9 @@ bounded and low latency for period control applications. It includes 3 scenarios
In the demo In the demo
* ``ptp4l`` daemons run on both the edge gateway and edge device to sync the * ``ptp4l`` daemons run on both the edge gateway and edge device to sync the
PTP clock based on IEEE 802.1AS Generalized Precision Time Protocol (gPTP), PTP clock based on |IEEE| 802.1AS Generalized Precision Time Protocol (gPTP),
with the edge gateway serving as grandmaster clock and the edge device serving with the edge gateway serving as primary clock and the edge device serving
as slave clock. as secondary clock.
* ``phc2sys`` daemons run on both devices to synchronize the system clock with * ``phc2sys`` daemons run on both devices to synchronize the system clock with
the PTP clock. the PTP clock.

View File

@ -9,9 +9,9 @@ Storage Network
The storage network is an optional network that is only required if using an The storage network is an optional network that is only required if using an
external Netapp Trident cluster as a storage backend. external Netapp Trident cluster as a storage backend.
The storage network provides connectivity between all nodes in the The storage network provides connectivity between all nodes in the |prod-long|
|prod-long| cluster \(controller/master nodes and worker nodes\) and the cluster \(controller nodes and worker nodes\) and the Netapp
Netapp Trident cluster. Trident cluster.
For the most part, the storage network shares the design considerations For the most part, the storage network shares the design considerations
applicable to the internal management network. applicable to the internal management network.

View File

@ -5,7 +5,7 @@
Configure Local CLI Access Configure Local CLI Access
========================== ==========================
You can access the system via a local CLI from the active controller/master You can access the system via a local CLI from the active controller
node's local console or by SSH-ing to the OAM floating IP Address. node's local console or by SSH-ing to the OAM floating IP Address.
.. rubric:: |context| .. rubric:: |context|

View File

@ -139,7 +139,7 @@ Where:
.. note:: .. note::
UDP ports 2222 and 2223 are used by the service manager for state UDP ports 2222 and 2223 are used by the service manager for state
synchronization and heart beating between the controllers/masters. All synchronization and heart beating between the controllers. All messages are
messages are authenticated with a SHA512 HMAC. Only packets originating authenticated with a SHA512 HMAC. Only packets originating from the peer
from the peer controller are permitted; all other packets are dropped. controller are permitted; all other packets are dropped.

View File

@ -73,7 +73,7 @@ At a high-level, the default configuration for the two mandatory applications is
- nginx-ingress-controller - nginx-ingress-controller
- Runs as a DaemonSet only on masters/controllers. - Runs as a DaemonSet only on controllers.
- Uses host networking, which means it can use any port numbers. - Uses host networking, which means it can use any port numbers.
@ -85,7 +85,7 @@ At a high-level, the default configuration for the two mandatory applications is
- cert-manager - cert-manager
- Runs as a Deployment only on masters/controllers. - Runs as a Deployment only on controllers.
- Runs with a podAntiAffinity rule to prevent multiple pods of - Runs with a podAntiAffinity rule to prevent multiple pods of
deployment from running on the same node. deployment from running on the same node.

View File

@ -44,6 +44,7 @@
.. |FQDNs| replace:: :abbr:`FQDNs (Fully Qualified Domain Names)` .. |FQDNs| replace:: :abbr:`FQDNs (Fully Qualified Domain Names)`
.. |GNP| replace:: :abbr:`GNP (Global Network Policy)` .. |GNP| replace:: :abbr:`GNP (Global Network Policy)`
.. |ICMP| replace:: :abbr:`ICMP (Internet Control Message Protocol)` .. |ICMP| replace:: :abbr:`ICMP (Internet Control Message Protocol)`
.. |IEEE| replace:: :abbr:`IEEE (Institute of Electrical and Electronics Engineers)`
.. |IGMP| replace:: :abbr:`IGMP (Internet Group Management Protocol)` .. |IGMP| replace:: :abbr:`IGMP (Internet Group Management Protocol)`
.. |IoT| replace:: :abbr:`IoT (Internet of Things)` .. |IoT| replace:: :abbr:`IoT (Internet of Things)`
.. |IPMI| replace:: :abbr:`IPMI (Intelligent Platform Management Interface)` .. |IPMI| replace:: :abbr:`IPMI (Intelligent Platform Management Interface)`

View File

@ -188,14 +188,14 @@ To view the |PTP| service configuration, use the following command:
- **PTP Role** - **PTP Role**
|PTP| master/slave interfaces are not defined by default. They must be |PTP| primary/secondary interfaces are not defined by default. They must be
specified by the administrator for each host. specified by the administrator for each host.
The **ptp\_role** option can be added to interfaces, and can be defined The **ptp\_role** option can be added to interfaces, and can be defined for
for master, slave, and none. This option allows administrators to primary, secondary, and none. This option allows administrators to
configure interfaces that can be used for |PTP| services. The master and configure interfaces that can be used for |PTP| services. The primary and
slave roles are limited to platform, |SRIOV|, and VF interfaces. Any number secondary roles are limited to platform, |SRIOV|, and VF interfaces. Any
of master and slave interfaces can be specified per host. number of primary and secondary interfaces can be specified per host.
If a host has **clock\_synchronization=ptp**, there must be at least one If a host has **clock\_synchronization=ptp**, there must be at least one
host interface with a |PTP| role specified. This is enforced during host host interface with a |PTP| role specified. This is enforced during host