summaryrefslogtreecommitdiff
path: root/docs/clustering.removed
diff options
context:
space:
mode:
authorrebortg <github@ghlr.de>2021-08-03 19:31:41 +0200
committerrebortg <github@ghlr.de>2021-08-03 19:31:41 +0200
commit8a201cc2117cee7dee182a1e5559e600db615e88 (patch)
tree43ecc6ef53ab7e4d95074eca46f3abf407689947 /docs/clustering.removed
parent740074af7aa370c63b1f4e9617dbf251a9610a37 (diff)
downloadvyos-documentation-8a201cc2117cee7dee182a1e5559e600db615e88.tar.gz
vyos-documentation-8a201cc2117cee7dee182a1e5559e600db615e88.zip
cluster: reactivate cluster docu
Diffstat (limited to 'docs/clustering.removed')
-rw-r--r--docs/clustering.removed76
1 files changed, 0 insertions, 76 deletions
diff --git a/docs/clustering.removed b/docs/clustering.removed
deleted file mode 100644
index 97678445..00000000
--- a/docs/clustering.removed
+++ /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