/
Upgrading Kyvos and Kyvos Manager for Azure Marketplace Deployments

Upgrading Kyvos and Kyvos Manager for Azure Marketplace Deployments

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

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

This section provides information on how to upgrade Kyvos and Kyvos Manager and roll back patches.

Upgrading Kyvos and Kyvos Manager

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.

To upgrade Kyvos and Kyvos Manager, perform the following steps. 

  1. On the navigation bar, click Application Update > Upgrade. 

  2. The Upgrade page is displayed with the current version details of Kyvos and Kyvos Manager. 

  3. Select the required  Version  from the Upgrade To list to which you want to upgrade.  
    NOTE: In the Upgrade To list, all future versions available for upgrading will be displayed.

  4. To view upgrade options, click the  Show Upgrade Options  link, and configure the following options as needed.

Parameter/Field

Description

Parameter/Field

Description

Overwrite

Select this option to override the existing templates in your Kyvos environment.
NOTE: 

  • If the option is selected, a template will be generated.

  • If the option is not selected, t he old template will be copied with _backup as a suffix.

Backup 

  • Semantic Model:  Select this option to create a backup of the existing semantic model data in your Kyvos environment. This may slow down the deployment for taking the backup of semantic model data.

  • Log:  Select this option to create a backup of the existing logs of your Kyvos environment. 

  1. Click the Upgrade Now button on the top-right of the page.

     

Note

If the upgrade operation fails, you can resume it by clicking the Click to resume option. The upgrade will resume from the point where it last failed. Additionally, you can view the details of the failed operation by clicking the Click to view details option.

  1. On the displayed confirmation message box, select the Start Kyvos Service checkbox to start the service automatically after the upgrade.

  2. Enter your Kyvos Manager Password to confirm upgrade deployment.

Note

You need to manually restore the files uploaded from the Configuration Files page (if any), after upgrading Kyvos.
Before the upgrade, a backup will be created and saved at /data/kyvos/app/ location automatically.
Before applying the Kyvos upgrade, ensure that the Service account attached to the Kyvos Manager node has the permission required for updating Functions.

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

Rollback 

You can easily roll back both Kyvos and Kyvos Manager applications by simply selecting the required version from the Kyvos Manager portal.

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

  1. Create a manual backup of your existing cluster using the steps explained in the  Upgrading Kyvos Manager and Kyvos  section.

  2. On the navigation pane, click Application Update > Rollback.
    The Rollback page is displayed. 

  3. Click the Select rollback state link. From the displayed dialog box, choose the state to which you want to roll back. You can use the search box to Search for a specific version. The rollback state is selected. You can also change the rollback state using the Change rollback state link. 

  4. Select the required rollback version. 

  5. The Backup Path path shows the path used for creating/restoring a backup of Kyvos states in case of Deploy Upgrade and Deploy Patch/Rollback operations. The backup path should be consistent across all the available systems. You can edit this path using the Modify Backup Path option from the three-dots menu. A ny backup created prior to changing the path remains unaffected and will continue to be available at the same location.

  6. Click the Rollback Now button from the top-right of the page.

     

  7. On the displayed confirmation message box, select the Start Kyvos Service checkbox to start the service automatically after rollback.

  8. Enter your Kyvos Manager Password to confirm the rollback. Kyvos takes you to the   Operations page   followed by the   Rollback Logs   details page.

Note

If the Kyvos Manager rollback operation fails, followed by Kyvos rollback, you can resume it by clicking the  Click to resume  option. The Kyvos Manager rollback operation will resume from the point where it last failed. Additionally, you can view the details of the failed operation by clicking the  Click to view details  option.



Warning

If you are using an external repository for Kyvos, then after the Kyvos version rollback - you need to change to the previous version of the repository using the Switch repository feature.

Deploy a Patch 

To deploy a patch on an existing Kyvos version, perform the following steps.

Copyright Kyvos, Inc. 2025. All rights reserved.