break long line

[pve-docs.git] / pvecm.adoc

diff --git a/pvecm.adoc b/pvecm.adoc
index 813fe8d93b90212a83372562f61863809bd82370..0384d8190fcf810800bb7d80e765cdcb01aa2780 100644 (file)
--- a/pvecm.adoc
+++ b/pvecm.adoc
@@ -77,8 +77,12 @@ manually enabled first.
 
 * Root password of a cluster node is required for adding nodes.
 
-NOTE: It is not possible to mix Proxmox VE 3.x and earlier with
-Proxmox VE 4.0 cluster nodes.
+NOTE: It is not possible to mix {pve} 3.x and earlier with {pve} 4.X cluster
+nodes.
+
+NOTE: While it's possible for {pve} 4.4 and {pve} 5.0 this is not supported as
+production configuration and should only used temporarily during upgrading the
+whole cluster from one to another major version.
 
 
 Preparing Nodes
@@ -92,20 +96,27 @@ Currently the cluster creation can either be done on the console (login via
 `ssh`) or the API, which we have a GUI implementation for (__Datacenter ->
 Cluster__).
 
+While it's often common use to reference all other nodenames in `/etc/hosts`
+with their IP this is not strictly necessary for a cluster, which normally uses
+multicast, to work. It maybe useful as you then can connect from one node to
+the other with SSH through the easier to remember node name.
+
 [[pvecm_create_cluster]]
 Create the Cluster
 ------------------
 
 Login via `ssh` to the first {pve} node. Use a unique name for your cluster.
-This name cannot be changed later. The cluster name follows the same rules as node names.
+This name cannot be changed later. The cluster name follows the same rules as
+node names.
 
 ----
  hp1# pvecm create CLUSTERNAME
 ----
 
-CAUTION: The cluster name is used to compute the default multicast
-address. Please use unique cluster names if you run more than one
-cluster inside your network.
+CAUTION: The cluster name is used to compute the default multicast address.
+Please use unique cluster names if you run more than one cluster inside your
+network. To avoid human confusion, it is also recommended to choose different
+names even if clusters do not share the cluster network.
 
 To check the state of your cluster use:
 
@@ -362,7 +373,7 @@ when the now separate node exited, you may set the expected votes to 1 as a work
 pvecm expected 1
 ----
 
-And the repeat the 'pvecm delnode' command.
+And then repeat the 'pvecm delnode' command.
 
 Now switch back to the separated node, here delete all remaining files left
 from the old cluster. This ensures that the node can be added to another