Document toolboxDocument toolbox

CentOS to RHEL migration on GCP

Important
You must perform these steps after upgrading the Kyvos cluster to 2024.1 if the Operating System is CentOS.

To migrate CentOS to RHEL on GCP, perform the following steps:

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

Note

Follow steps 2 to 7 for the BI Server and Query Engine.

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

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

  3. Upon clicking on the configure Boot disk option, it will open a new side screen. Select the Operating system as RHEL, give a name to the boot disk (any name would work), and select other options as shown in the following image.

  4. Click Select, now your boot setting looks like the screenshot below

  5. Now, scroll down to the startup script section and update the startup script content with the new startup script(bi_qe.sh). Click here to download bi_qe.sh startup script.

  6. Save and start machines. Verify on Kyvos Manager that BI Server and Query Engines must be up and running.

  7. Now, stop the km machine from Google Console.

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

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

  10. Remove old startup script and add content from new script(km.sh). Click here to download km.sh startup script.

  11. Check the Kyvos manager portal. Everything should be up and running.

 To check if OS is successfully migrated from centos to redhat8, execute cat /etc/redhat-release command on all Kyvos components nodes. Output should be Red Hat Enterprise Linux release 8.8 (Ootpa)

 

Copyright Kyvos, Inc. All rights reserved.