Page Comparison

Applies to:Kyvos Enterprise  Kyvos Cloud (SaaS on AWS) Kyvos AWS Marketplace

Kyvos Azure Marketplace   Kyvos GCP Marketplace Kyvos Single Node Installation (Kyvos SNI)

...

• Single-click upgrade for Kyvos Manager and Kyvos

• Upgrade Kyvos

• Upgrade Kyvos Manager

• Manually upgrading Kyvos Manager

• Kyvos Manager Tomcat Server logs 

• Upgrade Kyvos Manager in Azure

• Performing skip upgrade of Kyvos Manager

Single-click Upgrade for Kyvos Manager and Kyvos

You can easily upgrade both Kyvos and Kyvos Manager applications to a newer version by simply selecting the required version from the Kyvos Manager portal.

...

3. To see upgrade history, click the Actions menu (...) and select the View History option.

Upgrade Kyvos

You can also upgrade individual components such as Kyvos or Kyvos Manager.

To upgrade only Kyvos, select the Kyvos option from the Upgrade list. For the next on-screen options, refer to Single-click Kyvos Manager and Kyvos section.

...

Upgrade Kyvos Manager

You can also upgrade individual components such as Kyvos or Kyvos Manager.

To upgrade only Kyvos, select the Kyvos Manager option from the Upgrade list. For the next on-screen options, refer to Single-click Kyvos Manager and Kyvos section.

...

Manually upgrading Kyvos Manager

To upgrade Kyvos to a new version, perform the following steps.

1. If not stopped already, stop Kyvos Manager from the terminal using the following command.

   ./kyvosmanager/bin/stop-km.sh 

2. Copy the new Kyvos Manager setup on the machine parallel to the older version of Kyvos Manager is installed.
   For this: 

   1. Log in to the machine using the credentials of the user, which were used for installing the previous version.

   2. Download the setup from the FTP site to the location where you need to install it. For example, /data/kyvosXXXX.YY/

   3. For the older version of Kyvos Manager, we assume:

      1. Installation directory is located at /data/kyvos

      2. Kyvos Manager home directory is located at /data/kyvos/kyvosmanager

      3. Data directory is located at /data/kyvos/kyvosmanagerdata

3. Extract the Kyvos Manager bundle using the following command:
   tar -xvf KyvosManager<version>_ux64.tar.gz
   You will get a folder named kyvosmanager_war.

4. Make the following configurations in the setenv.sh file located at $KM_HOME/kyvosmanager_war/kyvosmanager/bin/

   1. Set absolute paths for the following variables, as shown in the examples.

      1. KM_BASE_DIR: Should point to the kyvosmanager_war folder.

      2. KM_DATA_DIR: Should point to kyvosmanagerdata folder of the older installation.
         Example: KM_DATA_DIR=/data/kyvosmanager_war/kyvosmanagerdata/

      3. JRE_HOME: Should point to the JRE folder in the kayvosmanager_war folder.
         Example: /data/kyvosmanager_war/jre/

5. Copy all the contents of the kyvosmanager_war/kyvosmanagerdata/server/repo/ folder to the KM_DATA_DIR/server/ location.

   Info
   Ensure that you copy ALL the contents of the repo folder i.e., the Kyvos bundle and the metadata.Kyvos folder.

6. Merge the contents of your existing conf/kyvosanager.properties file to the conf/kyvosanager.properties of the new version.

7. Copy the contents of the kyvosmanager_war/kyvosmanagerdata/server/repo/ folder to the KM_DATA_DIR/server/ location.

8. Start Kyvos Manager from the terminal using the command:

   Code Block
   cd       kyvosmanager_war/kyvosmanager/bin ./start-km.sh

9. Login to Kyvos Manager and check the version from the About page to verify a successful upgrade.

10. The Kyvos Manager cluster dashboard displays a warning message, prompting you to upgrade your Kyvos version. Click Upgrade. Now you can upgrade Kyvos .

Kyvos Manager Tomcat Server logs 

From Kyvos 2023.3 onwards, logs of Kyvos Manager Tomcat Server will be located in the kyvosmanagerdata/server/tomcatLogs path. 

Upgrade Kyvos Manager in Azure

• Applicable only when current Kyvos Manager is using the Single server.

• For Kyvos Manager, ensure that you use ARM template (FlexibleServerKyvosManagerRepository and FlexibleServerKyvosRepository) for the Flexible Server instance creation. You can also refer to the https://kyvosdocumentation.atlassian.net/wiki/spaces/KD202410/pages/238857907/Creating+ARM+Template+for+Automated+Azure+Deployment#FlexibleServer section.

• Any user running in Kyvos Manager build before 2023.1 first needs to upgrade to any version, such as 2023.1, lower than 2023.5 so that the Kyvos Manager database Derby first gets migrated to Postgres as the Kyvos Manager repository.

• First you need to upgrade both Kyvos Manager and Kyvos. After upgrading them, you need to migrate repository from Single Server to Flexible Server.

Performing skip upgrade of Kyvos Manager

Anchor
Skippingupgrade Skippingupgrade

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.

...