Upgrading Corteza
This guide helps you upgrade your Corteza to the newest version in no time!
While there are internal safeguards in place that can prevent data loss or other kinds of disasters, make sure you backup your database before you upgrade. Refer to devops guide on backup procedure for details. |
If you are upgrading multiple versions at the same time; for example from 2019.12 to 2020.9; you should follow all the upgrade guides between the two versions. |
Recommended Steps for Corteza Upgrade
-
upgrade your staging environment, or
-
deploy a temporary environment with a copy of the production database and perform a test upgrade there.
-
changing image versions in your
docker-compose.yaml
(or.env
) file, -
pull new images from docker hub with
docker-compose pull
, -
recreate containers with
docker-compose up -d
.
Upgrading to 2024.9.5
The newly added user groups requires database schema modifications that may not be backwards compatible.
The role_members
table receives a new rel_resource
column which is generated based on the rel_user
column.
After the upgrade, you need to either delete the rel_user
column or drop the requirement the rel_user
column is populated.
Before the Upgrade
Since the database schema will be modified, we recommend you create a backup just in case.