Document toolboxDocument toolbox

Post upgrade steps

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 outlines the steps to be taken after completing the upgrade process.

Post-upgrade steps to manually configure Heap memory

Note

From Kyvos 2023.5 onwards, Heap, Off-heap, and other required memory on Query Engines are automatically configured if memory mode is set to Auto mode.  

For a manual memory mode, you must perform the following post-deployment steps. 

  • Open the Kyvos Java options page in Kyvos Manager and Navigate to the Query Engine section. 

  • If Configure Heap memory for Query Engine is set as Auto, no need is required. 

  • If Configure Heap memory for Query Engine is set as Manual, reduce Off-Heap memory by 10 GB. 
    For Example, Suppose the total machine memory is 128 GB, whereas 45 GB is assigned to Heap, and 66 GB is assigned to Off-Heap. In that case, you need to set Heap as 45 GB and Off-Heap as 56 GB so Kyvos can use the remaining 10 GB internally for the new data store-based architecture. 

Post-upgrade steps for Azure

Azure Functions

Note

Applicable ONLY when you have upgraded Azure Cloud-based cluster where functions were deployed for supporting scheduling feature.


In releases before 2021.3, Azure was deployed with three separate function apps, each having a single function (KyvosClusterStatusFunction, KyvosClusterStartFunction, and KyvosOlapFunction) in it. With the 2021.3 release, the three functions are merged into a single function app (KyvosFunction). Therefore, in case of an upgrade through the Kyvos Manager application, the functions cannot be upgraded, and require a manual update.

If the function were created in a previous release before Kyvos 2021.3

  1. On the Azure portal, create the Azure function using azure_functions.json template file available at kyvosmanager_war/kyvosmanager/cloud/azure/templates. You can also download the file from the Azure Installation folder.

  2. On the Kyvos Manager portal, navigate to the Properties page. In the kyvosclient.properties file, update the CLUSTER_STARTUP_URL and SERVER_STATUS_CHECK_URL properties with the URL provided in the Azure deployment function output.

  3. Logon to your Azure portal, and navigate to <Container> / user / <work directory> / setup / cloud_conf. Download the cluster.properties file, update the FUNCTION_NAME property to provide the created Azure function name, and the upload the updated file.

  4. Restart the BI Server.

Warning

DO NOT delete the existing function app, as you may need them in case of a rollback.

Rollback steps

In case you have to roll back from Kyvos version 2021.3 to any previous version, you need to perform the following steps to ensure the correct working of the Azure functions.

  1. On the Kyvos Manager portal, navigate to the Properties page. In the kyvosclient.properties file, update the CLUSTER_STARTUP_URL and SERVER_STATUS_CHECK_URL properties with URL available in old functions created before the upgrade.

  2. Logon to your Azure portal, and navigate to <Container> / user / <work directory> / setup / cloud_conf. Download the cluster.properties file, update the FUNCTION_NAME property to provide the previous function name that was created before the upgrade, and upload the updated file.

  3. Restart the BI Server.

Migrating Storage account TLS version from 1.0 to TLS 1.2

From Kyvos 2024.1 onwards, for fresh deployments on Azure, the minimum TLS version value must be 1.2. For existing environments, you need to perform the following post-deployment steps to migrate from TLS 1.0 and 1.1 to TLS 1.2.

  1. Go to your Azure Storage account.

  2. On the Home page, click Overview, and then click the Properties tab.

  3. In the Security section, click Minimum TLS version and update it to 1.2 and then click Save.

Copyright Kyvos, Inc. All rights reserved.