Procédure Pour: administrateurs

Déplacer le stockage d'une machine virtuelle

Déplacer les disques d'une machine virtuelle vers un autre datastore, suivre et limiter la copie, l'annuler, décider après un échec de vérification.

Une migration du stockage copie les fichiers de disque d'une machine virtuelle vers un autre datastore et fait basculer la machine sur les copies. Avec la fonctionnalité de licence live_migration, elle le fait pendant que la machine fonctionne et sans interruption. Une machine hors tension déplace ses fichiers sans aucune fonctionnalité de licence. Vous avez besoin du privilège Resource.HotMigrate pour une machine en cours d'exécution, de Resource.ColdMigrate pour une machine hors tension, et de Datastore.AllocateSpace sur chaque datastore cible. L'assistant qui lance le déplacement est décrit sur Déplacer ; cette page décrit ce que fait le déplacement et comment vous le suivez et le contrôlez. Pour déplacer d'un coup toutes les machines virtuelles d'un datastore, utilisez le mode maintenance d'un datastore, qui lance un déplacement pour chaque machine, en cours d'exécution ou hors tension.

Dans la console

  1. Dans l'inventaire, sélectionnez la machine virtuelle puis Migrer sous Autres actions. Sélectionnez Datastore des disques, choisissez les datastores cibles et le format de chaque disque, puis passez à l'étape Conditions. Les étapes sont décrites sur Déplacer.
  2. Lisez les conditions. Pour une machine en cours d'exécution, le plan de contrôle vérifie d'abord la licence. Sans la fonctionnalité live_migration (migration à chaud), le déplacement est marqué Non remplie avec la raison, et l'assistant ne continue pas. Installez une licence qui inclut la fonctionnalité, voir Licence, ou éteignez la machine et déplacez-la ensuite.

    Assistant de migration, étape Conditions sans la fonctionnalité live_migration : le déplacement est marqué Non remplie avec la raison (Agrandir)
  3. Vérifiez le déplacement et sélectionnez Démarrer la migration du stockage. L'assistant se ferme dès que le plan de contrôle accepte le déplacement. Pour une machine en cours d'exécution, la machine continue d'utiliser ses disques actuels jusqu'à la fin de la copie. Si la copie échoue ou si vous l'annulez, rien ne change.
  4. Ouvrez le résumé de la machine. Tant que le déplacement est ouvert, la carte Migration du stockage l'affiche et se rafraîchit toutes les 2 secondes :

    • la phase : Préparation, Copie des fichiers d’instantanés pour les fichiers en lecture seule des instantanés, Copie ou Copie pendant que la machine fonctionne, Bascule vers les nouveaux disques, Basculé vers les nouveaux disques, Vérification de la copie, et Suppression des anciens fichiers à la fin ;
    • une barre pour l'ensemble du déplacement et une pour chaque disque, avec le datastore d'origine et le datastore de destination ;
    • le Débit, le Temps restant et, pour une machine en cours d'exécution, les Passes de copie : la copie repasse sur le disque pour les blocs que la machine a écrits entre-temps ;
    • Écritures ralenties de ... % lorsque la machine écrit plus vite que la copie ne peut suivre. Le plan de contrôle ralentit alors les écritures disque de la machine pour que la copie puisse se terminer ;
    • la Limite de débit de copie et la Vérification.
    La carte Migration du stockage dans le résumé d'une machine en cours d'exécution : phase, progression par disque, débit, temps restant, limite, vérification (Agrandir)

    Une machine dont le déplacement des disques est ouvert refuse les instantanés, les modifications de disque, les clones, les sauvegardes, l'export, la suppression et un second déplacement jusqu'à la fin du déplacement. Les opérations d'alimentation, la console et les changements de réseau restent possibles. Le tableau du matériel indique Déplacement vers ... pour chaque disque en cours de copie.

  5. Pour changer la vitesse, sélectionnez Modifier la limite, saisissez la Limite en Mio/s (0 supprime la limite) et sélectionnez Appliquer la limite. La nouvelle limite s'applique immédiatement à la copie en cours.

    Boîte de dialogue Limite de débit de copie avec un champ en Mio/s pour le déplacement en cours (Agrandir)
  6. Pour arrêter le déplacement, sélectionnez Annuler le déplacement et confirmez avec Annuler le déplacement. Avant la bascule, la copie s'arrête, les nouveaux fichiers sont supprimés et la machine reste sur ses disques actuels. Après la bascule, la carte affiche La bascule est faite et le déplacement va se terminer. à la place du bouton : le déplacement se termine. Dans le volet des tâches, la tâche affiche le même texte de phase, et Annuler ou la même note.
  7. Lorsque la comparaison après la bascule a trouvé une différence qu'elle n'a pas pu réparer, la carte affiche Les nouveaux disques n’ont pas pu être vérifiés et conserve les anciens fichiers. Consultez les événements de la machine pour les nombres et vérifiez les deux datastores, puis choisissez :

    • Garder les nouveaux disques : la machine continue sur les nouveaux disques et les anciens fichiers sont supprimés. Utilisez-le lorsque vous acceptez les différences ou savez qu'elles sont sans conséquence.
    • Éteindre et revenir aux anciens disques : la machine est éteinte, utilise de nouveau les anciens disques, et les nouveaux fichiers sont supprimés. Les écritures faites depuis la bascule sont perdues.

    Les deux demandent une confirmation. La décision est une tâche à part entière, Décider de l’issue d’une migration du stockage, et l'alarme rouge de la machine est effacée lorsque vous l'acquittez.

    La carte Migration du stockage après un échec de la vérification, avec le choix de garder les nouveaux disques ou d'éteindre et de revenir aux anciens disques (Agrandir)

