Migration, export et import d’une VM

Utilisez une VM jetable sans données de production. Connectez-vous à l’appliance XOA-HL comme administrateur et vérifiez que les hôtes, le stockage et la VM sont disponibles. La migration et l’export déplacent ou copient une VM entière ; ni l’un ni l’autre ne remplace une sauvegarde indépendante et un test de restauration.

1. Choisir l’opération

Ce guide couvre la migration entre hôtes du même pool, l’export XVA sans compression et l’import d’un fichier XVA. La migration entre pools, le remappage des réseaux, les fichiers OVA, l’import depuis une URL, l’import/export de disques seuls et l’import depuis VMware sont hors de son périmètre. Le menu HomeLab masque l’entrée d’import VMware.

2. Migrer une VM au sein de son pool

Prérequis à vérifier avant de commencer :

• Le pool compte au moins deux hôtes connectés, et vous disposez du droit d’administration sur la VM et sur l’hôte cible.
• L’hôte cible atteint les réseaux et le stockage de la VM. Les disques situés sur un SR partagé ne sont pas copiés. Un disque situé sur un stockage que la cible n’atteint pas, comme un SR local, est copié.
• Une fenêtre de maintenance. Un invité en fonctionnement est brièvement suspendu pendant une migration à chaud ; une copie de disque dure plus longtemps et demande de l’espace libre sur le SR cible.
• Un relevé de l’ID de la VM, de son hôte actuel, de chaque disque et de son SR, ainsi qu’un contrôle de l’invité, par exemple une connexion à la console ou un test applicatif.

1. Ouvrez la VM et choisissez Migrer. L’action est proposée pour les VM en fonctionnement ou arrêtées, pas pour les VM suspendues ou en pause. Les utilisateurs en libre-service ne la voient pas.
2. Dans Migrer la VM, utilisez Sélectionner un hôte de destination : pour choisir un autre hôte du même pool. La liste exclut l’hôte actuel. Elle peut aussi afficher des hôtes d’autres pools connectés ; ne les choisissez pas pour cet exercice.
3. Lisez la partie stockage. Si tous les disques sont sur un SR partagé, aucun SR n’est requis. Sinon, XO exige un SR principal (Sélectionner le SR principal…) et permet de choisir un SR pour chaque VDI. Choisissez des SR accessibles en écriture avec assez d’espace libre ; ces disques sont copiés.
4. Choisir un réseau de migration : est facultatif au sein d’un pool. XO présélectionne le réseau de migration configuré pour le pool lorsque l’hôte cible a une adresse sur ce réseau. Tout réseau sélectionné fait passer XO par la migration avec stockage au lieu d’une simple migration dans le pool. Conservez la valeur proposée, sauf si la conception de votre pool désigne un autre réseau.
5. Confirmez et attendez la fin de la tâche. Ne cliquez pas de nouveau pendant que la migration est en cours.
6. Actualisez l’onglet Général de la VM. Vérifiez l’hôte, l’état d’alimentation, la console, le réseau de l’invité et l’application. Après une copie de disque, vérifiez où se trouve chaque disque et l’espace libre des deux SR.

Si une simple migration dans le pool signale qu’un SR est requis, XO la relance automatiquement comme migration avec stockage. Il utilise alors les SR connectés à l’hôte cible ou le SR par défaut du pool. Une migration que vous pensiez rapide peut donc devenir une copie de disque. En cas d’échec, conservez l’erreur de la tâche et vérifiez l’hôte, l’état d’alimentation et les disques de la VM sur chaque SR concerné avant de réessayer. Ne réessayez pas en forçant.

3. Exporter une VM arrêtée en fichier XVA

Il vous faut le droit d’administration sur la VM et assez d’espace libre sur l’ordinateur qui exécute le navigateur.

