Cluster Administration
----------------------
-Cluster administration can be done from the GUI or by using the command
-line utility `pmgcm`. The CLI tool is a bit more verbose, so we suggest
+Cluster administration can be done from the GUI or by using the command-line
+utility `pmgcm`. The CLI tool is a bit more verbose, so we suggest
to use that if you run into any problems.
NOTE: Always set up the IP configuration, before adding a node to the
Creating a Cluster
~~~~~~~~~~~~~~~~~~
-[thumbnail="pmg-gui-cluster-panel.png", big=1]
+[thumbnail="screenshot/pmg-gui-cluster-panel.png", big=1]
You can create a cluster from any existing {pmg} host. All data is
preserved.
~~~~~~~~~~~~~~~~~~~
The GUI shows the status of all cluster nodes. You can also view this
-using the command line tool:
+using the command-line tool:
----
pmgcm status
Adding Cluster Nodes
~~~~~~~~~~~~~~~~~~~~
-[thumbnail="pmg-gui-cluster-join.png", big=1]
+[thumbnail="screenshot/pmg-gui-cluster-join.png", big=1]
When you add a new node to a cluster (using `join`), all data on that node is
destroyed. The whole database is initialized with the cluster data from
enter the 'fingerprint' of the master node. You can get this information
by pressing the `Add` button on the master node.
-NOTE: Joining a cluster, with enabled two-factor authentication for the
-`root` user is not supported - remove the second factor while joining the
-cluster.
+NOTE: Joining a cluster with two-factor authentication enabled for the `root`
+user is not supported. Remove the second factor when joining the cluster.
CAUTION: Node initialization deletes all existing databases, stops all
services accessing the database and then restarts them. Therefore, do