Performing skip upgrade of Kyvos Manager

Performing skip upgrade of Kyvos Manager

From Kyvos 2024.1 onwards, there are manual steps required when performing skip upgrade of Kyvos Manager. This is only necessary when upgrading Kyvos Manager from a release earlier than 2023.1 (i.e. when the Kyvos Manager build uses Derby as the repository) to any release 2024.1 or later.

To perform skip upgrade of Kyvos Manager for the previous releases, perform the following steps.

  1. After the Kyvos Manager upgrade (from release earlier to 2023.1) to any release 2024.1 or onwards, a new version of Kyvos Manager will not start.

Note

  • The login page will not appear and the following error message will be displayed.

    image-20240118-134923.png
  1. Stop the new version of Kyvos Manager from its current home path using bin/stop-km.sh.

  2. Copy the existing Derby jar from the earlier running version of Kyvos Manager from path kyvosmanager/webapps/kyvosmanager/WEB-INF/lib/ to the latest running version of Kyvos Manager at the same path.

  3. Start the latest Kyvos Manager using the start-km.sh command.

  4. After logging in, you will be redirected to the Kyvos Manager repository database migration to perform the Kyvos Manager database migration from Derby to Postgres.

  5. Once the database migration is completed, ensure that Kyvos Manager is restarted.

Note
You don't need to manually remove the Derby jar from the latest kyvosmanager/webapps/kyvosmanager/WEB-INF/lib/ folder. This is because it's automatically migrated after the database migration. Moreover, the Derby jar has vulnerabilities, therefore Kyvos Manager will delete it from the lib folder.

Copyright Kyvos, Inc. 2025. All rights reserved.