From 300491577c5dcb71780056db1fb0445434b6de91 Mon Sep 17 00:00:00 2001 From: Kirjaamo Information Date: Tue, 9 Mar 2021 09:41:13 +0200 Subject: [PATCH 1/5] Three MariaDB options were added. This push just to verify that the page works. --- galeracluster/source/documentation/index.rst | 1 + .../source/documentation/mariadb-options.rst | 216 ++++++++++++++++++ 2 files changed, 217 insertions(+) create mode 100644 galeracluster/source/documentation/mariadb-options.rst diff --git a/galeracluster/source/documentation/index.rst b/galeracluster/source/documentation/index.rst index ab9c92db..ddb55f7b 100644 --- a/galeracluster/source/documentation/index.rst +++ b/galeracluster/source/documentation/index.rst @@ -135,6 +135,7 @@ This is the Codership Documentation. It documents the latest version of Galera C ":doc:`wsrep-functions`", ":doc:`xtrabackup-options`" ":doc:`galera-parameters`", ":doc:`system-tables`" ":doc:`galera-status-variables`", ":doc:`versioning-information`" + ":doc:`mariadb-options`", "" .. container:: banner diff --git a/galeracluster/source/documentation/mariadb-options.rst b/galeracluster/source/documentation/mariadb-options.rst new file mode 100644 index 00000000..fbc20239 --- /dev/null +++ b/galeracluster/source/documentation/mariadb-options.rst @@ -0,0 +1,216 @@ +.. meta:: + :title: MariaDB Options + :description: + :language: en-US + :keywords: galera cluster, mariadb options, galera options + :copyright: Codership Oy, 2014 - 2021. All Rights Reserved. + + +.. container:: left-margin + + .. container:: left-margin-top + + :doc:`The Library <../index>` + + .. container:: left-margin-content + + .. cssclass:: here + + - :doc:`Documentation <./index>` + + - :doc:`Knowledge Base <../kb/index>` + - :doc:`Training <../training/index>` + + .. cssclass:: sub-links + + - :doc:`Tutorial Articles <../training/tutorials/index>` + - :doc:`Training Videos <../training/videos/index>` + + - :doc:`FAQ <../faq>` + - :ref:`search` + +.. container:: top-links + + - `Home `_ + + .. cssclass:: here + + - :doc:`Docs <./index>` + + - :doc:`KB <../kb/index>` + + .. cssclass:: nav-wider + + - :doc:`Training <../training/index>` + + - :doc:`FAQ <../faq>` + + +.. cssclass:: library-document +.. _`mariadb-options`: + +====================== +MariaDB Options +====================== +.. index:: + single: Drupal +.. index:: + pair: Logs; Debug log + + +These are MariaDB Server and Enterprise options. If you click on a particular variable in this table, your web browser will scroll down to the entry for it with more details and an explanation. + +.. _`mariadb_server_options`: +.. rst-class:: section-heading +.. rubric:: MariaDB Server Options + + +.. csv-table:: + :class: doc-options tight-header + :header: "|br| Option", "|br| Default Value", "|br| Global ", "|br| Dynamic", "Initial |br| Version", "Version |br| Deprecated" + :widths: 30, 42, 6, 6, 8, 8 + + ":ref:`wsrep_mode=REPLICATE_MYISAM `", "``OFF``", "Yes", "", "1.0", "" + ":ref:`wsrep_mode=REPLICATE_ARIA `", "``OFF``", "Yes", "", "1.0", "" + + + +.. _`wsrep_mode_replicate_myisam`: +.. rst-class:: section-heading +.. rubric:: ``wsrep_mode=REPLICATE_MYISAM`` + +.. index:: + pair: Parameters; wsrep_mode=REPLICATE_MYISAM + +Together with :ref:`wsrep_mode=REPLICATE_ARIA `, this parameter enables Galera to replicate both DDL and DML for MyISAM and/or Aria using TOI. + +For example: + +.. code-block:: mysql + + SET GLOBAL wsrep_mode = "REQUIRED_PRIMARY_KEY,REPLICATE_MYISAM,REPLICATE_ARIA"; + +Replicates both MyISAM and Aria DML, but requires a primary key for replicated table. + +.. csv-table:: + :class: doc-options + + "Command-line Format", "``--wsrep_mode_replicate_myisam``" + "System Variable", "``wsrep_mode_replicate_myisam``" + "Variable Scope", "Global" + "Dynamic Variable", "" + "Permitted Values", "Boolean" + "Default Value", "``OFF`` " + "Initial Version", "Version 1.0" + +You can execute the following ``SHOW VARIABLES`` statement to see how its set: + +.. code-block:: mysql + + SHOW VARIABLES LIKE 'wsrep_mode_replicate_myisam'; + + +------------------------------+-------+ + | Variable_name | Value | + +------------------------------+-------+ + | wsrep_mode_replicate_myisam | ON | + +------------------------------+-------+ + + + + +.. _`wsrep_mode_replicate_aria`: +.. rst-class:: section-heading +.. rubric:: ``wsrep_mode=REPLICATE_ARIA`` + +.. index:: + pair: Parameters; wsrep_mode=REPLICATE_ARIA + +Together with :ref:`wsrep_mode=REPLICATE_MYISAM `, this parameter enables Galera to replicate both DDL and DML for ARIA and/or MyISAM using TOI. + +For example: + +.. code-block:: mysql + + SET GLOBAL wsrep_mode = "REQUIRED_PRIMARY_KEY,REPLICATE_MYISAM,REPLICATE_ARIA"; + +Replicates both Aria and MyISAM DML, but requires a primary key for replicated table. + +.. csv-table:: + :class: doc-options + + "Command-line Format", "``--wsrep_mode_replicate_aria``" + "System Variable", "``wsrep_mode_replicate_aria``" + "Variable Scope", "Global" + "Dynamic Variable", "" + "Permitted Values", "Boolean" + "Default Value", "``OFF`` " + "Initial Version", "Version 1.0" + +You can execute the following ``SHOW VARIABLES`` statement to see how its set: + +.. code-block:: mysql + + SHOW VARIABLES LIKE 'wsrep_mode_replicate_aria'; + + +------------------------------+-------+ + | Variable_name | Value | + +------------------------------+-------+ + | wsrep_mode_replicate_aria | ON | + +------------------------------+-------+ + + +.. _`mariadb_enterprise_options`: +.. rst-class:: section-heading +.. rubric:: MariaDB Enterprise Options + +.. csv-table:: + :class: doc-options tight-header + :header: "|br| Option", "|br| Default Value", "|br| Global ", "|br| Dynamic", "Initial |br| Version", "Version |br| Deprecated" + :widths: 30, 42, 6, 6, 8, 8 + + ":ref:`wsrep_strict_ddl `", "``OFF``", "Yes", "", "1.0", "" + ":ref:`wsrep_mode=REPLICATE_ARIA `", "``OFF``", "Yes", "Yes", "", "" + + + +.. _`wsrep_strict_ddl`: +.. rst-class:: section-heading +.. rubric:: ``wsrep_strict_ddl`` + +.. index:: + pair: Parameters; wsrep_strict_ddl + +If set, rejects DDL on affected tables not supporting Galera replication. + + +.. csv-table:: + :class: doc-options + + "Command-line Format", "``--wsrep_mode_replicate_myisam``" + "System Variable", "``wsrep_mode_replicate_myisam``" + "Variable Scope", "Global" + "Dynamic Variable", "Yes" + "Permitted Values", "Boolean (OFF, ON)" + "Default Value", "``OFF`` " + "Initial Version", "Version 1.0" + +You can execute the following ``SHOW VARIABLES`` statement to see how its set: + +.. code-block:: mysql + + SHOW VARIABLES LIKE 'Parameters; wsrep_strict_ddl'; + + +------------------------------+-------+ + | Variable_name | Value | + +------------------------------+-------+ + | Parameters; wsrep_strict_ddl | OFF | + +------------------------------+-------+ + + +.. |---| unicode:: U+2014 .. EM DASH + :trim: + +.. |br| raw:: html + +
+ From 0ec8e9386c4f5e39f8bdcd9eaca3921a8517de56 Mon Sep 17 00:00:00 2001 From: Kirjaamo Information Date: Tue, 9 Mar 2021 09:50:38 +0200 Subject: [PATCH 2/5] Issue #254 One extra row removed for Enterprise table. --- galeracluster/source/documentation/mariadb-options.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/galeracluster/source/documentation/mariadb-options.rst b/galeracluster/source/documentation/mariadb-options.rst index fbc20239..21338623 100644 --- a/galeracluster/source/documentation/mariadb-options.rst +++ b/galeracluster/source/documentation/mariadb-options.rst @@ -168,9 +168,7 @@ You can execute the following ``SHOW VARIABLES`` statement to see how its set: :header: "|br| Option", "|br| Default Value", "|br| Global ", "|br| Dynamic", "Initial |br| Version", "Version |br| Deprecated" :widths: 30, 42, 6, 6, 8, 8 - ":ref:`wsrep_strict_ddl `", "``OFF``", "Yes", "", "1.0", "" - ":ref:`wsrep_mode=REPLICATE_ARIA `", "``OFF``", "Yes", "Yes", "", "" - + ":ref:`wsrep_strict_ddl `", "``OFF``", "Yes", "", "1.0", "" .. _`wsrep_strict_ddl`: From a50ac9ff0c1e4daa862f5e628dc8788e410ab92e Mon Sep 17 00:00:00 2001 From: Kirjaamo Information Date: Tue, 9 Mar 2021 11:51:50 +0200 Subject: [PATCH 3/5] wsrep-osu-mode was added --- .../source/documentation/mariadb-options.rst | 74 ++++++++++++++++++- 1 file changed, 71 insertions(+), 3 deletions(-) diff --git a/galeracluster/source/documentation/mariadb-options.rst b/galeracluster/source/documentation/mariadb-options.rst index 21338623..4f4a7438 100644 --- a/galeracluster/source/documentation/mariadb-options.rst +++ b/galeracluster/source/documentation/mariadb-options.rst @@ -168,7 +168,75 @@ You can execute the following ``SHOW VARIABLES`` statement to see how its set: :header: "|br| Option", "|br| Default Value", "|br| Global ", "|br| Dynamic", "Initial |br| Version", "Version |br| Deprecated" :widths: 30, 42, 6, 6, 8, 8 - ":ref:`wsrep_strict_ddl `", "``OFF``", "Yes", "", "1.0", "" + ":ref:`wsrep-OSU-mode `", "``OFF``", "Yes", "", "1.0", "" + ":ref:`wsrep_strict_ddl `", "``TOI``", "Global and Session", "Yes", "1.0", "" + + + + + + + +.. _`wsrep-osu-mode`: +.. rst-class:: section-heading +.. rubric:: ``wsrep-osu-mode`` + +.. index:: + pair: Parameters; wsrep-osu-mode + +This parameter defines the mode for Online Schema Upgrade that the node uses to replicate DDL statements. The following methods are available: + +DDL statements are non-transactional and as such don't replicate through write-sets. There are two methods available that determine how the node handles replicating these statements: + +- ``TOI`` In the :term:`Total Order Isolation` method, the cluster runs the DDL statement on all nodes in the same total order sequence, blocking other transactions from committing while the DDL is in progress. + +- ``RSU`` In the :term:`Rolling Schema Upgrade` method, the node runs the DDL statements locally, thus blocking only the one node where the statement was made. While processing the DDL statement, the node is not replicating and may be unable to process replication events due to a table lock. Once the DDL operation is complete, the node catches up and syncs with the cluster to become fully operational again. The DDL statement or its effects are not replicated; the user is responsible for manually executing this statement on each node in the cluster. + +- ``NBO`` When the Non Blocking Option is used, DDL statements are processed in three phases: + + # MDL lock requests for the operation are replicated first + + # DDL statements are not executed, with MDL protection + + # Finally, the MDL lock release requests are replicated + +For more information on DDL statements and OSU methods, see :doc:`schema-upgrades`. + +.. csv-table:: + :class: doc-options + + "Command-line Format", "``--wsrep-osu-mode``" + "System Variable", "``wsrep-osu-mode``" + "Variable Scope", "Global and Session" + "Dynamic Variable", "Yes" + "Permitted Values", "(TOI | RSU | NBO)" + "Default Value", "``TOI`` " + "Initial Version", "Version 1.0" + +You can execute the following ``SHOW VARIABLES`` statement to see how its set: + +.. code-block:: mysql + + SHOW VARIABLES LIKE 'Parameters; wsrep-osu-mode'; + + +------------------------------+-------+ + | Variable_name | Value | + +------------------------------+-------+ + | Parameters; wsrep-osu-mode | TOI | + +------------------------------+-------+ + + + + + + + + + + + + + .. _`wsrep_strict_ddl`: @@ -184,8 +252,8 @@ If set, rejects DDL on affected tables not supporting Galera replication. .. csv-table:: :class: doc-options - "Command-line Format", "``--wsrep_mode_replicate_myisam``" - "System Variable", "``wsrep_mode_replicate_myisam``" + "Command-line Format", "``--wsrep_strict_ddl``" + "System Variable", "``wsrep_strict_ddl``" "Variable Scope", "Global" "Dynamic Variable", "Yes" "Permitted Values", "Boolean (OFF, ON)" From cd6351c8f829cca48bed328d32ff96a382c54221 Mon Sep 17 00:00:00 2001 From: Kirjaamo Information Date: Tue, 9 Mar 2021 12:22:30 +0200 Subject: [PATCH 4/5] Table column widths were adjusted. One typo was fixed. --- galeracluster/source/documentation/mariadb-options.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/galeracluster/source/documentation/mariadb-options.rst b/galeracluster/source/documentation/mariadb-options.rst index 4f4a7438..49401a3d 100644 --- a/galeracluster/source/documentation/mariadb-options.rst +++ b/galeracluster/source/documentation/mariadb-options.rst @@ -68,7 +68,7 @@ These are MariaDB Server and Enterprise options. If you click on a particular va .. csv-table:: :class: doc-options tight-header :header: "|br| Option", "|br| Default Value", "|br| Global ", "|br| Dynamic", "Initial |br| Version", "Version |br| Deprecated" - :widths: 30, 42, 6, 6, 8, 8 + :widths: 30, 34, 12, 6, 8, 8 ":ref:`wsrep_mode=REPLICATE_MYISAM `", "``OFF``", "Yes", "", "1.0", "" ":ref:`wsrep_mode=REPLICATE_ARIA `", "``OFF``", "Yes", "", "1.0", "" @@ -166,7 +166,7 @@ You can execute the following ``SHOW VARIABLES`` statement to see how its set: .. csv-table:: :class: doc-options tight-header :header: "|br| Option", "|br| Default Value", "|br| Global ", "|br| Dynamic", "Initial |br| Version", "Version |br| Deprecated" - :widths: 30, 42, 6, 6, 8, 8 + :widths: 30, 34, 12, 6, 8, 8 ":ref:`wsrep-OSU-mode `", "``OFF``", "Yes", "", "1.0", "" ":ref:`wsrep_strict_ddl `", "``TOI``", "Global and Session", "Yes", "1.0", "" @@ -194,11 +194,11 @@ DDL statements are non-transactional and as such don't replicate through write-s - ``NBO`` When the Non Blocking Option is used, DDL statements are processed in three phases: - # MDL lock requests for the operation are replicated first + 1. MDL lock requests for the operation are replicated first - # DDL statements are not executed, with MDL protection + 2. DDL statements are executed, with MDL protection - # Finally, the MDL lock release requests are replicated + 3. Finally, the MDL lock release requests are replicated For more information on DDL statements and OSU methods, see :doc:`schema-upgrades`. From bb4641d7a47c0250215ed16610b1d0303925641b Mon Sep 17 00:00:00 2001 From: Kirjaamo Information Date: Wed, 10 Mar 2021 09:25:43 +0200 Subject: [PATCH 5/5] MariaDB versions for new options were added. --- galeracluster/source/documentation/mariadb-options.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/galeracluster/source/documentation/mariadb-options.rst b/galeracluster/source/documentation/mariadb-options.rst index 49401a3d..83daaeae 100644 --- a/galeracluster/source/documentation/mariadb-options.rst +++ b/galeracluster/source/documentation/mariadb-options.rst @@ -102,6 +102,7 @@ Replicates both MyISAM and Aria DML, but requires a primary key for replicated t "Permitted Values", "Boolean" "Default Value", "``OFF`` " "Initial Version", "Version 1.0" + "MariaDB Version", "Version 10.6" You can execute the following ``SHOW VARIABLES`` statement to see how its set: @@ -145,6 +146,7 @@ Replicates both Aria and MyISAM DML, but requires a primary key for replicated t "Permitted Values", "Boolean" "Default Value", "``OFF`` " "Initial Version", "Version 1.0" + "MariaDB Version", "Version 10.6" You can execute the following ``SHOW VARIABLES`` statement to see how its set: @@ -212,6 +214,7 @@ For more information on DDL statements and OSU methods, see :doc:`schema-upgrade "Permitted Values", "(TOI | RSU | NBO)" "Default Value", "``TOI`` " "Initial Version", "Version 1.0" + "MariaDB Version", "Version 10.5" You can execute the following ``SHOW VARIABLES`` statement to see how its set: @@ -259,6 +262,7 @@ If set, rejects DDL on affected tables not supporting Galera replication. "Permitted Values", "Boolean (OFF, ON)" "Default Value", "``OFF`` " "Initial Version", "Version 1.0" + "MariaDB Version", "Version 10.5" You can execute the following ``SHOW VARIABLES`` statement to see how its set: