From 5cbe8945ae978a04d554c3080fe843926009a25d Mon Sep 17 00:00:00 2001 From: currite Date: Fri, 18 Sep 2020 21:41:42 +0200 Subject: clustering: remove It keeps being in the directory as clustering.removed --- docs/clustering.removed | 76 +++++++++++++++++++++++++++++++++++++++++++++++++ docs/clustering.rst | 76 ------------------------------------------------- docs/conf.py | 2 +- docs/index.rst | 1 - 4 files changed, 77 insertions(+), 78 deletions(-) create mode 100644 docs/clustering.removed delete mode 100644 docs/clustering.rst diff --git a/docs/clustering.removed b/docs/clustering.removed new file mode 100644 index 00000000..97678445 --- /dev/null +++ b/docs/clustering.removed @@ -0,0 +1,76 @@ +.. _clustering: + +Clustering +========== + +The cluster feature allows 2 vyos routers to share IP addresses and various services. + +VyOS supports multicast clustering. + +.. note:: + Please follow the process of the cluster function here. https://phabricator.vyos.net/T985 + + +General cluster configuration +----------------------------- + +In the general cluster configuration the network interfaces used for monitoring and negotiation of the cluster health is defined. +Additionally, the communication interval settings, multicast group (for sending/receiving heartbeat messages), and pre-shared secret used in this monitoring is defined. + +.. code-block:: none + + vyos@vyos# set cluster + Possible completions: + dead-interval Interval after which a node is considered dead after missing heartbeats (milliseconds) + +> group Name of resource group for clustering [REQUIRED] + + interface Interface(s) for sending/receiving heartbeat packets [REQUIRED] + keepalive-interval Time interval between heartbeat packets (milliseconds) + mcast-group Multicast group for sending/receiving heartbeat packets + monitor-dead-interval Interval after which a monitor node is considered dead (milliseconds) + pre-shared-secret Pre-shared secret for authentication between cluster nodes [REQUIRED] + +Cluster group configuration +--------------------------- + +For the cluster group configuration, the group name must be defined before the groups configuration can be set (See Example below). +After the group name is defined, the specific service to be clustered between primary and secondary nodes is configured. + +.. code-block:: none + + vyos@vyos# set cluster group GROUPNAME + Possible completions: + auto-failback Fail back to primary node if it recovers from failure + + monitor IP address(es) for monitoring connectivity + primary Host name of the primary node [REQUIRED] + + secondary Host name(s) of the secondary node(s) [REQUIRED] + + service IP address(es) or service name(s) in this resource group [REQUIRED] + +Review cluster status +--------------------- + +.. code-block:: none + + vyos@vyos:~$ show cluster status + + +Example +------- + +In the example below SSH is clustered between two nodes. + +.. code-block:: none + + cluster { + dead-interval 20000 + group cluster { + auto-failback false + primary node1 + secondary node2 + service ssh + service 192.168.0.123/24/eth0 + } + interface eth0 + keepalive-interval 5000 + monitor-dead-interval 20000 + pre-shared-secret S3cr#t + } \ No newline at end of file diff --git a/docs/clustering.rst b/docs/clustering.rst deleted file mode 100644 index 97678445..00000000 --- a/docs/clustering.rst +++ /dev/null @@ -1,76 +0,0 @@ -.. _clustering: - -Clustering -========== - -The cluster feature allows 2 vyos routers to share IP addresses and various services. - -VyOS supports multicast clustering. - -.. note:: - Please follow the process of the cluster function here. https://phabricator.vyos.net/T985 - - -General cluster configuration ------------------------------ - -In the general cluster configuration the network interfaces used for monitoring and negotiation of the cluster health is defined. -Additionally, the communication interval settings, multicast group (for sending/receiving heartbeat messages), and pre-shared secret used in this monitoring is defined. - -.. code-block:: none - - vyos@vyos# set cluster - Possible completions: - dead-interval Interval after which a node is considered dead after missing heartbeats (milliseconds) - +> group Name of resource group for clustering [REQUIRED] - + interface Interface(s) for sending/receiving heartbeat packets [REQUIRED] - keepalive-interval Time interval between heartbeat packets (milliseconds) - mcast-group Multicast group for sending/receiving heartbeat packets - monitor-dead-interval Interval after which a monitor node is considered dead (milliseconds) - pre-shared-secret Pre-shared secret for authentication between cluster nodes [REQUIRED] - -Cluster group configuration ---------------------------- - -For the cluster group configuration, the group name must be defined before the groups configuration can be set (See Example below). -After the group name is defined, the specific service to be clustered between primary and secondary nodes is configured. - -.. code-block:: none - - vyos@vyos# set cluster group GROUPNAME - Possible completions: - auto-failback Fail back to primary node if it recovers from failure - + monitor IP address(es) for monitoring connectivity - primary Host name of the primary node [REQUIRED] - + secondary Host name(s) of the secondary node(s) [REQUIRED] - + service IP address(es) or service name(s) in this resource group [REQUIRED] - -Review cluster status ---------------------- - -.. code-block:: none - - vyos@vyos:~$ show cluster status - - -Example -------- - -In the example below SSH is clustered between two nodes. - -.. code-block:: none - - cluster { - dead-interval 20000 - group cluster { - auto-failback false - primary node1 - secondary node2 - service ssh - service 192.168.0.123/24/eth0 - } - interface eth0 - keepalive-interval 5000 - monitor-dead-interval 20000 - pre-shared-secret S3cr#t - } \ No newline at end of file diff --git a/docs/conf.py b/docs/conf.py index e2a059f2..97f31360 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -66,7 +66,7 @@ language = None # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This pattern also affects html_static_path and html_extra_path . -exclude_patterns = [u'_build', 'Thumbs.db', '.DS_Store'] +exclude_patterns = [u'_build', 'Thumbs.db', '.DS_Store', '*.removed'] # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' diff --git a/docs/index.rst b/docs/index.rst index a18c2720..e6e2bf38 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -45,7 +45,6 @@ Introduction services/index system/index high-availability - clustering load-balancing image-mgmt commandscripting -- cgit v1.2.3