From d81ff636302fbfb19e878a996b18770170a19e31 Mon Sep 17 00:00:00 2001 From: Brad Jones Date: Mon, 1 Apr 2019 16:21:56 -0600 Subject: [PATCH 1/3] Add warning regarding GTID consistency --- guides/v2.1/install-gde/prereq/mysql.md | 6 ++++++ guides/v2.2/install-gde/prereq/mysql.md | 6 ++++++ guides/v2.3/install-gde/prereq/mysql.md | 6 ++++++ 3 files changed, 18 insertions(+) diff --git a/guides/v2.1/install-gde/prereq/mysql.md b/guides/v2.1/install-gde/prereq/mysql.md index 12a84851e20..d0f1ad56147 100644 --- a/guides/v2.1/install-gde/prereq/mysql.md +++ b/guides/v2.1/install-gde/prereq/mysql.md @@ -30,6 +30,12 @@ Magento _strongly_ recommends you observe the following standard when you set up * Familiarize yourself with [these potential MySQL trigger limitations](http://dev.mysql.com/doc/mysql-reslimits-excerpt/5.1/en/stored-program-restrictions.html){:target="_blank"} before you continue. * If you use MySQL database replication, be aware that Magento does _not_ support MySQL statement-based replication. Make sure you use _only_ [row-based replication](http://dev.mysql.com/doc/refman/5.1/en/replication-formats.html){:target="_blank"}. +{:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, +which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database +implementations utilizing GTID-based replication. +(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) See +[this ticket](https://github.com/magento/magento2/issues/15209) for further information. + {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{ page.baseurl }}/install-gde/prereq/mysql_remote.html). diff --git a/guides/v2.2/install-gde/prereq/mysql.md b/guides/v2.2/install-gde/prereq/mysql.md index 9ff85c03dd6..ac9055c2b8d 100644 --- a/guides/v2.2/install-gde/prereq/mysql.md +++ b/guides/v2.2/install-gde/prereq/mysql.md @@ -26,6 +26,12 @@ Magento _strongly_ recommends you observe the following standard when you set up * Familiarize yourself with [these potential MySQL trigger limitations](http://dev.mysql.com/doc/mysql-reslimits-excerpt/5.1/en/stored-program-restrictions.html){:target="_blank"} before you continue. * If you use MySQL database replication, be aware that Magento does _not_ support MySQL statement-based replication. Make sure you use _only_ [row-based replication](http://dev.mysql.com/doc/refman/5.1/en/replication-formats.html){:target="_blank"}. +{:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, +which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database +implementations utilizing GTID-based replication. +(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) See +[this ticket](https://github.com/magento/magento2/issues/15209) for further information. + {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{ page.baseurl }}/install-gde/prereq/mysql_remote.html). diff --git a/guides/v2.3/install-gde/prereq/mysql.md b/guides/v2.3/install-gde/prereq/mysql.md index 365b73c4f3e..b476d60dff3 100644 --- a/guides/v2.3/install-gde/prereq/mysql.md +++ b/guides/v2.3/install-gde/prereq/mysql.md @@ -26,6 +26,12 @@ Magento _strongly_ recommends you observe the following standard when you set up * Familiarize yourself with [these potential MySQL trigger limitations](http://dev.mysql.com/doc/mysql-reslimits-excerpt/5.1/en/stored-program-restrictions.html){:target="_blank"} before you continue. * If you use MySQL database replication, be aware that Magento does _not_ support MySQL statement-based replication. Make sure you use _only_ [row-based replication](http://dev.mysql.com/doc/refman/5.1/en/replication-formats.html){:target="_blank"}. +{:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, +which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database +implementations utilizing GTID-based replication. +(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) See +[this ticket](https://github.com/magento/magento2/issues/15209) for further information. + {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{page.baseurl }}/install-gde/prereq/mysql_remote.html). From 0ab4def8258a59c514d02d171147c3b6f0d00e0a Mon Sep 17 00:00:00 2001 From: Brad Jones Date: Mon, 8 Apr 2019 13:53:53 -0600 Subject: [PATCH 2/3] Update per PR feedback --- guides/v2.1/install-gde/prereq/mysql.md | 3 +-- guides/v2.2/install-gde/prereq/mysql.md | 3 +-- guides/v2.3/install-gde/prereq/mysql.md | 3 +-- 3 files changed, 3 insertions(+), 6 deletions(-) diff --git a/guides/v2.1/install-gde/prereq/mysql.md b/guides/v2.1/install-gde/prereq/mysql.md index d0f1ad56147..af2835fa556 100644 --- a/guides/v2.1/install-gde/prereq/mysql.md +++ b/guides/v2.1/install-gde/prereq/mysql.md @@ -33,8 +33,7 @@ Magento _strongly_ recommends you observe the following standard when you set up {:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database implementations utilizing GTID-based replication. -(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) See -[this ticket](https://github.com/magento/magento2/issues/15209) for further information. +(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{ page.baseurl }}/install-gde/prereq/mysql_remote.html). diff --git a/guides/v2.2/install-gde/prereq/mysql.md b/guides/v2.2/install-gde/prereq/mysql.md index ac9055c2b8d..da6fd2c39c4 100644 --- a/guides/v2.2/install-gde/prereq/mysql.md +++ b/guides/v2.2/install-gde/prereq/mysql.md @@ -29,8 +29,7 @@ Magento _strongly_ recommends you observe the following standard when you set up {:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database implementations utilizing GTID-based replication. -(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) See -[this ticket](https://github.com/magento/magento2/issues/15209) for further information. +(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{ page.baseurl }}/install-gde/prereq/mysql_remote.html). diff --git a/guides/v2.3/install-gde/prereq/mysql.md b/guides/v2.3/install-gde/prereq/mysql.md index b476d60dff3..c0ea4331f0f 100644 --- a/guides/v2.3/install-gde/prereq/mysql.md +++ b/guides/v2.3/install-gde/prereq/mysql.md @@ -29,8 +29,7 @@ Magento _strongly_ recommends you observe the following standard when you set up {:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database implementations utilizing GTID-based replication. -(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) See -[this ticket](https://github.com/magento/magento2/issues/15209) for further information. +(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{page.baseurl }}/install-gde/prereq/mysql_remote.html). From abc83910bc81f42999c78c747fc256173a2f31a9 Mon Sep 17 00:00:00 2001 From: Brad Jones Date: Mon, 8 Apr 2019 14:48:40 -0600 Subject: [PATCH 3/3] Update e.g. to such as --- guides/v2.1/install-gde/prereq/mysql.md | 4 ++-- guides/v2.2/install-gde/prereq/mysql.md | 4 ++-- guides/v2.3/install-gde/prereq/mysql.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/guides/v2.1/install-gde/prereq/mysql.md b/guides/v2.1/install-gde/prereq/mysql.md index af2835fa556..145b46265fb 100644 --- a/guides/v2.1/install-gde/prereq/mysql.md +++ b/guides/v2.1/install-gde/prereq/mysql.md @@ -32,8 +32,8 @@ Magento _strongly_ recommends you observe the following standard when you set up {:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database -implementations utilizing GTID-based replication. -(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) +implementations utilizing GTID-based replication, such as +[Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences). {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{ page.baseurl }}/install-gde/prereq/mysql_remote.html). diff --git a/guides/v2.2/install-gde/prereq/mysql.md b/guides/v2.2/install-gde/prereq/mysql.md index da6fd2c39c4..1f0cba4d6e4 100644 --- a/guides/v2.2/install-gde/prereq/mysql.md +++ b/guides/v2.2/install-gde/prereq/mysql.md @@ -28,8 +28,8 @@ Magento _strongly_ recommends you observe the following standard when you set up {:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database -implementations utilizing GTID-based replication. -(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) +implementations utilizing GTID-based replication, such as +[Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences). {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{ page.baseurl }}/install-gde/prereq/mysql_remote.html). diff --git a/guides/v2.3/install-gde/prereq/mysql.md b/guides/v2.3/install-gde/prereq/mysql.md index c0ea4331f0f..b3b224c45c7 100644 --- a/guides/v2.3/install-gde/prereq/mysql.md +++ b/guides/v2.3/install-gde/prereq/mysql.md @@ -28,8 +28,8 @@ Magento _strongly_ recommends you observe the following standard when you set up {:.bs-callout .bs-callout-warning} Magento 2 currently utilizes `CREATE TEMPORARY TABLE` statements inside transactions, which are [incompatible](https://dev.mysql.com/doc/refman/5.7/en/replication-gtids-restrictions.html) with database -implementations utilizing GTID-based replication. -(E.g., [Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences).) +implementations utilizing GTID-based replication, such as +[Google Cloud SQL second-generation instances](https://cloud.google.com/sql/docs/features#differences). {:.bs-callout .bs-callout-info} If your web server and database server are on different hosts, perform the tasks discussed in this topic on the database server host then see [Set up a remote MySQL database connection]({{page.baseurl }}/install-gde/prereq/mysql_remote.html).