IBM Cloud Docs
Migrating to a new Red Hat Enterprise Linux version

Migrating to a new Red Hat Enterprise Linux version

Virtual Private Cloud

RHEL 9 is available for Red Hat OpenShift Classic and VPC clusters that run version 4.16 or higher. Follow these steps to migrate your worker nodes from RHEL 8 to RHEL 9.

For more information on RHEL 9, see the Red Hat OpenShift release notes.

To find your worker node operating system, run the ibmcloud oc worker-pools -c CLUSTER command.

For RHEL 9, the /tmp directory is a separate partition that has the nosuid, noexec, and nodev options set. If your apps install to and run scripts or binaries under the /tmp directory, they might fail. Update your apps to use the /var/tmp directory instead of the /tmp directory to run temporary scripts or binaries.

  1. Review your worker pool operating systems to determine which pools you need to migrate.

    ibmcloud ks worker-pools -c CLUSTER
    
  2. Specify the REDHAT_9_64 version for the worker pool.

    ibmcloud oc worker-pool operating-system set --cluster CLUSTER --worker-pool POOL --operating-system REDHAT_9_64
    
  3. Update each worker node in the worker pool by running the ibmcloud oc worker update for Classic clusters or ibmcloud oc worker replace for VPC clusters.

    Make sure you have enough worker nodes to support your workload while you update or replace the relevant worker nodes. For more information, see Updating VPC worker nodes or Updating classic worker nodes.

    Example command to update Classic worker nodes.

    ibmcloud oc worker update --cluster CLUSTER --worker WORKER1_ID [--worker WORKER2_ID] 
    

    Example command to replace VPC worker nodes.

    ibmcloud oc worker replace --cluster CLUSTER --worker WORKER_ID
    
  4. Get the details for your worker pool and workers. In the output, verify that your worker nodes run the REDHAT_9_64 operating system.

    Get the details for a worker pool.

    ibmcloud oc worker-pools -c CLUSTER
    

    Get the details for a worker node.

    ibmcloud oc worker get --cluster CLUSTER --worker WORKER_NODE_ID