From e4c61407f6eb091bfc4cdacb2783fd7378a07196 Mon Sep 17 00:00:00 2001 From: Peter Matulis Date: Wed, 16 Dec 2020 13:42:53 -0500 Subject: [PATCH] Improve percona-cluster series upgrade steps Include links from the percona-cluster charm README that were recently removed. Change-Id: I2b5da593c0229b0543468ade31a6519d1bd9bace --- .../percona-series-upgrade-to-focal.rst | 3 ++- .../source/upgrade-series-openstack.rst | 25 +++++++++++++++++++ 2 files changed, 27 insertions(+), 1 deletion(-) diff --git a/deploy-guide/source/percona-series-upgrade-to-focal.rst b/deploy-guide/source/percona-series-upgrade-to-focal.rst index a991667..91a8031 100644 --- a/deploy-guide/source/percona-series-upgrade-to-focal.rst +++ b/deploy-guide/source/percona-series-upgrade-to-focal.rst @@ -37,7 +37,7 @@ Procedure ^^^^^^^^^ * Leave all the percona-cluster machines on Bionic and upgrade the series of - the remaining machines in the cloud per this document. + the remaining machines in the cloud per the `Series upgrade OpenStack`_ page. * Deploy a mysql-innodb-cluster on Focal. @@ -171,3 +171,4 @@ its probable hacluster subordinates) may be removed. .. LINKS .. _Zaza migration code: https://github.com/openstack-charmers/zaza-openstack-tests/blob/master/zaza/openstack/charm_tests/mysql/tests.py#L556 .. _Percona strict mode: https://www.percona.com/doc/percona-xtradb-cluster/LATEST/features/pxc-strict-mode.html +.. _Series upgrade OpenStack: upgrade-series-openstack.html diff --git a/deploy-guide/source/upgrade-series-openstack.rst b/deploy-guide/source/upgrade-series-openstack.rst index 673e5fe..34a16bb 100644 --- a/deploy-guide/source/upgrade-series-openstack.rst +++ b/deploy-guide/source/upgrade-series-openstack.rst @@ -182,6 +182,17 @@ have the series of its corresponding machines upgraded sequentially. The example procedure will be based on the percona-cluster application. +.. warning:: + + The eoan series is the last series supported by the percona-cluster charm. + It is replaced by the `mysql-innodb-cluster`_ and `mysql-router`_ charms in the + focal series. The migration steps are documented in `percona-cluster charm + - series upgrade to focal`_. + + Do not upgrade the machines hosting percona-cluster units to the focal + series. To be clear, if percona-cluster is containerised then it is the LXD + container that must not be upgraded. + .. important:: Unlike percona-cluster, the ceph-mon and rabbitmq-server applications do not @@ -231,6 +242,14 @@ machine 1/lxd/0 (the principal leader machine). Permissions will need to be altered on the remote machine, and note that the last command transfers **all** existing backups. +.. note:: + + These upstream resources may also be useful: + + * `Upgrading Percona XtraDB Cluster`_ + * `Percona XtraDB Cluster In-Place Upgrading Guide From 5.5 to 5.6`_ + * `Galera replication - how to recover a PXC cluster`_ + #. Set the default series for both the model and the principal application: .. code-block:: none @@ -797,3 +816,9 @@ and test the series upgrade primitives: .. _Series upgrade: upgrade-series.html .. _Parallel tests: https://github.com/openstack-charmers/zaza-openstack-tests/blob/c492ecdcac3b2724833c347e978de97ea2e626d7/zaza/openstack/charm_tests/series_upgrade/parallel_tests.py#L64 .. _Upgrade helpers: https://github.com/openstack-charmers/zaza-openstack-tests/blob/9cec2efabe30fb0709bc098c48ec10bcb85cc9d4/zaza/openstack/utilities/parallel_series_upgrade.py +.. _Upgrading Percona XtraDB Cluster: https://www.percona.com/doc/percona-xtradb-cluster/LATEST/howtos/upgrade_guide.html +.. _Percona XtraDB Cluster In-Place Upgrading Guide From 5.5 to 5.6: https://www.percona.com/doc/percona-xtradb-cluster/5.6/upgrading_guide_55_56.html +.. _Galera replication - how to recover a PXC cluster: https://www.percona.com/blog/2014/09/01/galera-replication-how-to-recover-a-pxc-cluster +.. _mysql-innodb-cluster: https://jaas.ai/mysql-innodb-cluster +.. _mysql-router: https://jaas.ai/mysql-router +.. _percona-cluster charm - series upgrade to focal: percona-series-upgrade-to-focal.html