Chapter 5. Rebooting Compute nodes

Procedure

1. Confirm which updated nodes need a reboot:

   $ oc logs jobs/reboot-os-<deployment_name>-<nodeSet_name>

   • Replace <deployment_name> with the name of the deployment that includes your Compute nodes.

   • Replace <nodeSet_name> with the names of the node sets that you need to check.

     The command shows the following output if a reboot is required: Reboot is required but was not started. Edpm_reboot_strategy is set to never or this is already deployed machine. Reboot has to be planned. To start reboot set edpm_reboot_strategy to force.

2. Open a remote shell connection to the OpenStackClient pod:

   $ oc rsh -n openstack openstackclient

3. Retrieve a list of your Compute nodes to identify the host name of the nodes that require a reboot:

   $ openstack compute service list

4. Disable the Compute service on the Compute node that you need to reboot:

   $ openstack compute service set <hostname> nova-compute --disable

   • Replace <hostname> with the host name of the Compute node on which you are disabling the service.
5. If Red Hat Ceph Storage is also hosted on the Compute node, perform steps 1 to 14 in the procedure Powering down and rebooting the cluster using Ceph Orchestrator in the Red Hat Ceph Storage Administration Guide. Do not reboot the cluster as instructured in the Administration Guide. The cluster is rebooted later in this procedure.

6. List all instances on the Compute node:

   $ openstack server list --host <hostname> --all-projects

7. Optional: If you decide to migrate the instances to another Compute node, for example, if you plan to reboot nodes that include running workloads, run the following command:

   $ openstack server migrate --live-migration --host <target_host>  --wait <instance_id>

   • Replace <instance_id> with your instance ID.

   • Replace <target_host> with the host that you are migrating the instance to.

     1. Wait until migration completes.

     2. Confirm that the migration was successful:

        $ openstack server list --host <hostname> --all-projects

     3. Continue to migrate instances until none remain on the Compute node.

8. Exit the OpenStackClient pod:

   $ exit

9. Create an OpenStackDataPlaneDeployment CR to reboot the nodes:

   apiVersion: dataplane.openstack.org/v1beta1
   kind: OpenStackDataPlaneDeployment
   metadata:
     name: openstack-edpm-ipam-reboot
     namespace: openstack
   spec:
     nodeSets:
     - <nodeSet_name>
     servicesOverride:
     - reboot-os
     ansibleExtraVars:
       edpm_reboot_strategy: force
     ansibleLimit: <node_hostname>,...,<node_hostname>

   • spec.nodeSets lists the OpenStackDataPlaneNodeSet CRs that contain the nodes that you are rebooting.
   • spec.servicesOverride specifies the reboot-os as the only service to execute.
   • spec.ansibleExtraVars reboots all the nodes in the node set at the same time.
   • Optional: spec.ansibleLimit lists the individual nodes in the node set to reboot. If not set, all the nodes in the node set are rebooted at the same time.
   • <node_hostname> specifies the hostname of the node to reboot.

10. Verify that the openstack-edpm-ipam-reboot deployment completed:

    $ oc get openstackdataplanedeployment
    NAME                                    STATUS   MESSAGE
    openstack-edpm-deployment-ipam-reboot   True     Setup complete

    If the deployment fails, see Troubleshooting data plane creation and deployment in the Deploying Red Hat OpenStack Services on OpenShift guide.

11. Re-enable the Compute node:

    $ oc rsh openstackclient -n openstack
    $ openstack compute service set <hostname>  nova-compute --enable

12. If Red Hat Ceph Storage is also hosted on the Compute node, perform steps 1 to 7 in the procedure "Powering down and rebooting the cluster using Ceph Orchestrator" in the Red Hat Ceph Storage Administration Guide:

    • Red Hat Ceph Storage 7 Administration Guide
    • Red Hat Ceph Storage 8 Administration Guide
    • Red Hat Ceph Storage 9 Administration Guide

13. Check that the Compute node is enabled:

    $ openstack compute service list