openstack
/
charm-deployment-guide
Code Issues Proposed changes

Improve percona-cluster series upgrade steps 

Include links from the percona-cluster charm
README that were recently removed.

Change-Id: I2b5da593c0229b0543468ade31a6519d1bd9bace
This commit is contained in:
Peter Matulis 2020-12-16 13:42:53 -05:00
parent 7175f1e39b
commit e4c61407f6
2 changed files with 27 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
deploy-guide/source/percona-series-upgrade-to-focal.rst
View File

@ -37,7 +37,7 @@ Procedure
^^^^^^^^^ ^^^^^^^^^
* Leave all the percona-cluster machines on Bionic and upgrade the series of * 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. * Deploy a mysql-innodb-cluster on Focal.
@ -171,3 +171,4 @@ its probable hacluster subordinates) may be removed.
.. LINKS .. LINKS
.. _Zaza migration code: https://github.com/openstack-charmers/zaza-openstack-tests/blob/master/zaza/openstack/charm_tests/mysql/tests.py#L556 .. _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 .. _Percona strict mode: https://www.percona.com/doc/percona-xtradb-cluster/LATEST/features/pxc-strict-mode.html
.. _Series upgrade OpenStack: upgrade-series-openstack.html

25
deploy-guide/source/upgrade-series-openstack.rst
View File

@ -182,6 +182,17 @@ have the series of its corresponding machines upgraded sequentially.
The example procedure will be based on the percona-cluster application. 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:: .. important::
Unlike percona-cluster, the ceph-mon and rabbitmq-server applications do not 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 Permissions will need to be altered on the remote machine, and note that the
last command transfers **all** existing backups. 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: #. Set the default series for both the model and the principal application:
.. code-block:: none .. code-block:: none
@ -797,3 +816,9 @@ and test the series upgrade primitives:
.. _Series upgrade: upgrade-series.html .. _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 .. _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 .. _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