From 92902e915e6f2a6906508bd23d90e2dcf4c539b3 Mon Sep 17 00:00:00 2001
From: Iustin Pop <iustin@google.com>
Date: Thu, 17 Mar 2011 18:24:35 +0100
Subject: [PATCH] Move htools-ganeti 2.3 design doc to doc/
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

I didn't know where to put in the TOC, so I added it after the ganeti
2.3 design doc.

Also, it seems that Sphinx is a bit limited in its list nesting
(compared to Pandoc), so I had to rework a bit the indentation (it
still doesn't generate good output, but…).

Signed-off-by: Iustin Pop <iustin@google.com>
Reviewed-by: Michael Hanselmann <hansmi@google.com>
---
 Makefile.am                                   |  1 +
 .../design-htools-2.3.rst                     | 35 ++++++++++---------
 doc/index.rst                                 |  1 +
 3 files changed, 20 insertions(+), 17 deletions(-)
 rename htools/doc/design-ganeti-2.3.rst => doc/design-htools-2.3.rst (92%)

diff --git a/Makefile.am b/Makefile.am
index 0fbad8a1f..490107ec1 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -240,6 +240,7 @@ docrst = \
 	doc/design-2.1.rst \
 	doc/design-2.2.rst \
 	doc/design-2.3.rst \
+	doc/design-htools-2.3.rst \
 	doc/design-2.4.rst \
 	doc/design-draft.rst \
 	doc/design-oob.rst \
diff --git a/htools/doc/design-ganeti-2.3.rst b/doc/design-htools-2.3.rst
similarity index 92%
rename from htools/doc/design-ganeti-2.3.rst
rename to doc/design-htools-2.3.rst
index a6beabd44..1e5cd3bbf 100644
--- a/htools/doc/design-ganeti-2.3.rst
+++ b/doc/design-htools-2.3.rst
@@ -213,23 +213,23 @@ Algorithm:
    (i.e. no other group sharing at least one storage method)
 #. determine list of healthy versus unhealthy groups:
 
-  #. a group which contains offline nodes still hosting instances is
-     definitely not healthy
-  #. a group which has nodes failing N+1 is β€˜weakly’ unhealthy
+    #. a group which contains offline nodes still hosting instances is
+       definitely not healthy
+    #. a group which has nodes failing N+1 is β€˜weakly’ unhealthy
 
 #. if either list is empty, exit (no work to do, or no way to fix problems)
 #. for each unhealthy group:
 
-  #. compute the instances that are causing the problems: all
-     instances living on offline nodes, all instances living as
-     secondary on N+1 failing nodes, all instances living as primaries
-     on N+1 failing nodes (in this order)
-  #. remove instances, one by one, until the source group is healthy
-    again
-  #. try to run a standard allocation procedure for each instance on
-     all potential groups in its partition
-  #. if all instances were relocated successfully, it means we have a
-     solution for repairing the original group
+    #. compute the instances that are causing the problems: all
+       instances living on offline nodes, all instances living as
+       secondary on N+1 failing nodes, all instances living as primaries
+       on N+1 failing nodes (in this order)
+    #. remove instances, one by one, until the source group is healthy
+       again
+    #. try to run a standard allocation procedure for each instance on
+       all potential groups in its partition
+    #. if all instances were relocated successfully, it means we have a
+       solution for repairing the original group
 
 Compression
 ^^^^^^^^^^^
@@ -246,10 +246,11 @@ The algorithm for β€œcompressing” the super cluster is as follows:
 #. computer per-group used and free *(memory, disk, cpu)*
 #. select candidate groups for evacuation:
 
-  #. they must be connected to other groups via a common storage type
-     and pool
-  #. they must have fewer used resources than the global free
-     resources (minus their own free resources)
+    #. they must be connected to other groups via a common storage type
+       and pool
+    #. they must have fewer used resources than the global free
+       resources (minus their own free resources)
+
 #. for each of these groups, try to relocate all its instances to
    connected peer groups
 #. report the list of groups that could be evacuated, or if instructed
diff --git a/doc/index.rst b/doc/index.rst
index e3a3a8f3c..75d9fd63d 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -19,6 +19,7 @@ Contents:
    design-2.1.rst
    design-2.2.rst
    design-2.3.rst
+   design-htools-2.3.rst
    design-2.4.rst
    design-draft.rst
    cluster-merge.rst
-- 
GitLab