> ## Documentation Index
> Fetch the complete documentation index at: https://help.onetsolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent invité QEMU

> Installer et configurer l'agent invité QEMU sur votre VPS pour de meilleures performances et une gestion améliorée

L'agent invité QEMU est un composant essentiel pour la communication entre l'hôte et les machines virtuelles basées sur QEMU. Il permet des fonctionnalités telles que l'arrêt propre, le gel du système de fichiers pour les snapshots et une gestion améliorée de la VM.

<Info>
  **Prérequis**

  * Un VPS chez OnetSolutions
  * Un accès SSH ou console à votre serveur
  * Des privilèges root ou sudo
</Info>

## Instructions d'installation

<Tabs>
  <Tab title="Debian/Ubuntu">
    <Steps>
      <Step title="Mettre à jour la liste des paquets">
        ```bash theme={null}
        sudo apt update
        ```
      </Step>

      <Step title="Installer l'agent invité QEMU">
        ```bash theme={null}
        sudo apt install qemu-guest-agent
        ```
      </Step>

      <Step title="Démarrer le service">
        ```bash theme={null}
        sudo systemctl start qemu-guest-agent
        ```
      </Step>

      <Step title="Activer le démarrage automatique">
        ```bash theme={null}
        sudo systemctl enable qemu-guest-agent
        ```
      </Step>

      <Step title="Vérifier l'installation">
        ```bash theme={null}
        sudo systemctl status qemu-guest-agent
        ```

        Vous devriez voir un message indiquant que le service est actif et fonctionne.
      </Step>
    </Steps>
  </Tab>

  <Tab title="CentOS/Rocky/Alma">
    <Steps>
      <Step title="Installer l'agent invité QEMU">
        ```bash theme={null}
        sudo yum install qemu-guest-agent
        ```

        Ou sur les systèmes plus récents avec dnf :

        ```bash theme={null}
        sudo dnf install qemu-guest-agent
        ```
      </Step>

      <Step title="Démarrer le service">
        ```bash theme={null}
        sudo systemctl start qemu-guest-agent
        ```
      </Step>

      <Step title="Activer le démarrage automatique">
        ```bash theme={null}
        sudo systemctl enable qemu-guest-agent
        ```
      </Step>

      <Step title="Vérifier l'installation">
        ```bash theme={null}
        sudo systemctl status qemu-guest-agent
        ```

        Vous devriez voir un message indiquant que le service est actif et fonctionne.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows Server">
    <Steps>
      <Step title="Télécharger l'installeur">
        Téléchargez l'installeur de l'agent invité QEMU depuis [virtio-win releases](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-qemu-ga/qemu-ga-win-105.0.2-1.el9/qemu-ga-x86_64.msi).
      </Step>

      <Step title="Lancer l'installeur">
        Exécutez le fichier `qemu-ga-x86_64.msi` téléchargé et suivez les instructions à l'écran. Acceptez le contrat de licence lorsque cela vous est demandé.
      </Step>

      <Step title="Vérifier l'installation">
        Ouvrez le Gestionnaire des tâches et recherchez le processus `qemu-ga.exe`. S'il est en cours d'exécution, l'agent est correctement installé.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Configuration (optionnelle)

Sur les systèmes Linux, vous pouvez personnaliser le comportement de l'agent invité QEMU en modifiant son fichier de configuration :

```bash theme={null}
sudo nano /etc/qemu/qemu-guest-agent.conf
```

<Note>
  La configuration par défaut convient à la plupart des cas d'utilisation. Ne modifiez ce fichier que si vous avez des besoins spécifiques.
</Note>

## Dépannage

<Accordion title="Le service ne démarre pas">
  Assurez-vous que le canal de l'agent invité QEMU est activé sur votre VM. Contactez le support OnetSolutions si le problème persiste.
</Accordion>

<Accordion title="L'agent ne communique pas avec l'hôte">
  Redémarrez le service et consultez les journaux :

  ```bash theme={null}
  sudo systemctl restart qemu-guest-agent
  sudo journalctl -u qemu-guest-agent
  ```
</Accordion>