[Debian-ha-commits] [pcs] 03/03: Update README.Debian: cluster setup instructions

[Valentin Vidic]

This is an automated email from the git hooks/post-receive script.

vvidic-guest pushed a commit to branch master
in repository pcs.

commit be2e01d699c7630faba9a7f9bd090311aa05d0de
Author: Valentin Vidic <Valentin.Vidic at CARNet.hr>
Date:   Sun Dec 11 21:10:59 2016 +0100

    Update README.Debian: cluster setup instructions
---
 debian/README.Debian | 116 ++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 111 insertions(+), 5 deletions(-)

diff --git a/debian/README.Debian b/debian/README.Debian
index 17006e7..2fe0c81 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,7 +1,113 @@
-Building & Installing PCS for Debian
-----------------------------
+Instructions for PCS - Pacemaker/Corosync configuration system on Debian
+========================================================================
 
-The PCS package provides an init script for PCSD, but it is not registered 
-by default as to allow the end user to choose whether to utilize the init
-script.
+1. Adding PCS to an existing cluster
+------------------------------------
 
+These instructions assume you wish to install PCS on a running
+Pacemaker/Corosync cluster already configured using crmsh.
+
+First of all, install pcs package on all cluster nodes and
+check that pcsd service is running on each of the nodes:
+
+  # service pcsd status
+  * pcsd.service - PCS GUI and remote configuration interface
+     Loaded: loaded (/lib/systemd/system/pcsd.service; enabled; vendor preset: enabled)
+     Active: active (running) since Sun 2016-12-11 18:54:48 UTC; 8min ago
+
+Service pcsd uses TCP port 2224 so make sure this port is open
+for access by all cluster nodes.
+
+Next, set a password for hacluster user on all cluster nodes:
+
+  # passwd hacluster
+  Enter new UNIX password:
+  Retype new UNIX password:
+  passwd: password updated successfully
+
+Finally, authenticate the cluster nodes by running only on one of them:
+
+  # pcs cluster auth
+  Username: hacluster
+  Password:
+  node1: Authorized
+  node2: Authorized
+
+Cluster is now fully operational and both crm and pcs commands can
+be used to manage cluster resources:
+
+  # pcs cluster status
+  Cluster Status:
+   Stack: corosync
+   Current DC: node1 (version 1.1.16-94ff4df) - partition with quorum
+   Last updated: Sun Dec 11 19:10:26 2016
+   Last change: Sun Dec 11 18:55:45 2016 by hacluster via crmd on node1
+   2 nodes configured
+   1 resource configured
+
+  PCSD Status:
+    node1: Online
+    node2: Online
+
+
+2. Initializing a new cluster using PCS
+---------------------------------------
+
+These instructions assume you wish to create a new Pacemaker/Corosync
+cluster using PCS.
+
+WARNING: Do not run the commands from this section on a working
+cluster as they will delete the existing cluster configuration
+and therefore influence running cluster resources.
+
+First of all, install pcs package on all cluster nodes.  After
+package installation cluster services (corosync, pacemaker and pcsd)
+should be running on all nodes with default configuration.
+
+As PCS expects Corosync and Pacemaker to be in unconfigured state,
+the following command needs to be executed on all cluster nodes to
+stop the services and delete their default configuration:
+
+  # pcs cluster destroy
+  Shutting down pacemaker/corosync services...
+  Killing any remaining services...
+  Removing all cluster configuration files...
+
+Next, set a password for hacluster user on all cluster nodes:
+
+  # passwd hacluster
+  Enter new UNIX password:
+  Retype new UNIX password:
+  passwd: password updated successfully
+
+Then authenticate the cluster nodes by running only on one of them:
+
+  # pcs cluster auth node1 node2
+  Username: hacluster
+  Password:
+  node1: Authorized
+  node2: Authorized
+
+Finally, the cluster is configured and started by running on one
+of the nodes:
+
+  # pcs cluster setup --start --name debian node1 node2
+  Destroying cluster on nodes: node1, node2...
+  node1: Stopping Cluster (pacemaker)...
+  node2: Stopping Cluster (pacemaker)...
+  node1: Successfully destroyed cluster
+  node2: Successfully destroyed cluster
+
+  Sending cluster config files to the nodes...
+  node1: Succeeded
+  node2: Succeeded
+
+  Synchronizing pcsd certificates on nodes node1, node2...
+  node1: Success
+  node2: Success
+
+  Restarting pcsd on the nodes in order to reload the certificates...
+  node1: Success
+  node2: Success
+
+ -- Valentin Vidic <Valentin.Vidic at CARNet.hr>  Sun, 11 Dec 2016 20:49:18 +0100

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-ha/pcs.git