Sauvegarder les VM d'un hôte Hyper-V

Ce que fait une politique VM Hyper-V

Une politique VM Hyper-V sauvegarde les machines virtuelles d'un hôte Hyper-V. L'agent est installé sur l'hôte, pas dans les VM. À chaque exécution, il prend un point de contrôle de récupération de chaque VM cochée, il lit les fichiers de disque et la configuration, puis il envoie les données dans le dépôt de l'hôte.

Chaque VM sauvegardée donne son propre point de restauration. Ce point sert à recréer la VM, ou à remettre ses disques à l'état du point. Voir Restaurer une VM Hyper-V.

Une sauvegarde de VM est toujours complète : l'agent relit tous les fichiers de disque à chaque exécution. Les données déjà présentes dans le dépôt ne repartent pas sur le réseau.

Un point de restauration de VM ne donne pas un fichier pris dans la VM. Le portail écrit sur l'onglet VM : « Pour restaurer des fichiers d'une VM, installez aussi l'agent BaaStide dans la VM. »

Prérequis

• Une machine Windows qui est un hôte Hyper-V, avec un agent enrôlé. Voir Installer l'agent sur Windows.
• Le service vmms en marche sur l'hôte. L'agent déclare la fonction Hyper-V à la plateforme seulement quand ce service tourne et que l'espace WMI root\virtualization\v2 existe.
• Le rôle Technicien ou Administrateur. Le rôle Lecture seule lit la liste des VM sans la changer. Voir Rôles et droits.
• Une licence de la plateforme qui permet les sauvegardes.
• Au moins une VM que BaaStide peut protéger. Voir Les VM que BaaStide ne peut pas sauvegarder.

Cette fonction ne porte pas de numéro de version d'agent. À chaque connexion, l'agent déclare à la plateforme ce qu'il sait exécuter sur cette machine. La plateforme n'envoie l'ordre de sauvegarde des VM que si l'agent l'a déclaré. Sinon, la tâche échoue avec la cause agent_unsupported. Voir Versions d'agent minimales par fonction et Codes de cause d'une tâche.

Le portail n'affiche le type VM Hyper-V que sur une machine Windows. Il lit la liste des VM pour savoir si la machine est un hôte Hyper-V. Quand la machine n'est pas un hôte Hyper-V, le type est grisé, avec la cause : « Cette machine n'est pas un hôte Hyper-V, ou son agent ne prend pas encore en charge Hyper-V. »

Lire l'inventaire des VM

L'agent envoie la liste des VM de l'hôte à sa connexion, puis toutes les 15 minutes. Chaque liste remplace la précédente. Le portail affiche la dernière liste dans l'onglet VM de l'hôte.

1. Ouvrez le portail.
2. Ouvrez Endpoints, puis l'hôte Hyper-V.
3. Ouvrez l'onglet VM.

La page porte le titre Machines virtuelles et le texte « Les machines virtuelles Hyper-V de cet hôte. Une politique de type VM Hyper-V sauvegarde chaque VM cochée. » En bas, le portail écrit Liste envoyée par l'agent, suivi de l'ancienneté de la liste.

Le tableau a six colonnes.

Colonne	Ce qu'elle donne
VM	Le nom de la VM, sa génération et la taille de ses fichiers de disque. Une VM vue pour la première fois depuis moins de 7 jours porte l'étiquette Nouvelle.
État	En marche, Arrêtée, Enregistrée, En pause ou Changement d'état.
Sauvegarde	Sauvegardée, Non sauvegardée, Ne peut pas être sauvegardée avec sa cause, ou Absente de l'hôte.
Dernière sauvegarde	La date du dernier point de restauration et son niveau de cohérence. Un dernier résultat en Échec ou Ignorée s'affiche sous la date, avec sa cause.
Remarques	Ce qui demande votre attention sur cette VM : TPM, points de contrôle, cohérence après plantage.
Actions	Le bouton Restaurer, quand la VM a un point de restauration.

Le portail écrit un message au-dessus du tableau dans ces cas :

