Update the operating system

Update your operating system to access the full feature set from the latest release and to improve support.

You can update your operating system by choosing one of the following options:

  • Update to the latest release within your current EUS stream: Provides the latest packages and bug fixes.
  • Switch to a new EUS stream: Provides additional hardware enablement, full feature compatibility, and extends support for new RHEL minor releases.

Access latest features within your current EUS stream
Copy link

Update Compute nodes to use the full feature set from the latest release within your current EUS stream and to align with the maximum support lifecycle. Update RHEL 9.2 or 9.4 to RHEL 9.6 any time after updating control plane and data plane services.

Before you begin
Copy link

  • All of the control plane and data plane services have finished updating.

Procedure
Copy link

  1. Create a file named openstack-edpm-update-system.yaml on your workstation and include the following content: 
    apiVersion: dataplane.openstack.org/v1beta1
kind: OpenStackDataPlaneDeployment
metadata:
  name: edpm-deployment-ipam-update-dataplane-system
spec:
  nodeSets:
    - <nodeSet_name>
    - <nodeSet_name>
    - ...
    - <nodeSet_name>
  servicesOverride:
    - update-system
  2. To update the operating system on the data plane, create an OpenStackDataPlaneDeployment custom resource (CR) with the openstack-edpm-update-system.yaml file: 
    $ oc create -f openstack-edpm-update-system.yaml
  3. Wait for the system update to finish: 
    $ oc wait openstackdataplanedeployment edpm-deployment-ipam-update-dataplane-system --for=condition=Ready --timeout=20m

    The command returns the following output when all the control plane services are updated:

    openstackdataplanedeployment.dataplane.openstack.org/edpm-deployment-ipam-update-dataplane-system condition met
  4. Verify that the system update succeeded: 
    $ oc get openstackdataplanedeployment

NAME                                        STATUS     MESSAGE
edpm-deployment-ipam                            True   Setup Complete
edpm-deployment-ipam-ovn-update                 True   Setup Complete
edpm-deployment-ipam-update-dataplane-services  True   Setup Complete
edpm-deployment-ipam-update-dataplane-system    True   Setup Complete

Update the RHEL EUS stream on data plane nodes
Copy link

Update your Red Hat OpenStack Services on OpenShift (RHOSO) data plane nodes to the latest Red Hat Enterprise Linux (RHEL) Extended Update Support (EUS) stream for additional hardware enablement, full feature compatibility, and improved support.

Before you begin
Copy link

About this task
Copy link

  • You can update the RHEL EUS stream in a separate maintenance window after you adopt the RHOSO data plane.
  • You can update the RHEL EUS stream on different node sets in different maintenance windows. For example, you can update one node set from RHEL 9.2 to RHEL 9.4 or 9.6 in one maintenance window, and then update a different node set in another maintenance window later.

For more information about RHEL EUS streams, see Red Hat Enterprise Linux Life Cycle.

Procedure
Copy link

  1. Optional: Live migrate the instances from the Compute nodes that you plan to update. For more information about your options for live migration, see the following documentation:
  2. Log in to a Compute node and confirm the current release. For example: 
    $ sudo subscription-manager release: 9.2
     
    # subscription-manager release
Release: 9.2
  3. Set the target RHEL version in the OpenStackDataPlaneNodeSet custom resource (CR). The following example uses RHEL version 9.4. For more information about creating an OpenStackDataPlaneNodeSet CR, see Create and deploy the data plane. 
    $ oc patch openstackdataplanenodeset <nodeset> --type=json --patch='[{"op":"add","path":"/spec/nodeTemplate/ansible/ansibleVars/rhc_release","value":9.4}]'

    where:

    <nodeset>
    Specifies the name of the node set to update, for example, openstack-cell1.
  4. Create a file named edpm-update.yaml on your workstation and include the following content: 
    apiVersion: dataplane.openstack.org/v1beta1
kind: OpenStackDataPlaneDeployment
metadata:
  name: edpm-update
  namespace: openstack
spec:
  backoffLimit: 1
  nodeSets:
    - <nodeset>
  ansibleExtraVars:
    edpm_reboot_strategy: force
  servicesOverride:
    - redhat
    - update-system
    - reboot-os
  5. Create the edpm-update CR: 
    $ oc apply -f update-edpm.yaml
  6. Verify that the edpm-update CR is created: 
    $ oc get openstackdataplanedeployment edpm-update
NAME                     NODESETS              STATUS   MESSAGE
edpm-update              ["openstack-cell1"]   False    Deployment in progress

    After the deployment is complete, all of the nodes that are included in the OpenStackDataPlaneNodeSet CR are updated to the RHEL version that you specified in step 2, and the nodes are rebooted.

    Note

    If the deployment failed, view the Ansible output to check the deployment status:

    $ oc get osdpd edpm-update -o yaml
$ oc logs <job>

    where:

    <job>
    Specifies the name of the job for which to get the Ansible output.

    For more information about troubleshooting, see Troubleshoot data plane creation and deployment.
  7. Check the RHEL version on the Compute node. For example: 
    $ sudo subscription-manager release: 9.4
     
    # subscription-manager release
Release: 9.4