From a548c04bef87430db68bd41692d9af8b42eca28f Mon Sep 17 00:00:00 2001
From: Ulf Wendel <uw@php.net>
Date: Mon, 11 Feb 2013 10:05:38 +0000
Subject: [PATCH] Notes on example configurations for various clusters

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@329459 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mysqlnd_ms/concepts.xml | 42 +++++++++++++++++++++++++++++--
 1 file changed, 40 insertions(+), 2 deletions(-)

diff --git a/reference/mysqlnd_ms/concepts.xml b/reference/mysqlnd_ms/concepts.xml
index 9eda7065a8..794a556bad 100755
--- a/reference/mysqlnd_ms/concepts.xml
+++ b/reference/mysqlnd_ms/concepts.xml
@@ -1601,6 +1601,44 @@ version = 5.6.2-m5-log
   <para>
    This is the primary use case of the plugin. Follow the hints given in the descriptions of each feature.
   </para>
+  <para>
+   <itemizedlist>
+    <listitem>
+     <simpara>
+      Configure one master and one or more slaves.
+      <link linkend="mysqlnd-ms.plugin-ini-json.server-list-syntax">Server configuration details</link>
+      are given in the setup section.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      Use random load balancing policy together with the
+      <link linkend="ini.mysqlnd-ms-plugin-config-v2.filter-random">sticky</link> flag.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      If you do not plan to use the
+      <link linkend="mysqlnd-ms.quickstart.qos-consistency">service level</link> API calls,
+      add the <link linkend="ini.mysqlnd-ms-plugin-config-v2.master-on-write">master on write</link>
+      flag.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      Please, make yourself aware of the properties of automatic failover before
+      adding a <link linkend="ini.mysqlnd-ms-plugin-config-v2.failover">failover</link> directive.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+       Consider the use of <link linkend="ini.mysqlnd-ms-plugin-config-v2.trx-stickiness">trx_stickiness</link>
+       to execute transactions on the primary only. Please, read carefully how it works
+       before you rely on it.
+     </simpara>
+    </listitem>
+   </itemizedlist>
+  </para>
   <para>
    <example>
     <title>Enabling the plugin (php.ini)</title>
@@ -1798,11 +1836,11 @@ mysqlnd_ms.multi_master=1
     <listitem>
      <simpara>
       Set
-      <link linkend="mysqlnd-ms.configuration"><literal>mysqlnd_ms.multi_master=1</literal></link>
+      <link linkend="mysqlnd-ms.configuration"><literal>mysqlnd_ms.multi_master=1</literal>.</link>
      </simpara>
     </listitem>
     <listitem>
-     <simpara>Do not configure any slaves</simpara>
+     <simpara>Do not configure any slaves.</simpara>
     </listitem>
     <listitem>
      <simpara>