Notes on example configurations for various clusters

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@329459 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Ulf Wendel 2013-02-11 10:05:38 +00:00
parent c91d2457f1
commit a548c04bef

View file

@ -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>