/
Kyvos Manager Rollback through Terminal

Kyvos Manager Rollback through Terminal

Important points to know

  • From Kyvos 2024.2 onwards, If Kyvos Reporting Service is deployed and you want to roll back the Kyvos Manager release earlier to 2024.2, then before performing Kyvos Manager rollback, you must remove Kyvos Reporting Service.

  • Logs of Kyvos Manager Tomcat Server will be generated in the kyvosmanagerdata/server/tomcatLogs path. If you rollback Kyvos Manager to an older version, logs will be generated inside the kyvosmanager_war/kyvosmanager/logs/ folder of the Kyvos Manager on which the rollback was performed.

  • In case of a Rollback, the previous state of Kyvos Manager is restored. In case you made any changes that you need in the previous state, you need to perform them again.

To roll back to a previous version, perform the following steps. 

  1. Create a backup for the Kyvos Manager data, perform the following steps.

  2. Log in to the Kyvos Manager machine through the terminal.

  3. Navigate to the Kyvos Manager installation path.

  4. Stop the Kyvos Manager process using the command:
    ./kyvosmanager_war/kyvosmanager/bin/stop-km.sh 

  5. Identify the location for the used kyvosmanagerdata  folder. For this, check the value of KM_DATA_DIR  in the set env.sh  file in the  bin  folder.
    This folder contains the Kyvos Manager data, including the repository.

  6. Go to the parent folder of the kyvosmanagerdata  folder and run the command.
    tar -zcvf file_name.tar.gz kyvosmanagerdata
    Here  file_name  is the user backup file name for the Kyvos Manager.

  7. Copy the backup file to the local machine.

  8. Rename your current  repo  folder at the  kyvosmanagerdata/server  location, such as repo_<current version number>. For example, you can rename it repo_2022.1

  9. Locate the version to which you want to roll back (for example, 2021.1), and rename its repo folder (such as repo_2021.1) to repo.

  10. Locate the build folder of the Kyvos Manager version to which you want to roll back (for example, 2021.1), and verify the correct value of KM_DATA_DIR  in the set env.sh  file in the  bin  folder.

  11. Start the required version of Kyvos Manager using the command:
    ./kyvosmanager_war/kyvosmanager/bin/start-km.sh

Note

If your cluster node password was updated or the encryption algorithm changed using Kyvos Manager 2021.2 onwards, then on rollback of Kyvos Manager to any build previous to version 2021.2, you need to reconfigure the c luster node password.

Kyvos Manager Rollback to previous releases not supporting Flexible Server

Kyvos Manager rollback to earlier releases (prior to the Kyvos 2023.5 releases that are not supporting Flexible server) when Kyvos Manager using external repository.

Copyright Kyvos, Inc. 2025. All rights reserved.