Résultat

La carte disparaît et le résumé affiche les nouveaux datastores. Les anciens fichiers disparaissent une fois la copie vérifiée. Lorsqu'un fichier n'a pas pu être supprimé, un événement d'avertissement nomme les fichiers et le rapport des images de disque inutilisées du datastore les liste ; le déplacement lui-même a réussi. Lorsque la vérification a réparé des blocs, un événement d'avertissement donne les nombres : signalez-le, car il indique un défaut du stockage.

Si l'hôte ou le plan de contrôle redémarre pendant un déplacement, la carte affiche Fin du déplacement après une interruption. Le déplacement est terminé ou annulé à partir des fichiers dès que l'hôte répond, avec la tâche Terminer la migration du stockage après une interruption.

Automatisation

Avec la CLI

Shell
kyvernon vm relocate-check <id> --datastore <datastore>
kyvernon vm relocate <id> --datastore <datastore> --follow
kyvernon vm relocation <id>
kyvernon vm relocation-limit <id> --max-bandwidth 50
kyvernon tasks cancel <task>
kyvernon vm relocation-resolve <id> --action keep-target
kyvernon vm relocation-resolve <id> --action return-to-source

relocation affiche la phase, les octets, le débit et le temps restant du déplacement ouvert. relocation-limit prend des Mio/s et 0 supprime la limite. relocation-resolve sert pour un déplacement dont la vérification a échoué.

Avec l'API

GET /v1/vms/{id}/relocation renvoie le déplacement ouvert avec phase, state, bytesCopied, bytesTotal, rateBytesS, etaSeconds, passes, throttlePercent, maxBandwidthMibS, verify, cancelable, une liste de disks et error ; la réponse est 404 lorsqu'aucun déplacement n'est ouvert. PATCH /v1/vms/{id}/relocation accepte maxBandwidthMibS. POST /v1/vms/{id}/relocation/resolve accepte action, keepTarget ou returnToSource, et renvoie une tâche. Une annulation est POST /v1/tasks/{id}/cancel sur la tâche renvoyée par le déplacement. Le résultat de la tâche de déplacement contient kind, relocatedDisks, stallMs, verify et leftover.

Version 0.1. Dernière modification : 2026-11-15