Cas	Texte du portail
Aucune liste reçue	« L'agent n'a pas encore envoyé la liste des VM. Il l'envoie à sa connexion, puis toutes les 15 minutes. »
Machine qui n'est pas un hôte Hyper-V	« Cette machine n'est pas un hôte Hyper-V, ou son agent ne prend pas encore en charge Hyper-V. »
Hôte sans VM	« Cet hôte n'a pas de machine virtuelle. »
Aucune politique VM	« Aucune politique ne sauvegarde les VM de cet hôte. », avec le bouton Créer une politique Hyper-V.
Nouvelles VM cochées	« N nouvelles VM ont été ajoutées à la sauvegarde. Décochez-les dans la politique si vous ne voulez pas les sauvegarder. »
Dernière exécution plus longue que la fenêtre	« La dernière sauvegarde des VM a duré plus longtemps que la fenêtre de sa politique. Allongez la fenêtre, ou sauvegardez moins de VM dans une politique. »
Plus de 1 024 VM sur l'hôte	« Cet hôte a plus de 1024 VM. La liste montre les 1024 premières. »

Les VM que BaaStide ne peut pas sauvegarder

Dans l'onglet VM, la colonne Sauvegarde écrit Ne peut pas être sauvegardée, et la cause sous cette étiquette. Dans la politique, la ligne de la VM est grisée, avec la même cause.

