PVE : VM verrouillée ou impossible à arrêter¶

Objectif. Débloquer une VM affichant un cadenas (locked) ou qui ne répond plus à l'arrêt, sans corrompre ses disques.

Étape 1 · Comprendre le verrou¶

GUI : le cadenas et son type s'affichent sur la VM ; la liste des tâches (bas de l'écran) montre l'opération en cours.

qm config 101 | grep lock         # ex. lock: backup

Verrou	Posé par	Action
backup	Sauvegarde vzdump	Vérifier que la sauvegarde est finie ou arrêtée
migrate	Migration	Vérifier la tâche de migration sur les deux nœuds
snapshot / snapshot-delete	Création ou suppression de snapshot	Attendre ou consulter le log de la tâche
clone / create	Clonage, création	Attendre la fin de la tâche
suspended	Mise en veille (hibernation)	Reprendre la VM (Resume)

Étape 2 · Lever le verrou¶

Seulement si aucune tâche liée ne tourne encore

ps aux | grep -E 'vzdump|qm (migrate|snapshot)' | grep 101
qm unlock 101

Conteneur : pct unlock 101.

Étape 3 · VM qui ne s'arrête pas¶

Shutdown (arrêt propre) nécessite que l'OS réponde ; avec l'agent invité : qm guest cmd 101 ping.
Si l'OS ne répond pas : Stop (équivalent d'une coupure de courant). GUI : VM → Shutdown → flèche → Stop.
```
qm stop 101
```
Si qm stop échoue (tâche bloquée) : ticket. Le MSP pourra arrêter le processus QEMU (PID dans /var/run/qemu-server/101.pid).

VM gérée par la HA. Un arrêt manuel est considéré comme une panne et la HA redémarre la VM. Passer par la HA :

ha-manager set vm:101 --state stopped

Vérifications

Plus de cadenas, qm status 101 cohérent, prochaine sauvegarde de la VM réussie.

Pièges vus en support

Lever un verrou backup pendant une sauvegarde en cours peut produire une sauvegarde incohérente.
Lever un verrou migrate au milieu d'une migration peut laisser la VM sur deux nœuds dans la configuration : ticket.
Un Stop répété sur une base de données peut entraîner une récupération longue au redémarrage.

Quand ouvrir un ticket iTop

Verrou migrate orphelin, qm stop sans effet, VM visible sur deux nœuds : P2. Joindre qm config <vmid>, le log de la dernière tâche, ha-manager status.

Ouvrir un ticket iTop pour RB-10 Que joindre au ticket ?

Rubrique : Proxmox VE · Architecture : Toutes · Rédigé pour PVE 9.x, PBS 4.x, Ceph 19.2 · Brouillon à valider en lab avant publication · Documentation officielle : PVE · PBS