Aller au contenu

Assistant d'import ESXi intégré à PVE

Day 1 · DéployerNiveau 2 · OpérerProcédureRédigé · à valider en lab

Objectif. Importer une VM depuis un hôte ESXi directement dans Proxmox VE avec l'assistant intégré, sans export intermédiaire, puis la démarrer sur le cluster (ici VMID 101 sur ceph-vm).

Principe. Proxmox déclare l'hôte ESXi comme un stockage de type esxi. Il lit la configuration .vmx et les disques via l'API de l'hôte, propose une configuration équivalente et copie les disques vers le stockage cible. La VM source n'est jamais modifiée.

Statut de l'outil

La documentation officielle classe encore l'assistant d'import en aperçu technologique. Il est largement utilisé, mais validez-le sur une VM de test avant chaque nouvelle catégorie de VM (Windows UEFI, Linux LVM, appliance).

Avant de toucher la prod

  • Checklist Préparer une migration VMware complétée pour cette VM.
  • Nœuds PVE à jour (apt update && apt full-upgrade, voir RB-08).
  • Hôte ESXi en version 6.5 à 8.0, joignable en HTTPS depuis le nœud PVE ; connexion à l'hôte ESXi, pas au vCenter (5 à 10 fois plus lent).
  • VM sans snapshot, sans disque vSAN, sans disque chiffré, sur un datastore sans caractère spécial dans le nom.
  • Windows : pilotes VirtIO installés dans la VM source (procédure), IP fixe notée, clé BitLocker récupérée si vTPM (l'état vTPM n'est pas migré).
  • VMware Tools désinstallés juste avant l'arrêt.
  • VM source éteinte (sauf import à chaud, voir plus bas).

Étapes

1. Déclarer l'hôte ESXi comme source

  1. Datacenter → Storage → Add → ESXi.
  2. Renseigner ID (par exemple esxi01), Server (IP ou FQDN de l'hôte), Username (root ou un compte administrateur), Password.
  3. Certificat autosigné : cocher Skip Certificate Verification, ou ajouter l'autorité de certification au magasin de confiance du nœud.
  4. Add. Le stockage esxi01 apparaît sous chaque nœud dans l'arbre de gauche.
pvesm add esxi esxi01 --server 192.0.2.50 --username root --password '<mot-de-passe>' --skip-cert-verification 1
pvesm status | grep esxi01
pvesm list esxi01          # liste les fichiers .vmx importables

2. Lancer l'assistant

  1. Cliquer sur esxi01 sous le nœud cible (pve01). Le panneau liste les VMs de l'hôte.
  2. Sélectionner la VM et cliquer sur Import.
  3. Onglet General : vérifier VM ID (101), nom, sockets/cœurs, mémoire, type d'OS. Choisir le stockage par défaut (ceph-vm) et le bridge par défaut (vmbr0). Format : sans objet sur Ceph, ZFS ou LVM (toujours raw).
  4. Onglet Advanced : stockage par disque, modèle et bridge de chaque carte réseau (choisir VirtIO si les pilotes sont installés), désactivation d'un disque, d'un lecteur CD ou d'une carte, remplacement de l'ISO. Selon la version, une option Prepare for VirtIO-SCSI est proposée pour les invités Windows : si elle est grisée, appliquez la méthode manuelle du disque témoin après l'import.
  5. Onglet Resulting Config : relire les paires clé/valeur qui seront écrites dans /etc/pve/qemu-server/101.conf.
  6. Cliquer sur Import. Suivre la tâche dans le journal des tâches en bas de l'écran.

3. Premier démarrage

  1. Vérifier le contrôleur et le disque de démarrage (Hardware, Options → Boot Order). Windows sans pilote VirtIO SCSI : disque en SATA pour le premier démarrage.
  2. Ajouter le VLAN sur la carte réseau si nécessaire (Hardware → Network Device → VLAN Tag).
  3. Démarrer, ressaisir l'IP fixe, installer ou vérifier le QEMU Guest Agent, activer l'option QEMU Guest Agent.
  4. Lancer la recette post-migration.
  5. Quand toutes les vagues sont terminées : Datacenter → Storage → esxi01 → Remove (pvesm remove esxi01).

Import à chaud (Live Import)

L'option Live Import de l'onglet General démarre la VM Proxmox pendant l'import : les blocs nécessaires sont lus à la demande, le reste est copié en arrière-plan. La VM source reste éteinte, donc une coupure existe toujours, mais elle est plus courte. Si l'import échoue, toutes les écritures faites depuis le démarrage sont perdues. Réservez-la aux VMs testées au préalable et à faible taux d'écriture.

Gros volumes

N'importez pas plus de quatre disques de VM en même temps, comme le recommande la documentation officielle pour les imports en masse. Mesurez le débit sur la vague 0 pour calibrer les fenêtres.

Vérifications

qm config 101
Disques sur ceph-vm (scsi0: ceph-vm:vm-101-disk-0,…), net0 sur le bon bridge et VLAN, ostype correct (win11, l26…), bios: ovmf et efidisk0 présents si la VM source était en EFI.

qm status 101          # status: running
qm guest cmd 101 get-osinfo
L'agent répond, et l'application répond depuis un poste utilisateur.

Rollback

La VM VMware n'a pas été modifiée. Arrêter la VM Proxmox (qm stop 101), rallumer la VM source sous vSphere, réinstaller les VMware Tools si besoin. Supprimer ensuite la VM importée : qm destroy 101 --purge (supprime aussi ses disques). Ne jamais laisser les deux VMs démarrées en même temps.

Pièges vus en support

  • Import via le vCenter au lieu de l'hôte ESXi : durée multipliée, fenêtre de maintenance dépassée.
  • VM avec une longue chaîne de snapshots : import très lent. Consolidez avant.
  • Disque sur vSAN : l'assistant ne le voit pas ou l'import échoue. Déplacez d'abord le disque vers VMFS ou NFS.
  • VM UEFI importée sans disque EFI ou avec la mauvaise entrée de démarrage : invite UEFI Shell. Vérifiez bios: ovmf et efidisk0, puis l'ordre de démarrage.
  • Windows démarré directement sur VirtIO SCSI sans pilote : écran bleu INACCESSIBLE_BOOT_DEVICE. Repassez le disque en SATA.
  • Import à chaud interrompu par une coupure réseau : écritures perdues, redémarrer l'import depuis la source.

Quand ouvrir un ticket iTop

Import qui échoue de façon répétée sur une VM, débit anormalement faible sur toute une vague, VM critique qui ne démarre pas après import et rollback impossible : P2. Question de méthode avant une vague : P4. Joignez le journal de la tâche d'import, qm config 101, la version ESXi et pveversion -v.

Ouvrir un ticket iTop

Pour aller plus loin : Migrate to Proxmox VE (wiki officiel) · Importing Virtual Machines (documentation PVE) · Import OVF/OVA, VMDK