Aller au contenu
6 minutes

Arrêter et redémarrer proprement un cluster Nutanix AHV

Coupure électrique, déménagement : l’ordre d’arrêt d’un cluster AHV, de Files et des VM aux hôtes en passant par cluster stop et les CVM, puis le redémarrage. Étapes sourcées, divergences signalées.

Arrêter et redémarrer proprement un cluster Nutanix AHV

Coupure électrique, déménagement : il faut parfois éteindre tout un cluster. Julien Dumur prévient qu’éteindre les CVM avant d’avoir arrêté les services du cluster expose à une corruption ou à des métadonnées incohérentes.

Avant : un cluster sain

Le guide demande un NCC à jour et un health check complet (lire le rapport NCC). Julien Dumur (2026) s’arrête sur tout FAIL Cassandra, Zookeeper ou métadonnées, contrôle la résilience au niveau nœud, et attend la fin d’une reconstruction avant d’arrêter :

ncc health_checks run_all
ncli cluster get-domain-fault-tolerance-status type=node

Notez enfin les IP des CVM, des hôtes et des IPMI : le forum (2022) les tire de ncli host list.

L’arrêt, dans l’ordre

1. Les services Nutanix. Le guide arrête d’abord les VM liées à AOS, comme les FSVM de Nutanix Files, selon leur documentation. Julien Dumur arrête Prism Central à part : sur la PCVM, cluster stop, cluster status, puis sudo shutdown -h now.

2. Les VM invitées, par couches chez Julien Dumur : test, applicatif, bases, infrastructure en dernier. Boucle du guide, puis vérification qu’il ne reste rien d’allumé :

for i in `acli vm.list power_state=on | awk '{print $1}' | grep -v NTNX` ; do acli vm.shutdown $i ; done
acli vm.list power_state=on

3. Les services du cluster, depuis une CVM :

cluster stop
cluster status

Le critère du guide est le message The state of the cluster: stop. Certains services système restent UP : la sortie publiée par Julien Dumur en 2025 montre Zeus, Scavenger, Xmount, IkatProxy et VipMonitor, et la liste varie selon la version ; son billet de 2026 ne laisse UP que Genesis. À la confirmation, il écrit de taper Y ; une FAQ Schneider Electric (2021, PowerChute Network Shutdown 4.4.1) indique qu’elle attend « I agree » depuis AOS 5.20.

4. Les CVM, chacune par son IP propre. Trois positions coexistent :

  • le guide AHV : sudo shutdown -P now sur chaque CVM ;
  • Julien Dumur et le forum (2022) : cvm_shutdown -P now ;
  • une employée Nutanix (2021, réponse marquée solution) : ces deux commandes échouent après la première CVM, qui prend le jeton d’arrêt et ne le rend pas ; cluster arrêté et VM éteintes, elle préconise sudo shutdown -h now.
sudo shutdown -h now   # arrêt complet, cluster arrêté (employée Nutanix, 2021)
cvm_shutdown -P now    # arrêt d'une CVM, cluster en service (ex. un seul nœud)

Tranchez avec la doc de votre version.

5. Les hôtes. Le guide passe par l’arrêt ordonné de l’IPMI, puis un ping pour confirmer ; Julien Dumur et le forum utilisent shutdown -h now en root.

Le redémarrage

Le guide rallume les nœuds (bouton ou IPMI) ; les CVM démarrent seules. Il attend environ 5 minutes après le dernier nœud, puis :

cluster start
cluster status

Tous les services doivent être UP. Julien Dumur rallume d’abord les commutateurs, attend 10 minutes et vérifie que toutes les CVM figurent dans svmips ; le forum (2022) contrôle ping et SSH. Viennent ensuite Prism Central (Julien Dumur), puis les VM invitées et Files (guide).

Un seul nœud

Mode maintenance, pas arrêt du cluster (maintenance d’un nœud). En RF2, un seul nœud à la fois (Virtual Ramblings, 2019).

Ce qu’il faut retenir

  • Ordre : Files et Prism Central, VM invitées, cluster stop, CVM, hôtes ; redémarrage inverse.
  • NCC à jour, chiffrement sain, et attendre la fin d’une reconstruction avant d’arrêter.
  • Le critère d’arrêt est The state of the cluster: stop, pas l’absence de services UP.
  • Pour éteindre les CVM, les sources divergent : suivez la doc de votre version.
  • Gardez les accès IPMI sous la main : c’est par eux que le cluster revient.

In English

Power outage or relocation: the shutdown order of an AHV cluster, from Files and VMs to the hosts through cluster stop and the CVMs, then the restart. Sourced steps, with divergences flagged. After cluster stop, the criterion is the message The state of the cluster – stop, and expired encryption certificates or an unreachable KMS must be fixed before shutdown.

Sources & vérification

Relevé sur : Documentation publique Nutanix (guide d'administration AHV 5.20, Nutanix Bible, Nutanix Community), FAQ Schneider Electric et blogs d'ingénieurs, relevé 2026-10

Comment les billets sont vérifiés et corrigés