The following is a high-level overview of the non-compute node (NCN) reboot workflow:
Run the NCN pre-reboot checks and procedures.
ncn-m001 is not booted to the LiveCD / PIT node.metal.no-wipe settings for all NCNs.Run the rolling NCN reboot procedure.
Loop through reboots on storage nodes, worker nodes, and master nodes, where each reboot consists of the following workflow:
Re-run all platform health checks.
The time duration for this procedure (if health checks are being executed in between each boot, as recommended) could take between two to four hours for a system with nine management nodes.
This same procedure can be used to reboot a single management node as outlined above. Be sure to carry out the NCN pre-reboot checks and procedures before and after rebooting the node. Execute the rolling NCN reboot procedure steps for the particular node type being rebooted.
kubectl command is installed.ncn-m001 or any worker nodes.
ncn-m001, then the latest CSM documentation must be installed on ncn-m001.Ensure that ncn-m001 is not booted to the LiveCD / PIT node.
This mode should only be in effect during the initial product install.
If the word pit is NOT in the hostname of ncn-m001, then it is not in the LiveCD mode.
If pit is in the hostname of ncn-m001, then the system is not in normal operational mode and rebooting ncn-m001 may have unexpected results.
This procedure assumes that the node is not running in the LiveCD mode that occurs during product install.
Run the platform health checks and analyze the results.
Refer to the “Platform Health Checks” section in Validate CSM Health for an overview of the health checks.
(ncn-mw#) Restart the goss-servers service on all NCNs to ensure the correct tests are run on each node. This is necessary due to a timing issue that is fixed in CSM 1.6.1.
ncn_nodes=$(grep -oP "(ncn-s\w+|ncn-m\w+|ncn-w\w+)" /etc/hosts | sort -u | tr -t '\n' ',')
ncn_nodes=${ncn_nodes%,}
pdsh -S -b -w $ncn_nodes 'systemctl restart goss-servers'
(ncn-mw#) Run the platform health script.
Run this on any master or worker node. The output of the following script will need to be referenced in some of the remaining sub-steps.
/opt/cray/platform-utils/ncnHealthChecks.sh
NOTEIf thencnHealthChecksscript output indicates anykube-multus-ds-pods are in aTerminatingstate, that can indicate that a previous restart of these pods did not complete. In this case, it is safe to force delete these pods in order to let them properly restart; this is done by runningkubectl delete po -n kube-system kube-multus-ds.. --force. After executing this command, re-running thencnHealthChecksscript should indicate that a new pod is in theRunningstate.
Remediate any reported failures before proceeding.
(ncn-m#) Validate Postgres health.
Run this on any master NCN. It will run a set of checks on every Postgres cluster.
/opt/cray/tests/install/ncn/automated/ncn-postgres-tests
Example output:
NCN Postgres Tests
---------------
..........
Total Duration: 27.170s
Count: 10, Failed: 0, Skipped: 0
..........
Total Duration: 27.265s
Count: 10, Failed: 0, Skipped: 0
..........
…
Total Duration: 27.264s
Count: 10, Failed: 0, Skipped: 0
Remediate any reported failures before proceeding.
(ncn-mw#) Check the status of the slurmctld and slurmdbd pods to determine if they are starting.
kubectl describe pod -n user -lapp=slurmctld
kubectl describe pod -n user -lapp=slurmdbd
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Warning FailedCreatePodSandBox 29m kubelet, ncn-w001 Failed to create pod
sandbox: rpc error: code = Unknown desc = failed to setup network for sandbox
"314ca4285d0706ec3d76a9e953e412d4b0712da4d0cb8138162b53d807d07491": Multus: Err in tearing down failed
plugins: Multus: error in invoke Delegate add - "macvlan": failed to allocate for range 0: no IP addresses
available in range set: 10.252.2.4-10.252.2.4
Warning FailedCreatePodSandBox 29m kubelet, ncn-w001 Failed to create pod
sandbox: rpc error: code = Unknown desc = failed to setup network for sandbox
...
If the preceding error is displayed, then remove all files in the following directories on all worker nodes:
/var/lib/cni/networks/macvlan-slurmctld-nmn-conf/var/lib/cni/networks/macvlan-slurmdbd-nmn-conf(ncn-m#) Check that the BGP peering sessions are established.
Run this check from a master NCN. This must be run after all worker node have been rebooted, in order to check the BGP peering sessions on the spine switches.
Set SW_ADMIN_PASSWORD to the admin user password for the management switches in the system.
read -sis used to prevent the password from being written to the screen or the shell history.
read -r -s -p "Management switch admin user password: " SW_ADMIN_PASSWORD
Run the validation.
export SW_ADMIN_PASSWORD
GOSS_BASE=/opt/cray/tests/install/ncn goss \
-g /opt/cray/tests/install/ncn/tests/goss-switch-bgp-neighbor-aruba-or-mellanox.yaml \
--vars=/opt/cray/tests/install/ncn/vars/variables-ncn.yaml validate
(ncn#) Ensure that no nodes are in a failed state in CFS.
Nodes that are in a failed state prior to the reboot will not be automatically configured once they have been rebooted.
The following script will find all CFS components in the failed state and for each such
component it will reset its CFS error count to 0 and disable it in CFS. It is disabled in
order to prevent CFS from immediately triggering a configuration. The components will be
automatically re-enabled when they boot.
This can be run on any NCN where the Cray CLI is configured. See Configure the Cray CLI.
cray cfs v3 components list --status failed --format json | jq .[].id -r | while read -r xname ; do
echo "${xname}"
cray cfs v3 components update "${xname}" --enabled False --error-count 0
done
Alternatively, this can be done manually. To get a list of nodes in the failed state:
cray cfs v3 components list --status failed --format json | jq .[].id
To reset the error count and disable a node:
NOTE Be sure to replace the <xname> in the following command with the component name (xname) of the NCN component to be reset and disabled.
cray cfs v3 components update <xname> --enabled False --error-count 0
Before rebooting NCNs:
metal.no-wipe setting for each NCN. Do not proceed if any of the NCN metal.no-wipe settings are zero.Reboot each of the storage nodes (one at a time), going from the highest to lowest number.
Establish a console session to each storage node.
Use the Establish a Serial Connection to NCNs procedure referenced in step 4.
If booting from disk is desired then set the boot order.
(ncn-s#) Reboot the selected node.
shutdown -r now
IMPORTANT: If the node does not shut down after 5 minutes, then proceed with the power reset below.
(ncn#) Power off the node.
read -sis used to prevent the password from being written to the screen or the shell history.In the example commands below, be sure to replace
<node>with the name of the node being rebooted. For example,ncn-s002.
USERNAME=root
read -r -s -p "NCN BMC ${USERNAME} password: " IPMI_PASSWORD
export IPMI_PASSWORD
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power off
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power status
Ensure that the power is reporting as off. It may take 5-10 seconds for this to update. Wait about 30 seconds after receiving the correct power status before issuing the next command.
(ncn#) Power on the node.
In the example commands below, be sure to replace
<node>with the name of the node being rebooted. For example,ncn-s002.
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power on
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power status
Ensure that the power is reporting as on. It may take 5-10 seconds for this to update.
Watch on the console until the node has successfully booted and the login prompt is reached.
(ncn-s#) If desired, verify that the method of boot is as expected.
If the /proc/cmdline file begins with BOOT_IMAGE, then this NCN booted from disk.
egrep -o '^(BOOT_IMAGE|kernel)' /proc/cmdline
Example output for a disk boot is:
BOOT_IMAGE=(mduuid/a3899572a56f5fd88a0dec0e89fc12b4)/boot/grub2/../kernel
(ncn#) Retrieve the component name (xname) for the node that was rebooted.
This xname is available on the node that was rebooted in the /etc/cray/xname file.
ssh NODE cat /etc/cray/xname
(ncn#) Check the Configuration Framework Service (CFS) configuration_status for the rebooted node’s desired_config.
The following command will indicate if a CFS job is currently in progress for this node.
Replace the XNAME value in the following command with the component name (xname) of the node that was rebooted.
This can be run on any NCN where the Cray CLI is configured. See Configure the Cray CLI.
cray cfs v3 components describe XNAME --format json | jq .configuration_status
Example output:
"configured"
configuration_status is pending, then wait for the job to finish before continuing.configuration_status is failed, then this means the failed CFS job configuration_status should be addressed now for this node.configuration_status is unconfigured and the NCN personalization procedure has not been done as part of an install yet, then this can be ignored.configuration_status is failed, then see
Troubleshoot Failed CFS Sessions
for how to analyze the pod logs from cray-cfs in order to determine why the configuration may not have completed.(ncn-mw#) Run the platform health checks from the Validate CSM Health procedure.
Troubleshooting: If the slurmctld and slurmdbd pods do not start after powering back up the node, then check for the following error:
kubectl describe pod -n user -lapp=slurmctld
Example output:
Warning FailedCreatePodSandBox 27m kubelet, ncn-w001 Failed to create pod sandbox: rpc error: code =
Unknown desc = failed to setup network for sandbox "82c575cc978db00643b1bf84a4773c064c08dcb93dbd9741ba2e581bc7c5d545":
Multus: Err in tearing down failed plugins: Multus: error in invoke Delegate add - "macvlan": failed to allocate for
range 0: no IP addresses available in range set: 10.252.2.4-10.252.2.4
kubectl describe pod -n user -lapp=slurmdbd
Example output:
Warning FailedCreatePodSandBox 29m kubelet, ncn-w001 Failed to create pod sandbox: rpc error: code
= Unknown desc = failed to setup network for sandbox "314ca4285d0706ec3d76a9e953e412d4b0712da4d0cb8138162b53d807d07491":
Multus: Err in tearing down failed plugins: Multus: error in invoke Delegate add - "macvlan": failed to allocate for
range 0: no IP addresses available in range set: 10.252.2.4-10.252.2.4
Remove the following files on every worker node to resolve the failure:
/var/lib/cni/networks/macvlan-slurmctld-nmn-conf/var/lib/cni/networks/macvlan-slurmdbd-nmn-confDisconnect from the console.
Repeat all of the sub-steps above for the remaining storage nodes, going from the highest to lowest number, until all storage nodes have successfully rebooted.
Important: Ensure that ceph -s shows that Ceph is healthy (HEALTH_OK) BEFORE MOVING ON to reboot the next storage node.
Once Ceph has recovered the downed
mon, it may take a several minutes for Ceph to resolve clock skew.
Reboot each of the worker nodes (one at a time), going from the highest to lowest number.
NOTE: A single worker is being rebooted at a time, so be sure to follow the steps on the correct worker node.
Establish a console session to the worker node being rebooted.
IMPORTANT: If the ConMan console pod is on the node being rebooted, then the session must be re-established after the cordon/drain step.
See Establish a Serial Connection to NCNs for more information.
(ncn-mw#) Failover any Postgres leader that is running on the worker node being rebooted.
This script must be run from a master or worker node with the latest CSM documentation installed. See Check for latest documentation.
/usr/share/doc/csm/upgrade/scripts/k8s/failover-leader.sh <node to be rebooted>
(ncn-mw#) Cordon and drain the node.
kubectl drain --ignore-daemonsets=true --delete-emptydir-data <node to be rebooted>
There may be pods that cannot be gracefully evicted because of Pod Disruption Budgets (PDB). This will result in messages like the following:
error when evicting pod "<pod>" (will retry after 5s): Cannot evict pod as it would violate the pod's disruption budget.
In this case, there are some options. First, if the service is scalable, then increase the scale to start up another pod on another node, and then the drain will be able to delete it. However, it will probably be necessary to force the deletion of the pod:
kubectl delete pod [-n <namespace>] --force --grace-period=0 <pod>
This will delete the offending pod, and Kubernetes should schedule a replacement on another node.
Then rerun the kubectl drain command, and it should report that the node is drained.
kubectl drain --ignore-daemonsets=true --delete-emptydir-data <node to be rebooted>
If booting from disk is desired, then set the boot order.
(ncn-mw#) Reboot the selected node.
pdsh -w <node to be rebooted> 'shutdown -r now'
IMPORTANT: If the node does not shut down after 5 minutes, then proceed with the power reset below.
(ncn#) Power off the node.
read -sis used to prevent the password from being written to the screen or the shell history.In the example commands below, be sure to replace
<node>with the name of the node being rebooted. For example,ncn-w002.
USERNAME=root
read -r -s -p "NCN BMC ${USERNAME} password: " IPMI_PASSWORD
export IPMI_PASSWORD
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power off
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power status
Ensure that the power is reporting as off. It may take 5-10 seconds for this to update. Wait about 30 seconds after receiving the correct power status before issuing the next command.
(ncn#) Power on the node.
In the example commands below, be sure to replace
<node>with the name of the node being rebooted. For example,ncn-w002.
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power on
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power status
Ensure that the power is reporting as on. It may take 5-10 seconds for this to update.
Watch on the console until the node has successfully booted and the login prompt is reached.
(ncn-w#) If desired, verify that the method of boot is as expected.
If the /proc/cmdline file begins with BOOT_IMAGE, then this NCN booted from disk.
egrep -o '^(BOOT_IMAGE|kernel)' /proc/cmdline
Example output for a disk boot is:
BOOT_IMAGE=(mduuid/a3899572a56f5fd88a0dec0e89fc12b4)/boot/grub2/../kernel
(ncn#) Retrieve the component name (xname) for the node that was rebooted.
This xname is available on the node that was rebooted in the /etc/cray/xname file.
ssh NODE cat /etc/cray/xname
(ncn#) Check the Configuration Framework Service (CFS) configuration_status for the rebooted node’s desired_config.
The following command will indicate if a CFS job is currently in progress for this node.
Replace the XNAME value in the following command with the component name (xname) of the node that was rebooted.
This can be run on any NCN where the Cray CLI is configured. See Configure the Cray CLI.
cray cfs v3 components describe XNAME --format json | jq .configuration_status
Example output:
"configured"
configuration_status is pending, then wait for the job to finish before continuing.configuration_status is failed, then this means the failed CFS job configuration_status should be addressed now for this node.configuration_status is unconfigured and the NCN personalization procedure has not been done as part of an install yet, then this can be ignored.configuration_status is failed, then see
Troubleshoot Failed CFS Sessions
for how to analyze the pod logs from cray-cfs in order to determine why the configuration may not have completed.(ncn-mw#) Remove the node cordon.
kubectl uncordon <node that just rebooted>
(ncn-mw#) Verify that pods are running on the rebooted node.
Within a minute or two, the following command should begin to show pods in a Running state (replace NCN in the command below with the name of the rebooted worker node):
kubectl get pods -o wide -A | grep <node that was rebooted>
Run the platform health checks from the Validate CSM Health procedure.
In particular, verify that no etcd errors are reported.
If terminating pods are reported when checking the status of the Kubernetes pods, then wait for all pods to recover before proceeding.
If RTS was running on the worker node and it has not started Running, then see RTS fails to start after worker node is restarted
Disconnect from the console.
Repeat all of the sub-steps above for the remaining worker nodes, going from the highest to lowest number, until all worker nodes have successfully rebooted.
Ensure that BGP sessions are reset so that all BGP peering sessions with the spine switches are in an ESTABLISHED state.
Reboot each of the master nodes (one at a time), going from the highest to lowest number, excluding ncn-m001. There are special instructions for ncn-m001 later, because its console connection is not managed by ConMan.
Establish a console session to the master node being rebooted.
See step Establish a Serial Connection to NCNs for more information.
If booting from disk is desired, then set the boot order.
(ncn-m#) Reboot the selected node.
shutdown -r now
IMPORTANT: If the node does not shut down after 5 minutes, then proceed with the power reset below.
(ncn#) Power off the node.
read -sis used to prevent the password from being written to the screen or the shell history.In the example commands below, be sure to replace
<node>with the name of the node being rebooted. For example,ncn-m002.
USERNAME=root
read -r -s -p "NCN BMC ${USERNAME} password: " IPMI_PASSWORD
export IPMI_PASSWORD
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power off
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power status
Ensure that the power is reporting as off. It may take 5-10 seconds for this to update. Wait about 30 seconds after receiving the correct power status before issuing the next command.
(ncn#) Power on the node.
In the example commands below, be sure to replace
<node>with the name of the node being rebooted. For example,ncn-m002.
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power on
ipmitool -U "${USERNAME}" -E -H <node>-mgmt -I lanplus power status
Ensure that the power is reporting as on. It may take 5-10 seconds for this to update.
Watch on the console until the node has successfully booted and the login prompt is reached.
(ncn-m#) If desired, verify that the method of boot is as expected.
If the /proc/cmdline file begins with BOOT_IMAGE, then this NCN booted from disk.
egrep -o '^(BOOT_IMAGE|kernel)' /proc/cmdline
Example output for a disk boot is:
BOOT_IMAGE=(mduuid/a3899572a56f5fd88a0dec0e89fc12b4)/boot/grub2/../kernel
(ncn#) Retrieve the component name (xname) for the node that was rebooted.
This xname is available on the node that was rebooted in the /etc/cray/xname file.
ssh NODE cat /etc/cray/xname
(ncn#) Check the Configuration Framework Service (CFS) configuration_status for the rebooted node’s desired_config.
The following command will indicate if a CFS job is currently in progress for this node.
Replace the XNAME value in the following command with the component name (xname) of the node that was rebooted.
This can be run on any NCN where the Cray CLI is configured. See Configure the Cray CLI.
cray cfs v3 components describe XNAME --format json | jq .configuration_status
Example output:
"configured"
configuration_status is pending, then wait for the job to finish before continuing.configuration_status is failed, then this means the failed CFS job configuration_status should be addressed now for this node.configuration_status is unconfigured and the NCN personalization procedure has not been done as part of an install yet, then this can be ignored.configuration_status is failed, then see
Troubleshoot Failed CFS Sessions
for how to analyze the pod logs from cray-cfs in order to determine why the configuration may not have completed.Run the platform health checks in Validate CSM Health.
Disconnect from the console.
Repeat all of the sub-steps above for the remaining master nodes (excluding ncn-m001), going from the highest to lowest number, until all master nodes have successfully rebooted.
Reboot ncn-m001.
Determine the site/external IP address for one of the other NCNs in the system, in order to establish an SSH session with that NCN.
Establish a console session to ncn-m001 from a system external to the cluster.
If booting from disk is desired, then set the boot order.
(external#) Power cycle ncn-m001.
Ensure that the expected results are returned from the power status check before rebooting.
read -sis used to prevent the password from being written to the screen or the shell history.In the example commands below, be sure to replace
<ncn-m001-bmc>with the external IP or hostname of the BMC ofncn-m001.
USERNAME=root
read -r -s -p "ncn-m001 BMC ${USERNAME} password: " IPMI_PASSWORD
export IPMI_PASSWORD
ipmitool -U "${USERNAME}" -E -H <ncn-m001-bmc> -I lanplus power status
Power off ncn-m001.
In the example commands below, be sure to replace
<ncn-m001-bmc>with the external IP or hostname of the BMC ofncn-m001.
ipmitool -U "${USERNAME}" -E -H <ncn-m001-bmc> -I lanplus power off
ipmitool -U "${USERNAME}" -E -H <ncn-m001-bmc> -I lanplus power status
Ensure that power is reporting as off. It may take 5-10 seconds for this to update. Wait about 30 seconds after receiving the correct power status before issuing the next command.
Power on the ncn-m001.
In the example commands below, be sure to replace
<ncn-m001-bmc>with the external IP or hostname of the BMC ofncn-m001.
ipmitool -U "${USERNAME}" -E -H <ncn-m001-bmc> -I lanplus power on
ipmitool -U "${USERNAME}" -E -H <ncn-m001-bmc> -I lanplus power status
Ensure that the power is reporting as on. It may take 5-10 seconds for this to update.
Watch on the console until ncn-m001 has successfully booted and the login prompt is reached.
(ncn-m001#) If desired, verify that the method of boot is as expected.
If the /proc/cmdline file begins with BOOT_IMAGE, then this NCN booted from disk.
egrep -o '^(BOOT_IMAGE|kernel)' /proc/cmdline
Example output for a disk boot is:
BOOT_IMAGE=(mduuid/a3899572a56f5fd88a0dec0e89fc12b4)/boot/grub2/../kernel
(ncn#) Retrieve the component name (xname) for ncn-m001.
This xname is available on ncn-m001 in the /etc/cray/xname file.
ssh ncn-m001 cat /etc/cray/xname
(ncn#) Check the Configuration Framework Service (CFS) configuration_status for the desired_config after rebooting ncn-m001.
The following command will indicate if a CFS job is currently in progress for ncn-m001.
Replace the XNAME value in the following command with the component name (xname) of ncn-m001.
This can be run on any NCN where the Cray CLI is configured. See Configure the Cray CLI.
cray cfs v3 components describe XNAME --format json | jq .configuration_status
Example output:
"configured"
configuration_status is pending, then wait for the job to finish before continuing.configuration_status is failed, then this means the failed CFS job configuration_status should be addressed now for this node.configuration_status is unconfigured and the NCN personalization procedure has not been done as part of an install yet, then this can be ignored.configuration_status is failed, then see
Troubleshoot Failed CFS Sessions
for how to analyze the pod logs from cray-cfs in order to determine why the configuration may not have completed.Run the platform health checks in Validate CSM Health.
Disconnect from the console.
(ncn-m001#) Remove any dynamically assigned interface IP addresses that did not get released automatically.
This script must be run from ncn-m001, which must have the latest CSM documentation installed.
See Check for latest documentation.
/usr/share/doc/csm/scripts/CASMINST-2015.sh
Validate CSM health.
At a minimum, run the platform health checks.
See Validate CSM Health for the platform health checks.