# ---
# 'Kein aktiver Guest-Agent erkannt' - Ursachen & Fix
# ---


# virsh domfsinfo VM liefert nur dann Daten, wenn alle drei Punkte stimmen:
#
#     - In Windows läuft der Dienst 'QEMU Guest Agent'.
#
#        - Prüfen: services.msc -> 'QEMU Guest Agent' = Running; Starttyp Automatic.
#
#        Falls nicht vorhanden: von der virtio-win ISO installieren: guest-agent\qemu-ga-x64.msi.
#
#
#     - Virtio-Serial Treiber ist installiert (Device Manager -> VirtIO Serial Driver ohne gelbes Zeichen).
#
#        - Fehlt? Von derselben ISO: vioserial/2k25/amd64/vioser (? virtio-win\amd64\virtio-serial)
#          via Treiber aktualisieren.
#
#
#    Der Kanal ist in der VM-XML vorhanden (libvirt-Seite):
#
#        Du brauchst einen virtio-serial Controller und einen Channel org.qemu.guest_agent.0.



# QEMU Guest Agent installieren 
#
#  Installer Datei ist auf dem virtio-win ISO image (Laufwer E:) enthalten
#
Doppelklick auf E:\\virtio-win-0.1.285\guest-agent\qemu-ga-x86_64



# Virtio-Serial Treiber 
#
#     - via tools auf der virtio-win disk
#
#        Auf der Windows Server 2025 installation von der virtio-win disk ausführen:
#
#           Doppelklick auf E:\virtio-win-0.2.285\virtio-win-gt-x64
#           Doppelklick auf E:\virtio-win-0.2.285\virtio-win-guest-tools
#
#
#     - direkt installieren von E:\virtio-win-0.2.285\vioserial/2k25/amd64/vioser:
#
#        1. Variante:
#
#           Powershell: pnputil /add-driver "E:\virtio-win-0.2.285\vioserial\2k25\amd64\vioser.inf" /install
#                       Erfolg:
#                          Driver package added successfully.
#                          Driver installed successfully.
#
#
#        2.Variante
#
#           Öffne den Geräte-Manager
#
#               Win + X -> Geräte-Manager
#               (oder: devmgmt.msc im Ausführen-Dialog)
#
#           Nicht erkannte Geräte anzeigen
#
#               Suche nach einem Gerät mit gelbem Warnsymbol, meist unter Andere Geräte oder Unbekanntes Gerät.
#
#               Falls der serielle Port bereits da ist, sollte er z. B. heißen:
#
#                   VirtIO Serial Port
#
#                   PCI Simple Communications Controller
#
#           Treiber manuell installieren
#
#               - Rechtsklick -> Treiber aktualisieren
#
#               - Auf dem Computer nach Treibern suchen
#
#               - Pfad angeben:
#
#                    E:\virtio-win-0.2.285\vioserial\2k25\amd64\
#
#                    -> Weiter klicken.
#
#           Windows sollte den Treiber erkennen und installieren:
#
#               Danach erscheint das Gerät als 'VirtIO Serial Driver' oder 'VirtIO Serial Port' im 
#              Geräte-Manager unter Systemgeräte.




# Controller und Channel dr XML Konfiguration hinzufügen:
#
#
# Controller (falls keiner da):
#
#     <controller type='virtio-serial' index='0'/>
#
#
# Channel 
#
#     <channel type='unix'>
#       <source mode='bind' path='/var/lib/libvirt/qemu/channel/target/WinServer2025.org.qemu.guest_agent.0'/>
#       <target type='virtio' name='org.qemu.guest_agent.0'/>
#       <alias name='channel0'/>
#     </channel>
#
# direkt konfigurieren:
#
#     virsh edit WinServer2025
#
# oder 'attach-device' nutzen:
#
cat >/tmp/virtio-serial-controller.xml <<'EOF'
<controller type='virtio-serial' index='0'/>
EOF
virsh attach-device WinServer2025 /tmp/virtio-serial-controller.xml --live --config

# Guest-Agent Channel
cat >/tmp/qga-channel.xml <<'EOF'
<channel type='unix'>
  <source mode='bind' path='/var/lib/libvirt/qemu/channel/target/WinServer2025.org.qemu.guest_agent.0'/>
  <target type='virtio' name='org.qemu.guest_agent.0'/>
</channel>
EOF
virsh attach-device WinServer2025 /tmp/qga-channel.xml --live --config^