Mode maintenance d'un datastore

Vider un datastore de ses machines, modèles, images ISO et fichiers avant une maintenance, suivre l'évacuation, relancer les échecs et quitter.

Le mode maintenance vide un datastore avant une intervention sur son stockage. Dès que vous démarrez, plus rien de nouveau n'est placé sur le datastore. Tout ce qui l'utilise est déplacé vers d'autres datastores que les mêmes hôtes montent : machines virtuelles et modèles, images ISO qu'un lecteur utilise, bibliothèques de contenu et, si vous le choisissez, les autres fichiers. Les machines en cours d'exécution continuent de tourner pendant le déplacement de leurs disques. Vous avez besoin du privilège Datastore.Config sur le datastore et de Datastore.AllocateSpace sur les datastores qui reçoivent les données. Déplacer les disques d'une machine en cours d'exécution demande la fonctionnalité de licence live_migration ; une machine hors tension se déplace sans elle, voir Licence.

Dans la console

Dans l'inventaire, sélectionnez le datastore puis Passer en mode maintenance… sous Autres actions. L'action est grisée lorsque votre rôle n'a pas Datastore.Config. La boîte de dialogue Passer ... en mode maintenance s'ouvre avec trois étapes.
À l'étape Cibles, choisissez où vont les données. Choisir automatiquement choisit, pour chaque élément, le datastore qui a le plus d'espace libre parmi ceux que l'hôte de l'élément monte. La boîte de dialogue liste les datastores prévus avec leur espace libre maintenant et après le déplacement. Avec Choisir des datastores, vous cochez les datastores qui peuvent recevoir des données, chacun avec son type, son espace libre et son nombre d'hôtes. Un datastore inaccessible ou lui-même en mode maintenance est listé mais ne peut pas être coché.
Sous Autres fichiers de ce datastore, choisissez le sort des fichiers qu'aucune machine virtuelle, aucun modèle, lecteur ou bibliothèque n'utilise, comme les images téléversées et les dossiers de machines non enregistrées. Les laisser les garde en place, et le datastore passe quand même en mode maintenance. Les déplacer aussi les déplace aussi vers les cibles. Pour ménager le réseau de stockage, saisissez une Limiter le débit de copie (Mio/s) ; laissez le champ vide pour la valeur par défaut du cluster, ou saisissez 0 pour aucune limite. Sélectionnez Suivant.

(Agrandir)
Fermer la vue agrandie
À l'étape Ce qui sera déplacé, lisez ce que le plan de contrôle ferait avec vos choix. Rien n'a démarré. Le tableau liste chaque élément avec son type, sa taille et sa cible : Machine virtuelle, en cours d'exécution, Machine virtuelle, éteinte, Modèle, Image ISO, Bibliothèque de contenu et Fichiers. Sous le tableau, vous voyez l'espace restant sur chaque cible. Un élément marqué Impossible à déplacer indique sa raison et ce qu'il faut faire, par exemple une machine en cours d'exécution avec des instantanés internes, un datastore sans place, ou une machine en cours d'exécution sans la fonctionnalité de licence. Un élément marqué Reste reste en place volontairement. Une cible qui serait remplie à plus de 85 pour cent porte un avertissement.

(Agrandir)
Fermer la vue agrandie

Sans la fonctionnalité de licence live_migration, une machine en cours d'exécution ne peut pas déplacer ses disques, et l'étape le dit. Éteignez-la ou installez une licence qui inclut la fonctionnalité ; une machine hors tension se déplace sans elle.

(Agrandir)
Fermer la vue agrandie
À l'étape Récapitulatif, vérifiez vos choix et sélectionnez Passer en mode maintenance. Vous pouvez démarrer avec des éléments qui ne peuvent pas être déplacés : le datastore reste alors en Passage en maintenance jusqu'à ce que vous les ayez résolus. La boîte de dialogue se ferme lorsque le plan de contrôle accepte la tâche.
Suivez l'évacuation. Le datastore affiche le badge Passage en maintenance dans son en-tête, dans les listes et dans l'arborescence de l'inventaire, et l'onglet Maintenance apparaît. Il indique qui a démarré l'opération et quand, une barre sur les octets déplacés, les totaux, et une ligne par élément avec son état (En attente, Déplacement, Déplacé, Échec ou Laissé en place), sa progression et ses remarques. Une machine en cours d'exécution précise qu'elle est déplacée pendant son exécution. L'onglet se rafraîchit toutes les 3 secondes tant que la tâche tourne, et la tâche du volet des tâches indique combien d'éléments ont été déplacés.

