documentation updates (FAILOVER)

diff --git a/doc/adminguide/failover.sgml b/doc/adminguide/failover.sgml
index f40ef2e21a5c581478a04b33c4632632bd78f178..251679af5c10dd8145ae512944accd8670eb7907 100644 (file)
--- a/doc/adminguide/failover.sgml
+++ b/doc/adminguide/failover.sgml
@@ -265,6 +265,23 @@ they wish to support.
 </para>
 </sect2>
 
+<sect2 id="multiplefailures">
+<title>Multiple Node Failures</title>
+<para>
+If multiple nodes fail at the same time, maybe because an entire data-center has failed,
+then all failed nodes should be passed to the failover command. If we consider a cluster where  node 1 the origin of a set and provides a subscription to
+node 2 and node 3 then node 2 provides a subscription to node 4, what should happen if  both nodes 1 and 2 fail?
+Slony can be told about the failed nodes with the following command
+<programlisting>
+FAILOVER (node=(id=1, backup node=3), node=(id=2, backup node=3));
+</programlisting>
+
+This command requires that a paths exist between node 3 and 4. It will then redirect node 4 to receive the subscription from node 3.
+
+
+</para>
+</sect2>
+
 
 <sect2><title> Automating <command> FAIL OVER </command> </title>
 

diff --git a/doc/adminguide/slonik_ref.sgml b/doc/adminguide/slonik_ref.sgml
index 75d7937f390639fda619d26be9ea1e6d3e8edbdf..66b53e8311fa2ea478f2ef378d930dd2412d2ef6 100644 (file)
--- a/doc/adminguide/slonik_ref.sgml
+++ b/doc/adminguide/slonik_ref.sgml
@@ -2683,6 +2683,12 @@ MOVE SET (
          <literal>NODE=(ID=val,BACKUP NODE=val), NODE=(ID=val2, BACKUP NODE=val2)</literal> to FAILOVER.
        </para>
 
+
+       <para>
+         Nodes that are  forwarding providers can also be passed to the failover command as a failed
+      node.  The failover process will redirect the subscriptions from these nodes to the backup node. 
+       </para>
+
     <variablelist>
      <varlistentry><term><literal> ID = ival </literal></term>
       <listitem><para> ID of the failed node</para></listitem>

diff --git a/doc/adminguide/slony.sgml b/doc/adminguide/slony.sgml
index b57bc0ccf060805cd77b7940069b2028d9dcea66..46556df39a3f43b50caf664bb4146b3d42779adb 100644 (file)
--- a/doc/adminguide/slony.sgml
+++ b/doc/adminguide/slony.sgml
@@ -25,9 +25,9 @@
   <!ENTITY funsetdropsequence "<xref linkend= function.setdropsequence-p-seq-id-integer>">
   <!ENTITY funsetmovetable "<xref linkend= function.setmovetable-p-new-set-id-integer-p-tab-id-integer>">
 <!ENTITY funddlscript "<xref linkend=function.ddlscript-complete-p-nodes-text>">
-<!ENTITY fundropnode "<xref linkend=function.dropnode-p-no-id-integer>">
+<!ENTITY fundropnode "<xref linkend=function.dropnode-p-no-ids-integerarray>">
 <!ENTITY funenablenode "<xref linkend=function.enablenode-p-no-id-integer>">
-<!ENTITY funfailednode "<xref linkend=function.failednode-p-backup-node-integer-p-failed-node-integer>">
+<!ENTITY funfailednode "<xref linkend=function.failednode-p-failed-nodes-integer-p-backup-node-integer-p-failed-node-integerarray>">
 <!ENTITY funinitializelocalnode "<xref linkend=function.initializelocalnode-p-comment-integer-p-local-node-id-text>">
 <!ENTITY funlockset "<xref linkend=function.lockset-p-set-id-integer>">
 <!ENTITY funmoveset "<xref linkend=function.moveset-p-new-origin-integer-p-set-id-integer>">