From 22f03b67af9d3f8783d4b376bbcff6939fd3a4ca Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Guilhem=20Barth=C3=A9s?= Date: Fri, 28 Jun 2024 14:00:58 +0200 Subject: [PATCH] feat: add upgrade not for warning after release 0.38 (#423) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat: add upgrade not for warning after release 0.38 Signed-off-by: Guilhem Barthés * fix: change type for code-block Signed-off-by: Guilhem Barthés * fix: sphinx syntax Signed-off-by: Guilhem Barthés * doc: change order + fix typo Signed-off-by: Guilhem Barthés * doc: fix indentation Signed-off-by: Guilhem Barthés * doc: fix new lines Signed-off-by: Guilhem Barthés --------- Signed-off-by: Guilhem Barthés --- .../deploying-substra/upgrade-notes.rst | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/source/how-to/deploying-substra/upgrade-notes.rst b/docs/source/how-to/deploying-substra/upgrade-notes.rst index a3c57cf9..0491e147 100644 --- a/docs/source/how-to/deploying-substra/upgrade-notes.rst +++ b/docs/source/how-to/deploying-substra/upgrade-notes.rst @@ -4,6 +4,39 @@ Upgrade notes ************* +.. _ops upgrade notes 0.38: + +Substra 0.38.0 +-------------- + +This version upgrades the integrated PostgreSQL databases chart. After this uprade, you may get the following warning: + +.. code-block:: + + WARNING: database "" has a collation version mismatch + DETAIL: The database was created using collation version 2.31, but the operating system provides version 2.36. + HINT: Rebuild all objects in this database that use the default collation and run ALTER DATABASE REFRESH COLLATION VERSION, or build PostgreSQL with the right library version. + +.. note:: + + You need to apply the following command for the ``substra-backend`` and the ``orchestrator`` + +#. Gather required info: + + * Kubernetes namespace (here ``$NAMESPACE``) + * Helm release (hereafter ``$POD_NAME``, can be obtained from ``kubectl get pods -n $NAMESPACE``) + +#. Run the following commands + + #. For the backend: + + .. code-block:: bash + + kubectl exec -n $NAMESPACE $POD_NAME -- sh -c 'PGPASSWORD=$POSTGRES_PASSWORD psql -U $POSTGRES_USER $POSTGRES_DATABASE -c "REINDEX DATABASE;" -c " ALTER DATABASE \"$POSTGRES_DATABASE\" REFRESH COLLATION VERSION;"' + + #. For the orchestrator, use the previous command replacing ``POSTGRES_PASSWORD`` and ``POSTGRES_USER`` by their value + + .. _ops upgrade notes 0.34: Substra 0.34.0