From ceb161b0dcc67bc67321757a86b5f4e51ade6a94 Mon Sep 17 00:00:00 2001 From: Kirjaamo Information Date: Wed, 7 Aug 2024 10:47:16 +0300 Subject: [PATCH 1/2] Issue #439 plugin-wsrep-provider added. --- .../documentation/mysql-wsrep-options.rst | 55 ++++++++++++++++++- 1 file changed, 54 insertions(+), 1 deletion(-) diff --git a/galeracluster/source/documentation/mysql-wsrep-options.rst b/galeracluster/source/documentation/mysql-wsrep-options.rst index 2900834f..9b685204 100644 --- a/galeracluster/source/documentation/mysql-wsrep-options.rst +++ b/galeracluster/source/documentation/mysql-wsrep-options.rst @@ -75,6 +75,7 @@ and an explanation. :header: "|br| Option", "|br| Default Value", "|br| Global ", "|br| Dynamic" :widths: 30, 30, 12, 12 ":ref:`innodb-wsrep-applier-lock-wait-timeout `", "``0``", "Yes", "Yes" + ":ref:`plugin_wsrep_provider `", "ON", "Yes", "" ":ref:`wsrep_applier_FK_failure_retries `", "``1``", "Yes", "Yes" ":ref:`wsrep_auto_increment_control `", "``ON``", "Yes", "" ":ref:`wsrep_causal_reads `", "``OFF``", "", "" @@ -183,6 +184,58 @@ You can execute the following ``SHOW VARIABLES`` statement to see how this varia | innodb-wsrep-applier-lock-wait-timeout | 10 | +----------------------------------------+-------+ + +.. _`plugin_wsrep_provider`: +.. rst-class:: section-heading +.. rubric:: ``plugin_wsrep_provider`` + +.. index:: + pair: Parameters; plugin_wsrep_provider + +Defines optional settings the node passes to the wsrep Provider. + +.. csv-table:: + :class: doc-options + + "Command-line Format", "``--plugin_wsrep_provider``" + "System Variable", "``plugin_wsrep_provider``" + "Variable Scope", "Global" + "Dynamic Variable", "" + "Permitted Values", "String" + "Default Value", "ON" + "Valied Values", "ON, OFF" + "Initial Version", "MySQL-wsrep: 8.4.2, MariaDB: 4.x" + +When this option is enabled, the node loads the wsrep Provider configuration options through the ``plugin_wsrep_provider`` plugin, instead of using ``wsrep_provider_options`` options. ``wsrep_provider_options`` options can no longer be used. + +The configuration required to use ``plugin_wsrep_provider``: + +.. code-block:: mysql + + [mysqld.1] + wsrep-on=ON + wsrep-cluster-address=gcomm:// + wsrep-provider=@ENV.WSREP_PROVIDER + binlog-format=ROW + plugin-wsrep-provider=ON + +Often it is not optimal to use a system variable, that is, one large string, for a long list of options. Instead, it would be better to separate the different options into separate cluster system variables. + +When this option is disabled, the node loads the wsrep Provider configuration options from ``wsrep_provider_options`` options. + +For more information on the wsrep Provider options, see :doc:`galera-parameters` and :ref:`wsrep_provider_options `. + +.. code-block:: mysql + + SHOW VARIABLES LIKE 'plugin_wsrep_provider'; + + +------------------------+-----------------------------------------------+ + | Variable_name | Value | + +------------------------+-----------------------------------------------+ + | plugin_wsrep_provider | ON | + +------------------------+-----------------------------------------------+ + + .. _`wsrep_applier_FK_failure_retries`: .. rst-class:: section-heading .. rubric:: ``wsrep_applier_FK_failure_retries`` @@ -1380,7 +1433,7 @@ For example, you can use :ref:`gcache.size ` to define how large a .. note:: All ``wsrep_provider_options`` settings need to be specified on a single line. In case of multiple instances of ``wsrep_provider_options``, only the last one is used. -For more information on the wsrep Provider options, see :doc:`galera-parameters`. +For more information on the wsrep Provider options, see :doc:`galera-parameters` and :ref:`plugin_wsrep_provider `. .. code-block:: mysql From 3028b5af2c7db7dcf37119692c517de337cf69a4 Mon Sep 17 00:00:00 2001 From: Kirjaamo Information Date: Wed, 7 Aug 2024 12:11:55 +0300 Subject: [PATCH 2/2] Issue 439 Pull request change requests done. --- galeracluster/source/documentation/mysql-wsrep-options.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/galeracluster/source/documentation/mysql-wsrep-options.rst b/galeracluster/source/documentation/mysql-wsrep-options.rst index 9b685204..03bc7f34 100644 --- a/galeracluster/source/documentation/mysql-wsrep-options.rst +++ b/galeracluster/source/documentation/mysql-wsrep-options.rst @@ -204,7 +204,7 @@ Defines optional settings the node passes to the wsrep Provider. "Permitted Values", "String" "Default Value", "ON" "Valied Values", "ON, OFF" - "Initial Version", "MySQL-wsrep: 8.4.2, MariaDB: 4.x" + "Initial Version", "MySQL-wsrep: 8.4.2, MariaDB: 11.x" When this option is enabled, the node loads the wsrep Provider configuration options through the ``plugin_wsrep_provider`` plugin, instead of using ``wsrep_provider_options`` options. ``wsrep_provider_options`` options can no longer be used. @@ -212,11 +212,9 @@ The configuration required to use ``plugin_wsrep_provider``: .. code-block:: mysql - [mysqld.1] wsrep-on=ON wsrep-cluster-address=gcomm:// wsrep-provider=@ENV.WSREP_PROVIDER - binlog-format=ROW plugin-wsrep-provider=ON Often it is not optimal to use a system variable, that is, one large string, for a long list of options. Instead, it would be better to separate the different options into separate cluster system variables.