Nutanix offers a distributed data and control plane, so it’s fairly easy to start, stop and graceful shutdown a cluster. Even, in abnormal / dirty shutdowns, Nutanix cluster has powerful self-healing capabilities - as all data & meta-data is distributed across the cluster which significantly reduces the chances for data corruption or data-loss.
However, as a Nutanix Cluster hosts business critical data and applications, it is important to ensure all services stop in a graceful manner and all data + meta-data is consistent. This allows the cluster to be restarted in a healthy - usable state later.
There can be several reasons to gracefully shutdown a running Nutanix AHV & AOS Cluster. When shutting down a Nutanix Cluster, following order needs to be followed:
- User VMs Shutdown
- AOS Shutdown - Data services / Cluster components
- CVM Shutdown
- Hypervisor Shutdown
In this post, we will focus on the shutdown process for a Nutanix Cluster running with AHV (Acropolis Hypervisor).
Points to Check and Consider:
- Check for any running replications on your Nutanix Cluster > Data Protection
- Check for any running backups and ensure they finish successfully
- There are no running software or firmware upgrades in progress for AOS
- Run
ncc
(nutanix cluster check) utility and ensure there are no red flags / alerts - Do you use Nutanix Files? then Files (AFS) will need to be shutdown first.
Steps to Shutdown - AHV & AOS Cluster
Prior to the scheduled shutdown, SSH to a Controller VM and run:ncc health_checks run_all
. If there are any errors or failures, Check the relevant KBs and contact Nutanix Support if required.
- Shut down all the user VMs in the Nutanix cluster
- Stop all AFS cluster VMs if applicable
- Stop the Nutanix cluster.
- Shut down each node in the cluster.
- After completing maintenance or other tasks, power on the nodes and start the cluster.
Please visit the “Shutting Down an AHV Cluster for Maintenance or Relocation” KB to read more about how you can shutdown several user virtual machines with a single command.