BZ1788218: RHEL workers update proc for y-stream

Author: Bob

modules/rhel-compute-updating.adoc

@@ -2,26 +2,30 @@
 //
 // * updating/updating-cluster-rhel-compute.adoc
 
-[id="rhel-compute-updating_{context}"]
-= Updating RHEL compute machines in your cluster
+[id="rhel-compute-updating-minor_{context}"]
+= Updating {op-system-base} compute machines in your cluster
 
-After you update your cluster, you must update the Red Hat Enterprise Linux (RHEL)
-compute machines in your cluster.
+After you update your cluster, you must update the {op-system-base-full} compute machines in your cluster.
+
+[IMPORTANT]
+====
+Because only {op-system-base-full} version 7.9 or later is supported for worker (compute) machines, you must not upgrade the {op-system-base} worker machines to version 8.
+====
+
+You can also update your compute machines to another minor version of {product-title} if you are using {op-system-base} as the operating system. You do not need to exclude any RPM packages from {op-system-base} when performing a minor version update.
 
 .Prerequisites
 
 * You updated your cluster.
 +
 [IMPORTANT]
 ====
-Because the RHEL machines require assets that are generated by the cluster to
-complete the update process, you must update the cluster before you update
-the RHEL compute machines in it.
+Because the {op-system-base} machines require assets that are generated by the cluster to complete the update process, you must update the cluster before you update the {op-system-base} worker machines in it.
 ====
 
-* You have access to the machine that you used to add the RHEL compute machines
-cluster. You must have access to the `hosts` Ansible inventory file that defines
-your RHEL machines and the `upgrade` playbook.
+* You have access to the local machine that you used to add the {op-system-base} compute machines to your cluster. You must have access to the `hosts` Ansible inventory file that defines your {op-system-base} machines and the `upgrade` playbook.
+
+* For updates to a minor version, the RPM repository is using the same version of {product-title} that is running on your cluster.
 
 .Procedure
 
@@ -54,7 +58,7 @@ You must not enable firewalld later. If you do, you cannot access {product-title
 # yum update openshift-ansible openshift-clients
 ----
 
-.. On each RHEL compute node, update the required repositories:
+.. On each {op-system-base} compute node, update the required repositories:
 +
 [source,terminal]
 ----
@@ -64,8 +68,8 @@ You must not enable firewalld later. If you do, you cannot access {product-title
                              --enable=rhel-7-server-optional-rpms
 ----
 
-. Update a RHEL worker machine:
-.. Review the current node status to determine which RHEL worker to update:
+. Update a {op-system-base} worker machine:
+.. Review the current node status to determine which {op-system-base} worker to update:
 +
 [source,terminal]
 ----
@@ -87,8 +91,7 @@ mycluster-rhel7-3           Ready                         worker   98m    v1.22.
 +
 Note which machine has the `NotReady,SchedulingDisabled` status.
 
-.. Review your Ansible inventory file at `/<path>/inventory/hosts`
-and update its contents so that only the machine with the `NotReady,SchedulingDisabled` status is listed in the `[workers]` section, as shown in the following example:
+.. Review your Ansible inventory file at `/<path>/inventory/hosts` and update its contents so that only the machine with the `NotReady,SchedulingDisabled` status is listed in the `[workers]` section, as shown in the following example:
 +
 ----
 [all:vars]
@@ -114,10 +117,14 @@ $ cd /usr/share/ansible/openshift-ansible
 ----
 $ ansible-playbook -i /<path>/inventory/hosts playbooks/upgrade.yml <1>
 ----
-<1> For `<path>`, specify the path to the Ansible inventory file
-that you created.
-
-. Follow the process in the previous step to update each RHEL worker machine in your cluster.
+<1> For `<path>`, specify the path to the Ansible inventory file that you created.
++
+[NOTE]
+====
+The `upgrade` playbook only upgrades the {product-title} packages. It does not update the operating system packages.
+====
++
+. Follow the process in the previous step to update each {op-system-base} worker machine in your cluster.
 
 . After you update all of the workers, confirm that all of your cluster nodes have updated to the new version:
 +
@@ -138,3 +145,14 @@ mycluster-rhel7-1           Ready                         worker   98m    v1.22.
 mycluster-rhel7-2           Ready                         worker   98m    v1.22.0
 mycluster-rhel7-3           Ready                         worker   98m    v1.22.0
 ----
+. Optional: Update the operating system packages that were not updated by the `upgrade` playbook. To update packages that are not on {product-version}, use the following command:
++
+[source,terminal]
+----
+# yum update
+----
++
+[NOTE]
+====
+You do not need to exclude RPM packages if you are using the same RPM repository that you used when you installed {product-version}.
+====