Cause	Texte du portail
VM d'un cluster de basculement	« VM d'un cluster de basculement. BaaStide ne sauvegarde pas encore ces VM. »
Disque pass-through	« La VM a un disque pass-through (un disque physique de l'hôte). »
Disque partagé	« La VM a un disque partagé (VHD Set ou VHDX partagé). »
Disque sur un partage réseau	« Un disque de la VM est sur un partage réseau. »
Copie Hyper-V Replica	« Copie Hyper-V Replica. Sauvegardez la VM primaire. »
VM protégée (shielded)	« VM protégée (shielded). BaaStide ne peut pas la sauvegarder. »
Version de configuration trop ancienne	« La version de configuration de la VM est trop ancienne pour une sauvegarde. »

Ces VM n'ont pas de case à cocher dans la politique. Pour les protéger, retirez la cause sur l'hôte, par exemple le disque pass-through, puis attendez la liste suivante.

Les champs d'une politique VM Hyper-V

Le formulaire a cinq parties.

Partie	Ce que vous réglez
Nom et type	Le nom de la politique, et son type VM Hyper-V.
Ce qu'il faut sauvegarder	Les VM à sauvegarder et le Type VSS dans une VM Windows.
Quand	Les plannings, le fuseau horaire et la fenêtre de démarrage.
Rétention	Le nombre de points de restauration gardés, par VM.
Réseau	La limite d'envoi de cette politique.

Les valeurs d'une nouvelle politique sont : le nom VM Hyper-V, un planning tous les jours à 02:00, le fuseau horaire de votre navigateur, aucune limite de fenêtre, et une rétention de 7 points quotidiens, 4 hebdomadaires et 12 mensuels. Voir Planification et rétention.

Une politique VM Hyper-V ne porte pas de script avant ou après la sauvegarde. L'API refuse un script sur ce type de politique. Elle ne porte pas non plus d'option avancée de parcours des fichiers.

Créer la politique VM Hyper-V

1. Ouvrez le portail.
2. Ouvrez Endpoints, puis l'hôte Hyper-V.
3. Ouvrez l'onglet Politiques.
4. Cliquez Créer une politique. Quand l'hôte n'a encore aucune politique, le bouton s'appelle Créer la politique. Depuis l'onglet VM, le bouton Créer une politique Hyper-V ouvre le même formulaire avec le type déjà choisi.
5. Saisissez un Nom. Le portail propose VM Hyper-V.
6. Choisissez le type VM Hyper-V.
7. Lisez la liste VM à sauvegarder. Chaque VM que l'hôte peut protéger est cochée.
8. Décochez les VM que vous ne voulez pas sauvegarder.
9. Laissez le Type VSS dans une VM Windows sur Copie, ou changez-le. Voir Choisir le type VSS.
10. Réglez les plannings, la rétention et la limite d'envoi, ou laissez leurs valeurs.
11. Cliquez Créer la politique.

Le portail revient à l'onglet Politiques. Il écrit la date de la prochaine sauvegarde, ou « Les sauvegardes planifiées sont en pause. » quand la politique est désactivée.

La ligne de la politique résume la sélection : Toutes les VM de l'hôte, ou Toutes les VM de l'hôte sauf N.

Un hôte accepte plusieurs politiques VM Hyper-V. Chacune garde ses propres points de restauration. Répartissez les VM entre plusieurs politiques quand une seule exécution ne tient pas dans sa fenêtre.

Cocher et décocher des VM

La politique garde la liste des VM décochées. Une VM que l'hôte crée plus tard n'est donc pas dans cette liste : elle est sauvegardée dès la prochaine exécution.

1. Ouvrez l'onglet Politiques de l'hôte.
2. Cliquez Modifier sur la politique VM Hyper-V. Depuis l'onglet VM, le lien Changer la sélection ouvre la même politique.
3. Cochez ou décochez les VM.
4. Cliquez Enregistrer.

Le formulaire écrit sous la liste : « Une VM que vous décochez est encore sauvegardée pendant 72 heures. Une VM que vous cochez est sauvegardée dès la prochaine exécution. »

Décocher une VM réduit la protection : le changement prend effet 72 heures plus tard, et vous pouvez l'annuler jusque-là. Cocher de nouveau une VM annule ce délai. Voir Annuler une action différée.

Le portail compte les VM au-dessus de la liste : « N VM sur M sauvegardées ». Il compte les VM que l'hôte peut protéger.

La liste ne montre que les VM de la dernière liste de l'agent. Une VM qui a quitté l'hôte n'a plus de case à cocher ; la politique garde sa place dans les VM décochées.

Choisir le type VSS

Le champ Type VSS dans une VM Windows règle la demande que Hyper-V passe au service de copie d'ombre dans la VM. Il a deux valeurs :

Valeur	Ce qu'elle fait
Copie (recommandé)	Garde la chaîne de journaux de SQL Server et d'Exchange dans la VM.
Complète	Tronque les journaux.

Le formulaire écrit : « Copie garde la chaîne de journaux de SQL Server et d'Exchange dans la VM. Complète tronque les journaux : choisissez-la seulement si aucun autre outil ne sauvegarde ces journaux. »

Ce réglage ne concerne que les VM qui exécutent Windows.

Copier la politique sur d'autres hôtes

Vous copiez une politique VM Hyper-V sur d'autres hôtes du MSP, comme une politique de fichiers. Voir Copier une politique sur d'autres machines.

Deux règles s'ajoutent :

• L'hôte cible doit être une machine Windows. Sinon, le portail écrit l'erreur de la cible.
• La copie ne garde pas les VM décochées. Elles nomment des VM de l'hôte source, qui n'existent pas sur la cible. Toutes les VM de l'hôte cible sont donc sauvegardées. Vérifiez la sélection de chaque cible après la copie.

Sauvegarder maintenant

1. Ouvrez l'onglet Politiques de l'hôte.
2. Cliquez Sauvegarder maintenant sur la ligne de la politique VM Hyper-V.
3. Le portail ouvre la page de la tâche.

Une politique désactivée accepte encore une sauvegarde à la main.

Le bouton est grisé quand l'agent est hors ligne, ou quand son accès est révoqué. Le portail écrit la cause sous le bouton.

La barre de sélection de la liste Endpoints ne lance pas de sauvegarde de VM. Elle lance les sauvegardes de fichiers et les images. Voir Sauvegarder maintenant.

Lire le résultat d'une sauvegarde de VM

Une tâche, un résultat par VM

Une exécution de la politique donne une seule tâche, de type Sauvegarde des VM Hyper-V. L'agent traite les VM une par une. Une VM en échec n'arrête pas les autres.

L'état de la tâche vient des résultats des VM :

Résultat des VM	État de la tâche
Toutes les VM sauvegardées	Réussie
Des VM sauvegardées et des VM en échec	Partielle
Aucune VM sauvegardée et au moins un échec	Échouée

Vous suivez la tâche comme une sauvegarde de fichiers. Voir Suivre une tâche de sauvegarde.

Le résultat de chaque VM

La colonne Dernière sauvegarde de l'onglet VM donne le résultat de chaque VM : la date du point de restauration, son niveau de cohérence, et la cause quand la VM a échoué ou a été ignorée.

Le niveau de cohérence a quatre valeurs :

Niveau	Ce qu'il veut dire
Cohérente au niveau application	Les applications de la VM Windows ont été prévenues d'enregistrer leurs données.
Systèmes de fichiers figés	Les systèmes de fichiers de la VM Linux ont été figés.
Cohérente après plantage	Les applications n'ont pas été prévenues. L'état est celui d'une coupure de courant.
VM arrêtée	La VM était arrêtée.

Une VM en marche donne une sauvegarde cohérente après plantage dans ces cas : le service d'intégration Sauvegarde de la VM est désactivé, la VM est en pause ou enregistrée, ou le point de contrôle au niveau application a échoué et l'agent a réessayé sans lui.

Les remarques de la colonne Remarques

Remarque	Texte du portail
Point de contrôle ancien	« Cette VM a un point de contrôle de sauvegarde de plus de 24 heures. Son fichier de disque grossit et peut remplir le volume. »
Cohérence après plantage	« La dernière sauvegarde est cohérente après plantage : les applications de la VM n'ont pas été prévenues d'enregistrer leurs données. Vérifiez le service d'intégration Sauvegarde de la VM. »
Service d'intégration coupé	« Le service d'intégration Sauvegarde de la VM est désactivé : ses sauvegardes sont cohérentes après plantage. »
TPM sauvegardé	« TPM virtuel sauvegardé avec la VM. Une restauration sur un autre hôte du client garde le TPM. »
Gardien TPM absent	« La dernière sauvegarde ne contient pas le gardien TPM. Sur un autre hôte, la VM recevra un nouveau TPM vide : gardez sa clé de récupération BitLocker hors de l'hôte. »
Points de contrôle automatiques	« Les points de contrôle automatiques sont actifs : la chaîne de disques s'allonge à chaque démarrage de la VM. »
Points de contrôle de l'utilisateur	« N points de contrôle ».

Dans les alertes

Une sauvegarde de VM en échec ou manquée donne une alerte, avec les mêmes règles qu'une sauvegarde de fichiers. Les alertes des VM sont séparées de celles des fichiers : une VM sauvegardée ne ferme pas une alerte de sauvegarde de fichiers.

Une alerte s'ajoute pour les VM : Checkpoint de récupération d'une VM Hyper-V de plus de 24 h. Elle s'ouvre quand la liste de l'agent montre un point de contrôle de récupération de plus de 24 heures sur une VM, qu'il vienne de BaaStide ou d'un autre outil. Elle se ferme quand le point de contrôle a disparu. Voir Alertes.

Points de contrôle de récupération

Pour lire les fichiers d'une VM en marche, l'agent crée un point de contrôle de récupération au début de la sauvegarde de cette VM. La VM écrit alors dans un nouveau fichier de disque, enfant du fichier figé. L'agent lit le fichier figé, puis il supprime le point de contrôle et attend la fusion des fichiers.

• L'agent nomme son point de contrôle baastide:<identifiant de l'endpoint>:<identifiant de la tâche>. Il ne touche jamais le point de contrôle d'un autre outil, ni un point de contrôle sans nom.
• Au démarrage de l'agent, et à chaque exécution, l'agent supprime les points de contrôle qu'il a laissés et ses dossiers temporaires.
• Quand la suppression ou la fusion échoue, l'exécution suivante réessaie.

Un point de contrôle qui reste fait grossir le fichier de disque de la VM. Il peut remplir le volume de l'hôte. Surveillez la remarque « point de contrôle de sauvegarde de plus de 24 heures » et l'alerte qui l'accompagne.

Espace libre sur l'hôte

L'agent vérifie l'espace libre avant et pendant la lecture de chaque VM.

• Avant le point de contrôle : chaque volume qui porte un disque de la VM doit avoir au moins 10 % de la taille virtuelle de ces disques de libre, et au moins 2 Gio. Sinon, la VM échoue avec Pas assez d'espace libre pour le point de contrôle.
• Pendant la lecture : l'agent arrête la lecture quand un volume de la VM descend sous 5 % d'espace libre. Un volume plein met la VM en pause.

TPM virtuel et BitLocker

Une VM de génération 2 peut porter un TPM virtuel. BitLocker dans la VM s'appuie sur ce TPM.

L'état du TPM est chiffré par le gardien de l'hôte. BaaStide sauvegarde ce gardien avec la VM, dans le point de restauration. Une VM restaurée sur un autre hôte du même client démarre donc avec son TPM, et BitLocker ne demande pas sa clé de récupération.

• Le gardien est écrit dans le point de restauration seulement. Il est chiffré avec la clé du dépôt, comme les disques. L'agent ne l'écrit jamais sur le disque de l'hôte.
• La plateforme, le portail, l'API et les outils MCP ne reçoivent que les empreintes des certificats du gardien. Ils ne reçoivent jamais de clé privée.
• Quand l'export du gardien échoue, la sauvegarde continue. La VM porte alors la remarque « La dernière sauvegarde ne contient pas le gardien TPM. »

Gardez la clé de récupération BitLocker de chaque VM hors de l'hôte. Elle sert quand le point de restauration ne contient pas le gardien.

Limites et précautions

• Une politique enregistrée ne prouve pas qu'une VM peut être restaurée. Vérifiez la première sauvegarde, puis testez une restauration. Voir Restaurer une VM Hyper-V.
• Une politique VM Hyper-V demande une machine Windows. L'API refuse ce type sur un agent Linux.
• BaaStide ne sauvegarde pas les VM d'un cluster de basculement, les VM protégées (shielded), les copies Hyper-V Replica, ni une VM qui porte un disque pass-through, un disque partagé ou un disque sur un partage réseau.
• Une sauvegarde de VM est toujours complète. Il n'y a pas de sauvegarde incrémentale au niveau de la VM.
• Une VM occupée est réessayée une fois après 60 secondes, puis ignorée avec la cause La VM était occupée.
• Une sauvegarde de VM s'arrête à la fin de la fenêtre de sa politique. Les VM non traitées portent la cause La fenêtre de la politique s'est terminée. L'exécution suivante relit tout.
• La machine exécute une seule sauvegarde à la fois. Une sauvegarde de VM attend qu'une autre sauvegarde du même dépôt finisse, et l'inverse aussi.
• La rétention s'applique par VM : chaque VM garde son propre historique de points de restauration.
• Une politique VM Hyper-V n'exécute aucun script avant ou après la sauvegarde.
• La sélection d'une politique copiée sur un autre hôte est remise à zéro : toutes les VM de l'hôte cible sont sauvegardées.
• Un point de restauration de VM ne donne pas un fichier de la VM. Pour restaurer des fichiers d'une VM, installez aussi un agent dans la VM et créez une politique de fichiers. Voir Politique de sauvegarde de fichiers.
• L'inventaire s'arrête à 1 024 VM par hôte.
• Sans licence de la plateforme qui permet les sauvegardes, le portail refuse une sauvegarde de VM. Les restaurations restent possibles.

Référence

• API : Lister les VM d'un endpoint.
• API : les routes des politiques et des tâches sont dans la référence de l'API.
• Outils MCP : update_vm_policy change la sélection des VM. get_endpoint liste les VM d'un hôte.
• Codes de cause d'une tâche : Codes de cause d'une tâche.