(Agrandir)
Fermer la vue agrandie

Pour arrêter, sélectionnez Annuler et confirmez avec Annuler l'évacuation. Les déplacements en cours sont annulés lorsque c'est encore possible, et le datastore reste en Passage en maintenance.
Lorsque des éléments ont échoué, le datastore reste en Passage en maintenance et l'onglet indique leur nombre. Chaque ligne en échec donne l'erreur et ce qu'il faut faire. Sélectionnez Échecs uniquement pour ne voir que celles-ci. Résolvez la cause, par exemple éteignez la machine, libérez de l'espace sur une cible ou installez la licence, puis sélectionnez Réessayer sur la ligne, ou Relancer l'évacuation pour tous les éléments en échec. Les éléments déjà déplacés restent déplacés.

(Agrandir)
Fermer la vue agrandie
Lorsque chaque élément a été déplacé ou laissé volontairement, le badge devient En maintenance. Vous pouvez intervenir sur le stockage. Pour utiliser à nouveau le datastore, sélectionnez Quitter le mode maintenance sous Autres actions ou dans l'onglet, et confirmez. Rien n'est déplacé en retour.

Ce qu'un datastore en maintenance refuse

Dès le début du mode maintenance, un datastore en Passage en maintenance ou En maintenance n'accepte plus de nouvelles données. Les sélecteurs de la console le listent comme désactivé, avec la raison : l'assistant de nouvelle machine virtuelle, les disques nouveaux et rattachés, les images ISO, la restauration d'une sauvegarde, l'import, l'enregistrement, les bibliothèques de contenu et le datastore de l'assistant de migration. On ne peut pas y téléverser de fichiers ni y créer de dossiers. Vous pouvez toujours parcourir, télécharger et supprimer, ainsi que le monter ou le démonter sur un hôte. Le plan de contrôle répond à chaque refus par error.datastore.in_maintenance.

Liste des datastores d'un hôte avec les badges Passage en maintenance et En maintenance dans la colonne Maintenance

Fermer la vue agrandie

Résultat

Le datastore ne contient plus de machine virtuelle, de modèle, d'image ISO utilisée ni de bibliothèque, et son état est En maintenance. L'évacuation reste visible dans l'onglet Maintenance après la sortie, jusqu'à ce que la suivante la remplace. Chaque élément est une tâche à part, et l'évacuation entière est la tâche Passer le datastore en mode maintenance.

Automatisation

Avec la CLI

Shell

kyvernon datastore maintenance-check <id> --other-files move
kyvernon datastore enter-maintenance <id> --target <datastore> --max-bandwidth 100 --wait
kyvernon datastore maintenance <id>
kyvernon datastore maintenance-retry <id> --item <item>
kyvernon datastore exit-maintenance <id> --wait

maintenance-check montre ce que l'évacuation ferait et ne démarre rien. --target se répète pour autoriser plusieurs cibles, et sans lui le plan de contrôle choisit. --other-files vaut leave (par défaut) ou move, et --max-bandwidth est en Mio/s. maintenance montre l'état et le tableau des éléments. maintenance-retry relance l'évacuation pour les éléments en échec, ou pour un seul élément avec --item.

Avec l'API

POST /v1/datastores/{id}/maintenance/check prend targets, otherFiles et options (maxBandwidthMibS) et répond avec les éléments, les totaux, les octets et l'espace par cible, avec refusal lorsque la tâche elle-même serait refusée. POST /v1/datastores/{id}/enter-maintenance prend le même corps et un idempotencyKey, et répond par une tâche. GET /v1/datastores/{id}/maintenance répond avec l'état (normal, entering ou inMaintenance), la tâche en cours et l'évacuation avec ses éléments. POST /v1/datastores/{id}/maintenance/items/{item}/retry et POST /v1/datastores/{id}/exit-maintenance répondent par une tâche. Annulez l'évacuation avec POST /v1/tasks/{id}/cancel.