svn: /phpdoc/en/trunk/reference/mysqlnd_ms/ concepts.xml

uw Mon, 11 Feb 2013 10:05:38 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=329459 Log: Notes on example configurations for various clusters Changed paths: U phpdoc/en/trunk/reference/mysqlnd_ms/concepts.xml Modified: phpdoc/en/trunk/reference/mysqlnd_ms/concepts.xml =================================================================== --- phpdoc/en/trunk/reference/mysqlnd_ms/concepts.xml 2013-02-09 23:56:24 UTC (rev 329458) +++ phpdoc/en/trunk/reference/mysqlnd_ms/concepts.xml 2013-02-11 10:05:38 UTC (rev 329459) @@ -1602,6 +1602,44 @@ 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> <programlisting role="ini"> @@ -1798,11 +1836,11 @@ <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>