1. Arrêtez proprement l’invité et vérifiez l’état Halted. Relevez l’ID de la VM, son nom, ses disques et leur taille totale.
2. Choisissez Exporter. Laissez Type sur xva. Laissez Compression sur Disabled, la valeur par défaut. Les autres choix sont GZIP (very slow) et, sur les hôtes XCP-ng, Zstd. L’import d’un XVA compressé n’est pas couvert par ce guide.
3. Confirmez. Download VM affiche un lien de téléchargement, OK et Annuler. Le lien et OK ouvrent la même URL, que le message décrit comme valable une seule fois, pendant une courte durée. N’utilisez que l’un des deux : sélectionnez le lien, puis fermez la boîte de dialogue avec Annuler. L’URL contient un jeton d’accès à usage unique : traitez-la comme un secret jusqu’à son utilisation.
4. Le navigateur enregistre un fichier nommé <date> - <nom de la VM>.xva. Laissez le téléchargement aller jusqu’au bout ; l’annuler arrête l’export. Vérifiez que la taille du fichier est plausible au regard des tailles de disque relevées.
5. Sur l’ordinateur qui exécute le navigateur, relevez une somme de contrôle du fichier, par exemple sha256sum "<fichier>.xva". Utilisez-la pour vérifier le fichier avant un import.

Par défaut, au plus deux exports XVA s’exécutent en même temps pour un pool. Un téléchargement supplémentaire échoue au lieu d’attendre. Laissez les exports en cours se terminer, puis demandez un nouveau lien.

Un XVA contient les disques et la configuration de la VM. Conservez-le comme les données qu’il contient et supprimez-le à la fin du test. Un fichier d’export n’a ni planification, ni rétention, ni validation de restauration : ce n’est pas une tâche de sauvegarde.

4. Importer le XVA comme copie isolée

1. Ouvrez Importer > VM (/#/import/vm). L’entrée de menu n’apparaît que si vous pouvez opérer au moins un pool.
2. Choisissez le pool cible dans Sur le Pool:. Sur le SR: propose le SR par défaut du pool. Choisissez un SR accessible en écriture avec assez d’espace libre.
3. Déposez le fichier .xva dans la zone Déposez ici vos fichiers OVA ou XVA pour importer des machines virtuelles. Vérifiez le nom et la taille du fichier dans la liste. Les fichiers sans extension .xva ou .ova sont ignorés. Laissez From URL désactivé.
4. Sélectionnez Importer et gardez l’onglet du navigateur ouvert jusqu’à la fin de l’envoi. Pour un seul fichier, XO ouvre la page de la nouvelle VM après réussite.
5. Gardez la VM importée arrêtée. Relevez son ID : c’est un objet différent de la VM source, même si le nom est identique. Renommez-la pour éviter toute confusion.
6. Avant le premier démarrage, ouvrez Réseaux et supprimez toutes les interfaces virtuelles ou mettez en place une isolation externe vérifiée. La copie reprend le même système invité, les mêmes paramètres IP, nom d’hôte, identifiants et identités applicatives que la source.
7. Démarrez la copie, puis vérifiez sa console et les données de test relevées.

XO refuse de démarrer une VM dont l’adresse MAC d’une interface duplique celle d’une autre de ses interfaces ou d’une VM en fonctionnement. Le code d’erreur est DUPLICATED_MAC_ADDRESS. Ne forcez pas le démarrage ; supprimez ou isolez d’abord l’interface.

Si l’import échoue (Import de VM échoué), des objets peuvent subsister. Avant de réessayer, vérifiez les disques du SR cible et la liste des VM pour repérer les objets créés pendant la tentative. Ne supprimez que les restes formellement identifiés, avec la procédure de suppression d’une VM jetable.

5. Nettoyer

1. Supprimez la VM de test importée avec la procédure de suppression d’une VM jetable.
2. Supprimez le fichier XVA de l’ordinateur et de tout emplacement temporaire.
3. Vérifiez que la VM source est toujours présente, sur l’hôte attendu, avec ses disques et ses données inchangés.

Si quelque chose ne correspond pas, conservez les relevés et signalez le problème avec les versions et des ID anonymisés.