Migrating Kyvos Manager repository
From Kyvos 2025.6 onwards, external PostgreSQL repository version 16 is supported on Azure (Flexible Server) and GCP (Cloud SQL). Existing deployments on Azure and GCP that are currently using an external PostgreSQL version 13 repository for Kyvos Manager can be migrated to an external PostgreSQL version 16 repository on both Azure and GCP, if required.
However, it is recommended to upgrade to an external PostgreSQL version 16, given the end-of-life (EOL) timeline for PostgreSQL 13.
To switch from the external PostgreSQL 13 to external PostgreSQL 16
Do one of the following:
Dump the existing external PostgreSQL repository (version 13) data and import it into the newly created external PostgreSQL repository (version 16). Update the jdbc.properties file of Kyvos Manager with the connection details of the new external repository.
-or-
Upgrade the existing external PostgreSQL 13 repository to version 16 using the cloud-native console (Azure or GCP). In this case, no changes are required in the jdbc.properties file of Kyvos Manager.
To switch from external PostgreSQL 16 to External PostgreSQL 13
Dump the existing external PostgreSQL 16 repository data.
Import the dump into the newly created external PostgreSQL 13 repository.
Update the jdbc.properties file accordingly.
To switch from Bundled PostgreSQL 13 to External PostgreSQL 16
Dump of the existing bundled PostgreSQL 13 repository data.
Import the dump into the newly created external PostgreSQL 16 repository.
Update the jdbc.properties file accordingly.
Migrating from External PostgreSQL 16 to Bundled PostgreSQL 13
Take a dump of the existing external PostgreSQL 16 repository data.
Import the dump into the bundled PostgreSQL 13 repository.
Update the jdbc.properties file accordingly.
Note
Whenever an external repository instance is changed or a switch occurs between bundled and external repositories, it is necessary to update the relevant properties in the jdbc.properties file, followed by a restart of the Kyvos Manager service.
The following table summarizes the recommended requirements for various migration cases:
Source Repository From | Target Repository To | Method | pg_dump Version |
|---|---|---|---|
Bundled | External 13 | DB Dump Export/Import | 13* |
Bundled | External 16 | DB Dump Export/Import | 13* |
External 13 | Bundled | DB Dump Export/Import | 13* |
External 16 | Bundled | DB Dump Export/Import | 16* |
External 13 | External 13 | DB Dump Export/Import | 13 |
External 13 | External 16 | DB Dump Export/Import | 13 |
External 16 | External 16 | In-Place Upgrade | Not applicable |
External 16 | External 16 | DB Dump Export/Import | 16 |
External 16 | External 13 | DB Dump Export/Import | 16* |
For Kyvos, switch the Repository.
For Kyvos Manager, update the jdbc.properties file.