Rechercher
SupportConsoleDéveloppeursCommencer un essaiContact

2.4. Activation des fonctionnalités de l'agent invité QEMU sur vos machines virtuelles

download PDF

Pour utiliser certaines fonctionnalités sur une machine virtuelle (VM) hébergée sur votre système RHEL 9, vous devez d'abord configurer la VM pour qu'elle utilise l'agent invité QEMU (GA).

Pour une liste complète de ces fonctionnalités, voir Fonctionnalités de virtualisation nécessitant l'agent invité QEMU.

Les étapes spécifiques requises pour configurer QEMU GA sur une VM diffèrent en fonction du système d'exploitation invité utilisé par la VM :

2.4.1. Activation de l'agent invité QEMU sur les invités Linux

Pour permettre à un hôte RHEL d'effectuer un certain sous-ensemble d'opérations sur une machine virtuelle (VM) Linux, vous devez activer l'agent invité QEMU (GA).

Vous pouvez activer QEMU GA à la fois sur les machines virtuelles en cours d'exécution et sur celles qui sont arrêtées.

Procédure

  1. Créer un fichier de configuration XML pour l'AG QEMU, par exemple nommé qemuga.xml: 

    # touch qemuga.xml

  2. Ajoutez les lignes suivantes au fichier : 

    <channel type='unix'>
   <source mode='bind' path='/var/lib/libvirt/qemu/f16x86_64.agent'/>
   <target type='virtio' name='org.qemu.guest_agent.0'/>
</channel>

  3. Utilisez le fichier XML pour ajouter QEMU GA à la configuration de la VM.

    • Si la VM est en cours d'exécution, utilisez la commande suivante : 

      # virsh attach-device <vm-name> qemuga.xml --live --config

    • Si la VM est arrêtée, utilisez la commande suivante : 

      # virsh attach-device <vm-name> qemuga.xml --config

  4. Dans le système d'exploitation invité Linux, installez l'AG QEMU : 

    # dnf install qemu-guest-agent

  5. Démarrer le service QEMU GA sur l'invité : 

    # systemctl start qemu-guest-agent

Vérification

Pour vous assurer que QEMU GA est activé et fonctionne sur la VM Linux, effectuez l'une des opérations suivantes :

  • Dans le système d'exploitation invité, utilisez la commande systemctl status qemu-guest-agent | grep Loaded. Si la sortie comprend enabled, QEMU GA est actif sur la VM.
  • Utilisez la commande virsh domfsinfo <vm-name> sur l'hôte. Si elle affiche une sortie, QEMU GA est actif sur la VM spécifiée.

Ressources supplémentaires

2.4.2. Activation de QEMU Guest Agent sur les invités Windows

Pour permettre à un hôte RHEL d'effectuer un certain sous-ensemble d'opérations sur une machine virtuelle (VM) Windows, vous devez activer l'agent invité QEMU (GA). Pour ce faire, ajoutez un périphérique de stockage contenant le programme d'installation de l'agent invité QEMU à une machine virtuelle existante ou lors de la création d'une nouvelle machine virtuelle, et installez les pilotes sur le système d'exploitation invité Windows.

Pour installer l'agent invité (GA) à l'aide de l'interface graphique, voir la procédure ci-dessous. Pour installer l'AG dans une interface de ligne de commande, utilisez le programme d'installation Microsoft Windows (MSI).

Conditions préalables

Procédure

  1. Dans le système d'exploitation invité Windows, ouvrez l'application File Explorer.
  2. Cliquez sur This PC.
  3. Dans le volet Devices and drives, ouvrez le support virtio-win.
  4. Ouvrez le dossier guest-agent.

  5. En fonction du système d'exploitation installé sur la VM, exécutez l'un des programmes d'installation suivants :

    • Si vous utilisez un système d'exploitation 32 bits, exécutez le programme d'installation qemu-ga-i386.msi.
    • Si vous utilisez un système d'exploitation 64 bits, exécutez le programme d'installation qemu-ga-x86_64.msi.
  6. Optional: Si vous souhaitez utiliser le pilote série para-virtualisé (virtio-serial) comme interface de communication entre l'hôte et l'invité Windows, vérifiez que le pilote virtio-serial est installé sur l'invité Windows. Pour plus d'informations sur l'installation des pilotes virtio, voir : Installation des pilotes virtio sur un invité Windows.

Vérification

  1. Sur votre VM Windows, accédez à la fenêtre Services.

    Computer Management > Services

  2. Assurez-vous que l'état du service QEMU Guest Agent est Running.

Ressources supplémentaires

2.4.3. Fonctionnalités de virtualisation nécessitant l'agent invité QEMU

Si vous activez QEMU Guest Agent (GA) sur une machine virtuelle (VM), vous pouvez utiliser les commandes suivantes sur votre hôte pour gérer la VM :

virsh shutdown --mode=agent
Cette méthode d'arrêt est plus fiable que virsh shutdown --mode=acpi, car virsh shutdown utilisé avec QEMU GA garantit l'arrêt d'un invité coopératif dans un état propre.
virsh domfsfreeze et virsh domfsthaw
Gèle le système de fichiers de l'invité de manière isolée.
virsh domfstrim

Indique à l'invité de découper son système de fichiers, ce qui permet de réduire les données à transférer lors des migrations.

Important

Si vous souhaitez utiliser cette commande pour gérer une VM Linux, vous devez également définir le booléen SELinux suivant dans le système d'exploitation invité : 

# setsebool virt_qemu_ga_read_nonsecurity_files on
virsh domtime
Interroge ou règle l'horloge de l'hôte.
virsh setvcpus --guest
Indique à l'invité de mettre les processeurs hors ligne, ce qui est utile lorsque les processeurs ne peuvent pas être débranchés à chaud.
virsh domifaddr --source agent
Interroge l'adresse IP du système d'exploitation invité en utilisant QEMU GA. Cette fonction est utile, par exemple, lorsque l'interface de l'invité est directement reliée à une interface hôte.
virsh domfsinfo
Affiche une liste des systèmes de fichiers montés dans l'invité en cours d'exécution.
virsh set-user-password
Définit le mot de passe d'un compte utilisateur donné dans l'invité.
virsh set-user-sshkeys

Modifie le fichier des clés SSH autorisées pour un utilisateur donné dans l'invité.

Important

Si vous souhaitez utiliser cette commande pour gérer une VM Linux, vous devez également définir le booléen SELinux suivant dans le système d'exploitation invité : 

# setsebool virt_qemu_ga_manage_ssh on

Ressources supplémentaires

Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.