Quelltext der Seite Proxmox PVE Virtual Environment QEMU Agent Freeze und Thaw Skripte bei Snapshot ausführen pre-freeze-script post-thaw-script

<u>'''Changelog:'''</u><br>
* 11.05.2025 erste Version
----
==Vorwort==
Ich war auf der Suche wie man bei einem Snapshot eigene Skripte ausführen lassen kann. Unter VMware nutze ich das schon seit Jahren um ein Hot-Backup von MySQL-Datenbanken auszuführen.<br>
Dabei wird unmittelbar vor einem Snapshot ein {{code|pre-freeze-script}} ausgeführt welches die Datenbank flusht und weitere Schreibzugriffe blockiert und unmittelbar danach ein {{code|post-thaw-script}} welches den Schreibzugriff wieder freigibt. Zwischen der Ausführung der beiden Skripte liegen dabei nur wenige Sekunden.<br>
Das Backup kann danach die vollständige VM wegsichern und es ist sichergestellt das die Datenbank im inneren Konsistent ist.<br>
<br>
Das muss doch auch unter Proxmox PVE gehen ... jupp, es geht!<vr>
Da das ganz kein Selbstläufer war - ich musste mir das wieder aus verschiedenen Webseiten und Quellen zusammensuchen.<br>
----
==Voraussetzungen==
Damit das ganze funktioniert müssen in der VM die QEMU-Tools installiert sein.<br>
Unter Ubuntu / Debian z.B. mit<br>
 apt install qemu-guest-agent
 systemctl enable qemu-guest-agent.service
 systemctl start qemu-guest-agent.service
Unter Windows muss man diese per ISO installieren:<br>
 https://pve.proxmox.com/wiki/Windows_VirtIO_Drivers
Siehe auch: https://pve.proxmox.com/wiki/Qemu-guest-agent
<br>
Zusätzlich muss in der Option der VM der {{code|QEMU Guest Agent}} aktiviert sein:<br>
:[[Datei:ClipCapIt-250511-141504.PNG]]<br>
Ob der Agent auch läuft und Funktioniert, kann man unter anderen in der Summary daran sehen das dort die {{code|IPs}} der VM zu sehen sind:<br>
:[[Datei:ClipCapIt-250511-141619.PNG]]<br>
<br>
----
==Linux==
Es sollte ein Verzeichnis
 /etc/qemu
geben in welchem ein Skript und ein Verzeichnis liegt:<br>
 /etc/qemu/
 ├── fsfreeze-hook
 └── fsfreeze-hook.d
Das Skript wird bei jedem Snapshot 2x aufgerufen. Diese startet wiederum jedes Skript im Unterverzeichnis
 /etc/qemu/fsfreeze-hook.d/
Dabei werden die Skripte beim ersten mal, unmittelbar vor dem Snapshot mit dem Parameter {{code|freeze}} aufgerufen und danach mit dem Parameter {{code|thaw}}.<br>
Leider wird das Skript "ab Werk" nicht gestartet, das der QEMU Agent das beachten soll muss man diesem erst in die Konfiguration schreiben - und die gibt es nicht ...<br>
Wir könnten das direkt in den Aufruf des Dienstes per {{code|qemu-guest-agent.service}} schreiben, eleganter geht es wie folgt:<br>
 qemu-ga -D > /etc/qemu/qemu-ga.conf
Schreibt die aktuell gültige Konfiguration in die Datei {{code|/etc/qemu/qemu-ga.conf}}, diese müssen wir danach aber unbedingt bearbeiten:<br>
 nano /etc/qemu/qemu-ga.conf
und wie folgt abändern:<br>
 [general]
 daemon=false
 method=virtio-serial
 path=/dev/virtio-ports/org.qemu.guest_agent.0
 pidfile=/var/run/qemu-ga.pid
 statedir=/var/run
 verbose=false
 retry-path=false
 <span style="background:yellow"># block-rpcs=</span>
 <span style="background:yellow"># allow-rpcs=</span>
 <span style="background:lightgreen">fsfreeze-hook=/etc/qemu/fsfreeze-hook</span>
Die beiden gelben Zeilen müsst Ihr unbedingt auskommentieren, sonst startet der Dienst hinterher nicht mehr (es darf nur eine der beiden Zeilen zur gleichen Zeit angegeben sein),<br>
die grüne Zeile sorgt dafür das das {{code|/etc/qemu/fsfreeze-hook}} in Zukunft auch aufgerufen wird.<br>
Speichert die Datei und startet den Dienst einmal neu:<br>
 systemctl restart qemu-guest-agent.service
und prüft ob das geklappt hat - wenn in der Konfigurationsdatei etwas falsch eingetragen ist, startet dieser eben nicht:<br>
 systemctl status qemu-guest-agent.service
Beispielausgabe:<br>
 ● qemu-guest-agent.service - QEMU Guest Agent
      Loaded: loaded (/usr/lib/systemd/system/qemu-guest-agent.service; static)
      Active: active (running) since Sun 2025-05-11 14:33:02 CEST; 43s ago
    Main PID: 252408 (qemu-ga)
       Tasks: 2 (limit: 4609)
      Memory: 404.0K (peak: 424.0K)
         CPU: 27ms
      CGroup: /system.slice/qemu-guest-agent.service
              └─252408 /usr/sbin/qemu-ga
<br>
<br>
Zum testen erstellen wir das folgende Skript:<br>
 nano /etc/qemu/fsfreeze-hook.d/test.sh
mit folgendem Inhalt:<br>