> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/machines-virtuelles/vm-guest-agent.md). # Agent invité VM L’agent invité est un programme installé dans le système d’exploitation invité qui permet à l’hôte d’exécuter des commandes à l’intérieur de la VM. Cela permet des sauvegardes cohérentes et fiables en figeant le système de fichiers invité avant les instantanés et un arrêt correct d’un invité sans dépendre d’ACPI, de politiques, etc. ## Exigences * Activer l’agent invité pour la VM * Installation de l’agent invité (dans le système d’exploitation invité) ## Activer l’agent invité L’agent invité doit être activé par VM ; cela peut être fait lors de la création de la VM ou en modifiant une VM existante. La case à cocher Agent invité sur le tableau de bord de la VM indique si l’agent est activé. ![agent-enabled-notconnected.png](/files/4636ab8c25a867f4520127e1d89cb3262165bbc0) ### Activer l’agent invité sur une VM existante 1. Accédez au tableau de bord de la VM 2. Cliquez sur **Modifier** dans le menu de gauche. 3. Cliquez pour cocher le **Agent invité QEMU** case à cocher. 4. Cliquez sur **Soumettre** pour enregistrer la modification. ## Installer le logiciel de l’agent sur les VM Windows ### Pour télécharger/installer l’installateur des outils invités L’installateur de l’agent invité peut être téléchargé depuis le lien suivant (et exécuté dans l’invité) : {% hint style="success" %} Pendant la configuration de l’installateur VirtIO, veillez à sélectionner le *Installation* bouton pour le logiciel du périphérique. {% endhint %} La VM nécessitera un redémarrage afin d’appliquer les modifications et de connecter l’agent. ### Pour télécharger l’ISO VirtIO complet vers le vSAN Les instructions suivantes expliquent comment placer le fichier win-virtio.iso (contenant le logiciel invité nécessaire de l’agent) sur le vSAN ; cela permet de charger le logiciel sur le lecteur CD-ROM d’une VM pour une installation facile dans le système d’exploitation invité. 1. Cliquez sur le lien ci-dessous pour accéder à l’ISO VirtIO. 2. Le lien « Upload from URL » apparaît, avec tous les champs préremplis automatiquement ; en général, aucune modification n’est nécessaire ; toutefois, en option, les champs Nom de fichier, Description du fichier et/ou Niveau préféré peuvent être modifiés, si souhaité. 3. Cliquez sur Soumettre pour télécharger le fichier ISO VirtIO vers le vSAN. 4. Lorsque la progression indique 100 % terminé (barre de progression en haut à droite), le fichier est disponible, apparaissant dans la liste des fichiers et comme option de sélection sur n’importe quel lecteur CD. Voir les instructions ci-dessous pour installer le logiciel de l’agent invité à partir de l’ISO VirtIO téléchargée. ### Pour installer l’agent invité (Windows) à partir de l’ISO VirtIO {% hint style="info" %} La VM doit disposer d’un périphérique CD-ROM {% endhint %} 1. Accédez au **tableau de bord de la VM**. 2. Cliquez sur le bouton de sélection du CD-ROM (en haut à gauche) ![fa-eject.png](/files/d68e0ee7778a28b022e78126ab91612f41641292) 3. Sélectionnez **virtio-win.iso (ou nom de fichier modifié lors du téléchargement)**. 4. Cliquez sur **Soumettre** pour appliquer la modification du CD. 5. Cliquez sur **Console distante** dans le menu de gauche pour ouvrir une console dans le système d’exploitation invité. 6. Accédez à **Gestionnaire de périphériques Windows**. 7. Cliquez avec le bouton droit sur **"Contrôleur de communications PCI simple"**. 8. Sélectionnez **Mettre à jour le pilote**. 9. Accédez au **chemin du lecteur CD-ROM** contenant l’ISO téléchargée. 10. Naviguez jusqu’à : **vioserial\VOTRE VERSION DE WINDOWS (ex. : 2k12R2, WIN10, etc.)**. 11. Cliquez sur **Suivant** pour terminer la mise à jour du pilote. 12. Dans l’Explorateur de fichiers Windows, **accédez au CD-ROM** avec l’ISO VirtIO. 13. Naviguez jusqu’au **dossier guest-agent** . 14. **Double-cliquez** sur le bon fichier MSI **(qemu-ga-x86.msi \[64 bits] ou qemu-ga-1386.msi \[32 bits])** pour lancer l’installateur. {% hint style="success" %} Un redémarrage de la VM peut être nécessaire afin de connecter l’agent à l’hôte. {% endhint %} ## Installer le logiciel de l’agent sur les VM Linux Sur les VM Linux, le **package qemu-guest-agent** doit être installé. Les instructions d’installation varieront selon la distribution/version Linux spécifique. * Sur les systèmes qui utilisent apt pour l’installation **(basés sur Debian/Ubuntu)**: ``` apt-get install qemu-guest-agent ``` * Sur les systèmes utilisant **Yum (Red Hat)**: ``` yum install qemu-guest-agent ``` * Certaines distributions nécessiteront **un redémarrage ou un démarrage manuel** de l’agent : ``` systemctl start qemu-guest-agent ``` ## Vérifier la connexion de l’agent invité de la VM Lorsqu’un agent invité est connecté avec succès, le numéro de version s’affichera à côté de la case à cocher Agent invité cochée sur le tableau de bord de la VM. ![agent-connected-version.png](/files/5cc06b97e564d5c9061308f6224371dbdf6d9e03) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/fr/machines-virtuelles/vm-guest-agent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.