Document toolboxDocument toolbox

Migrating Kyvos Manager and Kyvos Repository from Single to Flexible server

Owned by Sarabjeet Kaur
Last updated: Dec 22, 2023
3 min read

The process of migrating the repository from an Azure single server to an Azure flexible server involves three steps.

  1. Creation of Flexible Server instance

  2. Data migration

  3. Configuration

Creation of a Flexible Server instance

For Kyvos Manager

  1. Download the FlexibleServerKyvosManagerRepository.json templates from here to create a Flexible PostgreSQL Server.

  2. Deploy the template and while providing parameters, ensure that you keep the repository’s password and username the same as currently in use on the single server.

For Kyvos

  1. Download the FlexibleServerKyvosRepository.json templates from here to create a Flexible PostgreSQL Server.

  2. Deploy the template and while providing parameters, ensure that you keep the repository’s password and username the same as currently in use on the single server.

Important

You must attach the Contributor role to Managed Identity on the Kyvos Flexible Server for starting or stopping Flexible Server through cluster scheduling.

Migrating data from a Single server to a Flexible Server

The process of migrating from a single server to a flexible involves two steps.

  1. Granting permission

  2. Migrating data

Granting permission

Important

The Single server instance from which data is migrated to Flexible Server, either this Single server must be kept running to allow rollback if required later.
It is suggested to take dump of Single server and preserve that dump to some secure location before terminating that Single server instance. This dump will be required to create a new single server with this dump imported in it when rollback of Kyvos is required to that last version of Kyvos which was supporting single server.

To migrate Single Server Repository to Flexible Server, perform the following steps.

  • Grant permission for data access from single server for migrating it to flexible server. To do this, open the single server for Kyvos and Kyvos Manager. Go to Connection Security and switch Allow access to Azure services to Yes.

Migrating Repository data from Single Server to Flexible Server

Important

  • Before initiating the migration process, ensure all applications connecting to the production server are stopped. Refer to Microsoft documentation for further details.

  • When upgrade operation is started and reaches to a stage where services of BI Server is stopped then start migration of Single server data to the Flexible server.
    Perform this step in an overlapping manner with the Kyvos upgrade to save the time and thus minimize the downtime window as in this particular upgrade additional activities (like data migration to Flexible server from single server as well as switching the system from single server to flexible server) are also required which if not done in an overlapping manner then it can increase downtime window.

  1. Open the newly created Flexible Postgres Server for Kyvos.

  2. Click Migrate.

  3. Click Migrate from Single Server.

  4. Provide the name of Migration and click Next.

  5. In the Source field, choose the Server name of the existing Single server Postgres of Kyvos.

  6. Provide the password of the existing Single server Postgres of Kyvos. Choose all the databases to migrate and then click Next.

  7. In Target section, provide the password of the flexible server (which should be same as single server) and then click review and create.

  8. The migration could take some minutes to several hours depending on the size of data.

Configuring Kyvos Manager repository

Once the migration is completed, follow the below steps to configure the new flexible server with Kyvos Manager.

To configure the new flexible server with Kyvos Manager, perform the following steps.

  1. Ssh into Kyvos Manager node.

  2. Stop the Kyvos Manager service by using the ./stop-km.sh command.

  3. Go to /data/kyvos/installs/kyvosmanager_war/kyvosmanagerdata/server/db and open jdbc.properties.

  4. Replace the server name in jdbc url with the server name of the Flexible server.

  5. Remove the server name in jdbc.username and add the username.
    For example, if existing username is ‘jdbc.username=kmdbuser@kyvosManager-postgresServer-6487’ then CHANGE it to ‘jdbc.username=kmdbuser’.

  6. Start Kyvos Manager using the ./start-km.sh command.

Configuring Kyvos repository

  • Login into Kyvos Manager, navigate to Utilities then refer to the Manage Kyvos Repository section.

  • After completing the upgrade process and configuring Flexible server, you must start Kyvos services.

 

 

Copyright Kyvos, Inc. All rights reserved.