Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Issue #439 #442

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Issue #439 #442

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ceb161b
Issue #439
kirjaamo Aug 7, 2024
3028b5a
Issue 439
kirjaamo Aug 7, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 54 additions & 1 deletion galeracluster/source/documentation/mysql-wsrep-options.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <innodb-wsrep-applier-lock-wait-timeout>`", "``0``", "Yes", "Yes"
":ref:`plugin_wsrep_provider <plugin_wsrep_provider>`", "ON", "Yes", ""
":ref:`wsrep_applier_FK_failure_retries <wsrep_applier_FK_failure_retries>`", "``1``", "Yes", "Yes"
":ref:`wsrep_auto_increment_control <wsrep_auto_increment_control>`", "``ON``", "Yes", ""
":ref:`wsrep_causal_reads <wsrep_causal_reads>`", "``OFF``", "", ""
Expand Down Expand Up @@ -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"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is no such MariaDB. It is 11.x

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@byte Fixed.


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]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why do you say mysqld.1?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed. It came from the original example. See the link in the comment below.

wsrep-on=ON
wsrep-cluster-address=gcomm://
[email protected]_PROVIDER
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Where did you get this from? I have not personally used this, but might have to give it a go

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ref: https://jira.mariadb.org/browse/MDEV-22570

binlog-format=ROW
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if we must mention this now, 8.4 has deprecated this, see https://dev.mysql.com/doc/refman/8.4/en/replication-options-binary-log.html#sysvar_binlog_format

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed

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 <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``
Expand Down Expand Up @@ -1380,7 +1433,7 @@ For example, you can use :ref:`gcache.size <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 <plugin_wsrep_provider>`.

.. code-block:: mysql

Expand Down