Document toolboxDocument toolbox

CentOS to Ubuntu migration on GCP

Important

  • You must perform these steps after upgrading the Kyvos cluster to 2023.5.

  • Before you migrate CentOS to Ubuntu on GCP, you must ensure the following:

    • Kyvos and Kyvos Manager must not be installed on the root drive

    • Before performing this activity, ensure to capture the path from the Kyvos manager while it is running. Execute the following command to get this information.
      ps -ef | grep 8080

To migrate CentOS to Ubuntu on GCP, perform the following steps.

  1. Stop BI Server and Query Engine machine from Google console.

Note

Follow steps 3 to 8 for the BI Server and Query Engine.

  1. Once machines are stopped, click the machine. It will open a new screen. Click the Edit button. 

  2. Now, scroll down and remove the boot disk by clicking the Detach Boot Disk option. Once the boot disk is detached from the machine. You will get the option to configure the boot disk.

  3. Upon clicking the Configure Boot Disk option, it will open a new side screen. Here, select Custom Images and choose the latest provided Ubuntu image (kyvos-ubuntu20-image-2023-11-07) and provide any name of your choice; use the device name as boot, and other details will be auto-filled.

  4. Now, scroll down to the Startup script section and update the startup script content with new startup script (bi_qe.sh). Add a key name Rerun and value as true. If the Rerun key is already present, then just update the value to true.

  5. Save and start machines.

  6. Verify BI Server and Query Engines must be up and running on Kyvos Manager Dashboard.

  7. Now, stop the Kyvos Manager machine from Google Console.

  8. Detach old boot drive and attach new drive with same size (using similar steps performed on BI and Query Engine machine, from step 4 through 6. 

  9. Update metadata value for Rerun from false to true.

  10. Remove old startup script and add content from new script (km.sh).

  11. Save and start Kyvos Manager machine. Start the Kyvos Manager from the path you captured at the start of this activity, verify all machines and service should be up and running.

  12. At last, replace the pgconnect.sh script present inside postgres/bin with pgconnect.sh of latest alpha setup (present inside postgres/bin)

Note

To check if OS is successfully migrated from centos to ubuntu20, execute lsb_release -a command on the Kyvos component.
Following is the sample output
Distributor ID: Ubuntu
Description: Ubuntu 20.04.6 LTS
Release: 20.04
Codename: focal

 

Copyright Kyvos, Inc. All rights reserved.