From: Guillaume Lambert Date: Thu, 3 Jun 2021 10:11:03 +0000 (+0200) Subject: Fix even more spellchecker warnings X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=commitdiff_plain;h=4a03e12ea11c3365b59c0965de2db36ce39a75ec;p=docs.git Fix even more spellchecker warnings Signed-off-by: Guillaume Lambert Change-Id: I6a4ea52c9ef02d4134e97729501a7e0371bfbbd4 --- diff --git a/docs/getting-started-guide/clustering.rst b/docs/getting-started-guide/clustering.rst index 2d78442d2..d6c60b3cd 100644 --- a/docs/getting-started-guide/clustering.rst +++ b/docs/getting-started-guide/clustering.rst @@ -94,16 +94,16 @@ OpenDaylight includes some scripts to help with the clustering configuration. .. note:: - Scripts are stored in the OpenDaylight distribution/bin folder, and + Scripts are stored in the OpenDaylight ``distribution/bin`` folder, and maintained in the distribution project `repository `_ - in the folder distribution-karaf/src/main/assembly/bin/. + in the folder ``distribution-karaf/src/main/assembly/bin/``. Configure Cluster Script ^^^^^^^^^^^^^^^^^^^^^^^^ -This script is used to configure the cluster parameters (e.g. akka.conf, -module-shards.conf) on a member of the controller cluster. The user should +This script is used to configure the cluster parameters (e.g. ``akka.conf``, +``module-shards.conf``) on a member of the controller cluster. The user should restart the node to apply the changes. .. note:: @@ -124,7 +124,7 @@ the script. When running this script on multiple seed nodes, keep the seed_node_list the same, and vary the index from 1 through N. Optionally, shards can be configured in a more granular way by modifying the -file "custom_shard_configs.txt" in the same folder as this tool. Please see +file ``"custom_shard_configs.txt"`` in the same folder as this tool. Please see that file for more details. Example:: @@ -144,10 +144,10 @@ do the following on each machine: #. Copy the OpenDaylight distribution zip file to the machine. #. Unzip the distribution. -#. Open the following .conf files: +#. Open the following configuration files: - * configuration/initial/akka.conf - * configuration/initial/module-shards.conf + * ``configuration/initial/akka.conf`` + * ``configuration/initial/module-shards.conf`` #. In each configuration file, make the following changes: @@ -179,7 +179,7 @@ do the following on each machine: .. note:: This step should use a different role on each node. -#. Open the configuration/initial/module-shards.conf file and update the +#. Open the ``configuration/initial/module-shards.conf`` file and update the replicas so that each shard is replicated to all three nodes:: replicas = [ @@ -352,13 +352,13 @@ Sample ``module-shards.conf`` file:: Cluster Monitoring ------------------ -OpenDaylight exposes shard information via MBeans, which can be explored with -JConsole, VisualVM, or other JMX clients, or exposed via a REST API using +OpenDaylight exposes shard information via ``MBeans``, which can be explored +with ``JConsole``, VisualVM, or other JMX clients, or exposed via a REST API using `Jolokia `_, provided by the ``odl-jolokia`` Karaf feature. This is convenient, due to a significant focus on REST in OpenDaylight. -The basic URI that lists a schema of all available MBeans, but not their +The basic URI that lists a schema of all available ``MBeans``, but not their content itself is:: GET /jolokia/list @@ -469,7 +469,7 @@ statistics/counters. The ODLTools team is maintaining a Python based `tool `_, -that takes advantage of the above MBeans exposed via Jolokia. +that takes advantage of the above ``MBeans`` exposed via ``Jolokia``. .. _cluster_admin_api: @@ -580,9 +580,9 @@ Keep majority This strategy is used by default, because it works well for most systems. It will down the unreachable nodes if the current node is in the majority part -based on the last known membership information. Otherwise down the reachable nodes, -i.e. the own part. If the parts are of equal size the part containing the node with -the lowest address is kept. +based on the last known membership information. Otherwise down the reachable +nodes, i.e. the own part. If the parts are of equal size the part containing the +node with the lowest address is kept. This strategy is a good choice when the number of nodes in the cluster change dynamically and you can therefore not use static-quorum. @@ -630,19 +630,21 @@ This strategy is a good choice when you have a fixed number of nodes in the cluster, or when you can define a fixed number of nodes with a certain role. * If there are unreachable nodes when starting up the cluster, before reaching - this limit, the cluster may shut itself down immediately. This is not an issue - if you start all nodes at approximately the same time or use the - akka.cluster.min-nr-of-members to define required number of members before the - leader changes member status of ‘Joining’ members to ‘Up’. You can tune the - timeout after which downing decisions are made using the stable-after setting. + this limit, the cluster may shut itself down immediately. + This is not an issue if you start all nodes at approximately the same time or + use the ``akka.cluster.min-nr-of-members`` to define required number of + members before the leader changes member status of ‘Joining’ members to ‘Up’. + You can tune the timeout after which downing decisions are made using the + stable-after setting. * You should not add more members to the cluster than quorum-size * 2 - 1. - If the exceeded cluster size remains when a SBR decision is needed it will down - all nodes because otherwise there is a risk that both sides may down each other - and thereby form two separate clusters. + If the exceeded cluster size remains when a SBR decision is needed it will + down all nodes because otherwise there is a risk that both sides may down each + other and thereby form two separate clusters. * If the cluster is split into 3 (or more) parts each part that is smaller than - then configured quorum-size will down itself and possibly shutdown the whole cluster. + then configured quorum-size will down itself and possibly shutdown the whole + cluster. * If more nodes than the configured quorum-size crash at the same time the other running nodes will down themselves because they think that they are not in the @@ -697,8 +699,8 @@ singleton instance will be started on the next oldest node. if the oldest was Leaving and not changed to Exiting then each part will shut down itself, terminating the whole cluster. -The decision can be based on nodes with a configured role instead of all nodes in -the cluster. +The decision can be based on nodes with a configured role instead of all nodes +in the cluster. Configuration:: @@ -741,7 +743,7 @@ Lease The strategy named lease-majority is using a distributed lease (lock) to decide what nodes that are allowed to survive. Only one SBR instance can acquire the lease make -the decision to remain up. The other side will not be able to aquire the lease and +the decision to remain up. The other side will not be able to acquire the lease and will therefore down itself. This strategy is very safe since coordination is added by an external arbiter. @@ -780,7 +782,7 @@ Configuration:: Indirectly connected nodes ^^^^^^^^^^^^^^^^^^^^^^^^^^ -In a malfunctional network there can be situations where nodes are observed as +In a malfunctioning network there can be situations where nodes are observed as unreachable via some network links but they are still indirectly connected via other nodes, i.e. it’s not a clean network partition (or node crash). @@ -1037,8 +1039,8 @@ max-shard-data-change-listener-queue-size uint32 (1..max) 1000 The max max-shard-data-store-executor-queue-size uint32 (1..max) 5000 The maximum queue size for each shard's data store executor. shard-transaction-idle-timeout-in-minutes uint32 (1..max) 10 The maximum amount of time a shard transaction can be idle without receiving any messages before it self-destructs. shard-snapshot-batch-count uint32 (1..max) 20000 The minimum number of entries to be present in the in-memory journal log before a snapshot is to be taken. -shard-snapshot-data-threshold-percentage uint8 (1..100) 12 The percentage of Runtime.totalMemory() used by the in-memory journal log before a snapshot is to be taken -shard-hearbeat-interval-in-millis uint16 (100..max) 500 The interval at which a shard will send a heart beat message to its remote shard. +shard-snapshot-data-threshold-percentage uint8 (1..100) 12 The percentage of ``Runtime.totalMemory()`` used by the in-memory journal log before a snapshot is to be taken +shard-heartbeat-interval-in-millis uint16 (100..max) 500 The interval at which a shard will send a heart beat message to its remote shard. operation-timeout-in-seconds uint16 (5..max) 5 The maximum amount of time for akka operations (remote or local) to complete before failing. shard-journal-recovery-log-batch-size uint32 (1..max) 5000 The maximum number of journal log entries to batch on recovery for a shard before committing to the data store. shard-transaction-commit-timeout-in-seconds uint32 (1..max) 30 The maximum amount of time a shard transaction three-phase commit can be idle without receiving the next messages before it aborts the transaction @@ -1051,4 +1053,4 @@ persistent boolean true Enable shard-isolated-leader-check-interval-in-millis uint32 (1..max) 5000 the interval at which the leader of the shard will check if its majority followers are active and term itself as isolated ============================================== ================= ======= ============================================================================================================================================================================== -These configuration options are included in the etc/org.opendaylight.controller.cluster.datastore.cfg configuration file. +These configuration options are included in the ``etc/org.opendaylight.controller.cluster.datastore.cfg`` configuration file. diff --git a/docs/getting-started-guide/how-to-get-help.rst b/docs/getting-started-guide/how-to-get-help.rst index 1738d4296..cdc2850a2 100644 --- a/docs/getting-started-guide/how-to-get-help.rst +++ b/docs/getting-started-guide/how-to-get-help.rst @@ -12,16 +12,16 @@ mailing lists, IRC and forums. questions correctly to ensure that the questions reach individuals subscribed to the tag. -#. Mail discuss@lists.opendaylight.org or dev@lists.opendaylight.org. +#. Mail ``discuss@lists.opendaylight.org`` or ``dev@lists.opendaylight.org``. #. Directly mail the PTL as indicated on the specific `projects page `_. -#. IRC: Connect to #opendaylight or #opendaylight-meeting channel on freenode. +#. IRC: Connect to ``#opendaylight`` or ``#opendaylight-meeting`` channel on ``freenode``. The `Linux Foundation's IRC guide `_ may be helpful. You'll need `an IRC client `_, or can use `the freenode webchat `_, or perhaps you'll `like IRCCloud `_. -#. For infrastructure and release engineering queries, mail helpdesk@opendaylight.org. - IRC: Connect to #lf-releng channel on freenode. +#. For infrastructure and release engineering queries, mail ``helpdesk@opendaylight.org``. + IRC: Connect to ``#lf-releng`` channel on ``freenode``. diff --git a/docs/getting-started-guide/installing_opendaylight.rst b/docs/getting-started-guide/installing_opendaylight.rst index 6263bc784..0e4743c20 100644 --- a/docs/getting-started-guide/installing_opendaylight.rst +++ b/docs/getting-started-guide/installing_opendaylight.rst @@ -115,7 +115,7 @@ To list the installed Karaf features, run the following command:: feature:list -i -The decription of these features is in the project specific +The description of these features is in the project specific release notes :ref:`proj_rel_notes` section. Karaf running on Windows 10 @@ -128,11 +128,11 @@ Issue occurs during installation of karaf features e.g.:: Error executing command: Can't install feature odl-restconf/0.0.0: Could not start bundle mvn:org.fusesource.leveldbjni/leveldbjni-all/1.8-odl in feature(s) odl-akka-leveldb-0.7: The bundle "org.fusesource.leveldbjni.leveldbjni-all_1.8.0 [300]" could not be resolved. Reason: No match found for native code: META-INF/native/windows32/leveldbjni.dll; processor=x86; osname=Win32, META-INF/native/windows64/leveldbjni.dll; processor=x86-64; osname=Win32, META-INF/native/osx/libleveldbjni.jnilib; processor=x86; osname=macosx, META-INF/native/osx/libleveldbjni.jnilib; processor=x86-64; osname=macosx, META-INF/native/linux32/libleveldbjni.so; processor=x86; osname=Linux, META-INF/native/linux64/libleveldbjni.so; processor=x86-64; osname=Linux, META-INF/native/sunos64/amd64/libleveldbjni.so; processor=x86-64; osname=SunOS, META-INF/native/sunos64/sparcv9/libleveldbjni.so; processor=sparcv9; osname=SunOS -Workaround is to add +Workaround is to add:: org.osgi.framework.os.name = Win32 -to the karaf file +to the karaf file:: etc/system.properties diff --git a/docs/getting-started-guide/introduction.rst b/docs/getting-started-guide/introduction.rst index 27140797a..473529f0c 100644 --- a/docs/getting-started-guide/introduction.rst +++ b/docs/getting-started-guide/introduction.rst @@ -21,7 +21,7 @@ the following: the OpenDaylight controller, for example: * A plugin that provides connectivity to devices via the OpenFlow protocols - (openflowplugin). + (``openflowplugin``). * A platform service such as Authentication, Authorization, and Accounting (AAA). * A network service providing VM connectivity for OpenStack (netvirt). @@ -32,6 +32,6 @@ the following: * Model Driven Service Abstraction Layer (MD-SAL). Yang models play a key role in OpenDaylight and are used for: - * Creating datastore schemas (tree based structure). + * Creating datastore schemata (tree based structure). * Generating application REST API (RESTCONF). * Automatic code generation (Java interfaces and Data Transfer Objects). diff --git a/docs/getting-started-guide/security_considerations.rst b/docs/getting-started-guide/security_considerations.rst index afbdc21e5..7616e3e07 100644 --- a/docs/getting-started-guide/security_considerations.rst +++ b/docs/getting-started-guide/security_considerations.rst @@ -115,7 +115,7 @@ security model to add the following features: * A set of OSGi-specific permission types, such as one that grants the right to register an OSGi service or get an OSGi service from the service registry. -* The ability to dynamically modify permissions at runtime. This includes the +* The ability to dynamically modify permissions at run-time. This includes the ability to specify permissions by using code rather than a text configuration file. @@ -138,7 +138,7 @@ For more information, refer to https://www.osgi.org Securing the Karaf container ============================ -Apache Karaf is a OSGi-based runtime platform which provides a lightweight +Apache Karaf is a OSGi-based run-time platform which provides a lightweight container for OpenDaylight and applications. Apache Karaf uses either Apache Felix Framework or Eclipse Equinox OSGi frameworks, and provide additional features on top of the framework. @@ -200,12 +200,13 @@ mechanisms to connect to devices using the relevant plugins. Securing OpenDaylight using AAA =============================== -AAA stands for Authentication, Authorization, and Accounting. All three of -these services can help improve the security posture of an OpenDaylight deployment. +AAA stands for Authentication, Authorization, and Accounting. +All three of these services can help improve the security posture of an +OpenDaylight deployment. The vast majority of OpenDaylight's northbound APIs (and all RESTCONF APIs) are -protected by AAA by default when installing the +odl-restconf+ feature. In the -cases that APIs are *not* protected by AAA, this will be noted in the +protected by AAA by default when installing the ``+odl-restconf+`` feature. +In the cases that APIs are *not* protected by AAA, this will be noted in the per-project release notes. By default, OpenDaylight has only one user account with the username and diff --git a/docs/release-notes/index.rst b/docs/release-notes/index.rst index 90a0e9bd5..c82aa1a3f 100644 --- a/docs/release-notes/index.rst +++ b/docs/release-notes/index.rst @@ -23,7 +23,7 @@ If an application or tool is built on top of OpenDaylight’s REST APIs, it does have any special requirement beyond what is necessary to run the application or tool to make REST calls. -In some instances, OpenDaylight uses the `Xtend `_ lamguage. +In some instances, OpenDaylight uses the `Xtend `_ language. Even though Maven downloads all appropriate tools to build applications; additional plugins may be required to support IDE. diff --git a/docs/release-notes/projects/aaa.rst b/docs/release-notes/projects/aaa.rst index 76ab56ea8..567bb8131 100644 --- a/docs/release-notes/projects/aaa.rst +++ b/docs/release-notes/projects/aaa.rst @@ -8,7 +8,7 @@ Overview AAA (Authentication, Authorization, and Accounting) are services that help improve the security posture of an OpenDaylight deployment. By default, the majority of OpenDaylight’s northbound APIs (and all RESTCONF APIs) -are protected by AAA after installing the +odl-restconf+ feature. +are protected by AAA after installing the ``+odl-restconf+`` feature. Resolved Issues =============== diff --git a/docs/release-notes/projects/bgpcep.rst b/docs/release-notes/projects/bgpcep.rst index 2a8540cfe..7798d6198 100644 --- a/docs/release-notes/projects/bgpcep.rst +++ b/docs/release-notes/projects/bgpcep.rst @@ -19,10 +19,10 @@ Inter/Intra-AS peering The plugin's **north-bound API** (``REST``/``Java``) provides to user: -* Fully dynamic runtime standardized BGP configuration +* Fully dynamic run-time standardized BGP configuration * Read-only access to all RIBs * Read-write programmable RIBs -* Read-only reachability/linkstate topology view +* Read-only reachability/link-state topology view PCEP Plugin ----------- @@ -72,4 +72,4 @@ Known Issues Here is the link to the known issues exist in this release: -`OpenDaylight JIRA Tickets - Known Issue `_ \ No newline at end of file +`OpenDaylight JIRA Tickets - Known Issue `_ diff --git a/docs/release-notes/projects/distribution.rst b/docs/release-notes/projects/distribution.rst index e2e9ddda7..ec251bbea 100644 --- a/docs/release-notes/projects/distribution.rst +++ b/docs/release-notes/projects/distribution.rst @@ -15,13 +15,13 @@ distribution. The project currently generates 3 artifacts: * - **Artifact** - **Description** - * - **Managed distribution** (e.g., karaf-.tar.gz) + * - **Managed distribution** (e.g., ``karaf-.tar.gz``) - This includes the managed projects in OpenDaylight (refer to, :ref:`managed-release`). - * - **Common distribution** (e.g., opendaylight-.tar.gz) + * - **Common distribution** (e.g., ``opendaylight-.tar.gz``) - This includes managed and self-managed projects (refer to, :ref:`managed-release`). - * - **ONAP distribution** (e.g., onap-karaf-.tar.gz) + * - **ONAP distribution** (e.g., ``onap-karaf-.tar.gz``) - This is the distribution used in the ONAP CCSDK project. The distribution project is also the placeholder for the distribution @@ -63,4 +63,4 @@ Known Issues Here is the link to the known issues exist in this release: -`OpenDaylight JIRA Tickets - Known Issue `_ \ No newline at end of file +`OpenDaylight JIRA Tickets - Known Issue `_ diff --git a/docs/release-notes/projects/infrautils.rst b/docs/release-notes/projects/infrautils.rst index 69dfeb233..ac0eb5916 100644 --- a/docs/release-notes/projects/infrautils.rst +++ b/docs/release-notes/projects/infrautils.rst @@ -8,13 +8,13 @@ Overview The InfraUtils project provides a low-level utility for use by other OpenDaylight projects, including: * @Inject DI -* Utils incl. org.opendaylight.infrautils.utils.concurrent +* ``Utils`` incl. ``org.opendaylight.infrautils.utils.concurrent`` * Test Utilities * Job Coordinator * Ready Service -* Integration Test Utilities (itestutils) +* Integration Test Utilities (``itestutils``) * Caches -* Diagstatus +* ``Diagstatus`` * Metrics Behavior/Feature Changes @@ -51,4 +51,4 @@ Known Issues Here is the link to the known issues exist in this release: -`OpenDaylight JIRA Tickets - Known Issue `_ \ No newline at end of file +`OpenDaylight JIRA Tickets - Known Issue `_ diff --git a/docs/release-notes/projects/lispflowmapping.rst b/docs/release-notes/projects/lispflowmapping.rst index abf81389a..d9c1a0464 100644 --- a/docs/release-notes/projects/lispflowmapping.rst +++ b/docs/release-notes/projects/lispflowmapping.rst @@ -5,21 +5,24 @@ LISP Flow Mapping Overview ======== -LISP (Locator ID Separation Protocol) Flow Mapping service provides mapping services, -including LISP Map-Server and LISP Map-Resolver services that store and serve mapping -data to dataplane nodes and to OpenDaylight applications. Mapping data can include -mapping of virtual addresses to physical network addresses where the virtual nodes -are reachable or hosted. Mapping data can also include a variety of routing policies -including traffic engineering and load balancing. To leverage this service, -OpenDaylight applications and services can use the northbound REST API to -define the mappings and policies in the LISP Mapping Service. Dataplane -devices capable of LISP control protocol can leverage this service through -a southbound LISP plugin. LISP-enabled devices must be configured to use this -OpenDaylight service, since their Map- Server and/or Map-Resolver. - -Southbound LISP plugin supports the LISP control protocol (that is, Map-Register, -Map-Request, Map-Reply messages). It can also be used to register mappings in the -OpenDaylight mapping service. +LISP (Locator ID Separation Protocol) Flow Mapping service provides mapping +services, including LISP Map-Server and LISP Map-Resolver services that store +and serve mapping data to dataplane nodes and to OpenDaylight applications. +Mapping data can include mapping of virtual addresses to physical network +addresses where the virtual nodes are reachable or hosted. +Mapping data can also include a variety of routing policies including traffic +engineering and load balancing. +To leverage this service, OpenDaylight applications and services can use the +northbound REST API to define the mappings and policies in the LISP Mapping +Service. +Dataplane devices capable of LISP control protocol can leverage this service +through a southbound LISP plugin. +LISP-enabled devices must be configured to use this OpenDaylight service, +since their Map- Server and/or Map-Resolver. + +Southbound LISP plugin supports the LISP control protocol +(that is, Map-Register, Map-Request, Map-Reply messages). +It can also be used to register mappings in the OpenDaylight mapping service. Behavior/Feature Changes ======================== @@ -55,4 +58,4 @@ Known Issues Here is the link to the known issues exist in this release: -`OpenDaylight JIRA Tickets - Known Issue `_ \ No newline at end of file +`OpenDaylight JIRA Tickets - Known Issue `_ diff --git a/docs/release-notes/projects/openflowplugin.rst b/docs/release-notes/projects/openflowplugin.rst index a55b8599e..d93cf126d 100644 --- a/docs/release-notes/projects/openflowplugin.rst +++ b/docs/release-notes/projects/openflowplugin.rst @@ -7,18 +7,20 @@ Overview The OpenFlow Plugin project provides the following functionality: -* **OpenFlow 1.0/1.3 implementation project**: This provides the implementation of the - OpenFlow 1.0 and OpenFlow 1.3 specification. -* **ONF Approved Extensions Project**: This provides the implementation of following ONF - OpenFlow 1.4 feature, which is approved as extensions for the OpenFlow 1.3 - specification: +* **OpenFlow 1.0/1.3 implementation project**: This provides the implementation + of the OpenFlow 1.0 and OpenFlow 1.3 specification. +* **ONF Approved Extensions Project**: This provides the implementation of + following ONF OpenFlow 1.4 feature, which is approved as extensions + for the OpenFlow 1.3 specification: - * **Nicira Extensions Project**: This provides the implementation of the Nicira extensions. - Some of the important extensions implemented are **Connection Tracking Extension** - and **Group Add-Mod Extension** + * **Nicira Extensions Project**: This provides the implementation of the + ``Nicira`` extensions. + Some of the important extensions implemented are + **Connection Tracking Extension** and **Group Add-Mod Extension** -* **OpenFlow-Based Applications Project**: This provides the following applications that user can - leverage out-of-the-box in developing their application or as a direct end consumer: +* **OpenFlow-Based Applications Project**: This provides the following + applications that user can leverage out-of-the-box in developing their + application or as a direct end consumer: .. list-table:: OpenFlow-Based Applications :widths: 15 55 @@ -48,7 +50,7 @@ The OpenFlow Plugin project provides the following functionality: plugin data models to the OpenFlow java models before sending it down the wire to the device. * - **Reconciliation** - - Reconciles the state using Openflow 1.4 bundles. + - Reconciles the state using OpenFlow 1.4 bundles. Behavior/Feature Changes ======================== @@ -84,4 +86,4 @@ Known Issues Here is the link to the known issues exist in this release: -`OpenDaylight JIRA Tickets - Known Issue `_ \ No newline at end of file +`OpenDaylight JIRA Tickets - Known Issue `_ diff --git a/docs/spelling_wordlist.txt b/docs/spelling_wordlist.txt index c2de4f184..7e97e8194 100644 --- a/docs/spelling_wordlist.txt +++ b/docs/spelling_wordlist.txt @@ -9,9 +9,13 @@ abelur akka analytics BigInteger +boolean codebase config +Daexim Disruptor +dataplane +datastore datastores deliverables dev @@ -21,16 +25,24 @@ Git GPG hardcoded helpdesk +hostname ietf infrautils +intra Jenkins Jira jamoluhrsen +jarfile Karaf karaf lftools Magnesium mdsal +microservice +microservices +millis +mitigation +mitigations muxponders netvirt netconf @@ -40,20 +52,31 @@ OpenStack odlparent ovs ovsdb +PCE pre +Resolvers +Runtime reachability reconfigurable +reconnection reimplemented +remediations releng renderer rovarga +runtime +scalability +stateful submodule switchponders TCP TSC todo tsc +uint uncheck +unreachability +untrusted vTEP virtualenv yangtools