extra/rgmanager: finally obsolete in favor of clufter

Summarize the clufter-based alternatives in the README.

Signed-off-by: Jan Pokorný <[email protected]>

Author: jnpkrn

.gitignore

@@ -139,9 +139,6 @@ tools/report.collector.1
 xml/crm.dtd
 xml/pacemaker*.rng
 xml/versions.rng
-extra/rgmanager/ccs2cib
-extra/rgmanager/ccs_flatten
-extra/rgmanager/disable_rgmanager
 doc/Clusters_from_Scratch.build
 doc/Clusters_from_Scratch/en-US/Ap-*.xml
 doc/Clusters_from_Scratch/en-US/Ch-*.xml

configure.ac

@@ -1886,7 +1886,6 @@ lrmd/Makefile                                                   \
         lrmd/pacemaker_remote					\
 extra/Makefile							\
 	extra/resources/Makefile				\
-	extra/rgmanager/Makefile				\
 	extra/logrotate/Makefile				\
 	extra/logrotate/pacemaker				\
 tools/Makefile							\

extra/Makefile.am

@@ -18,7 +18,7 @@
 
 MAINTAINERCLEANFILES    = Makefile.in
 
-SUBDIRS                 =  resources rgmanager logrotate
+SUBDIRS                 =  resources logrotate
 
 mibdir = $(datadir)/snmp/mibs
 mib_DATA = PCMK-MIB.txt

extra/rgmanager/Makefile.am

@@ -1,21 +1,30 @@
-Linux-cluster cluster.conf to Pacemaker CIB translation
-utility.
+# Legacy: Linux-cluster cluster.conf to Pacemaker CIB translation utility
 
-Development is on Fedora 14+
+This directory used contain several parts related to the procedure of
+cluster stacks/configuration migration, in particular and as the directory
+name suggests: from (CMAN+RGManager)-based stack of HA components to
+the (Corosync+Pacemaker)-based one.
 
-2 phases:
-	Step 1: Flatten tree
-	Step 2: Convert
+This initial effort laid here was used as a foundation for a more
+sophisticated and maintained tool, [clufter](https://github.com/jnpkrn/clufter),
+which has made local tool-set obsolete since then.
 
-Requires:
-	resource-agents
-	libxml2
-	java
-	saxon >= 9.1
-	java-1.6.0-openjdk
+In case any dependencies on previously offered bits arose as time was
+passing by, a mapping to the clufter-provided alternatives is provided:
 
-TODO:
-	* Fencing
-	* Resource-defaults  [ skipping ]
-	...
-	* Profit
+* `ccs2cib.in` resulting in `ccs2cib` conversion launcher
+  - use `clufter ccs2pcs` (perhaps with some switches) and wrap it with
+    some usage-specific script if suitable
+* `ccs_flatten.c` and the rest of C-files resulting in `ccs_flatten` binary
+  - you can find the same modulo few modifications in `ccs-flatten`
+    subdirectory within the released tarballs or repo itself
+    and the resulting binary is a crucial part of clufter installation
+* `cluconf2cib.xsl`
+  - deprecated in favor of multiple, sequentially chained XSL stylesheets
+    decomposed into tree-like structure (refer to `filters/cluster`
+    subdirectory but beware, it is accompanied with transformations for
+    various other purposes)
+* `disable_rgmanager.c` resulting in `disable_rgmanager` utility
+  - use `clufter ccs-disable-rg` (since `clufter-0.12.0`)
+* `tests` subdirectory
+  - configs have been put under `tests/cluster.conf/orig` in clufter repo

extra/rgmanager/README

@@ -0,0 +1 @@
+README