diff options
| author | Christian Poessinger <christian@poessinger.com> | 2019-12-20 15:11:09 +0100 | 
|---|---|---|
| committer | Christian Poessinger <christian@poessinger.com> | 2019-12-20 15:11:13 +0100 | 
| commit | 2707e08847b5fda46945bf8b0d7d7f51f739b927 (patch) | |
| tree | 5e1194479a39484f40387cd5bbc0d74a484a67ce | |
| parent | e3021ca833823405aefc7ff5b5d419cbd47ef4e1 (diff) | |
| download | vyos-documentation-2707e08847b5fda46945bf8b0d7d7f51f739b927.tar.gz vyos-documentation-2707e08847b5fda46945bf8b0d7d7f51f739b927.zip | |
clustering: remove broken/unmaintained features
Could be readded in the future with e.g. pacemaker/corosync.
| -rw-r--r-- | docs/clustering.rst | 76 | ||||
| -rw-r--r-- | docs/index.rst | 4 | 
2 files changed, 2 insertions, 78 deletions
| 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/index.rst b/docs/index.rst index 8305b344..45716a94 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -40,7 +40,6 @@ VyOS User Guide     qos     high-availability     vpn/index -   clustering     load-balancing     commandscripting     troubleshooting @@ -88,4 +87,5 @@ to this one.  Permission is granted to copy and distribute translations of this manual into  another language, under the above conditions for modified versions, except that  this permission notice may be stated in a translation approved by the VyOS -maintainers.
\ No newline at end of file +maintainers. + | 
