In der ersten Jahreshälfte 2026 sind wir dabei, eine Reihe von Virtual-Servern auf die neue Virtualisierungs-Plattform zu migrieren. Bei einer sehr kleinen Anzahl von Systemen kommt es dabei zu Problemen, die eine automatische Migration, wie gewünscht, verhindern. Dieser Artikel ist für Sie relevant, wenn Sie vom Support explizit kontaktiert wurden, um mitzuteilen, dass die hier beschriebene Thematik für Ihren Server vorliegt und Lösungen umgesetzt werden sollen.
Vor der Migration
- Durch die Migration ist es nötig, dass die Virtualisierung in die Lage versetzt wird, Netzwerkeinstellungen und andere Steuerungsoptionen, wie zum Beispiel Passwortänderungen, durchführen zu können. Dafür ist es erforderlich, dass der QEMU Guest Agent installiert ist und ordnungsgemäß erreichbar ist.
Installieren Sie diesen gegebenenfalls neu, wie hier beschrieben:
Installation des QEMU Guest Agent
Linux
- Installieren Sie den QEMU Guest Agent mit dem Paketmanager Ihrer Distribution:
- Red-Hat-basiert (AlmaLinux, CentOS, RHEL):
yum install qemu-guest-agent - Debian-basiert (Debian, Ubuntu):
apt install qemu-guest-agent
- Red-Hat-basiert (AlmaLinux, CentOS, RHEL):
- Stellen Sie sicher, dass
BLACKLIST_RPC=in der Konfigurationsdatei leer ist:- Red-Hat-basiert:
/etc/sysconfig/qemu-ga - Debian-basiert:
/etc/default/qemu-ga
- Red-Hat-basiert:
- Aktivieren Sie den Dienst
qemu-guest-agent, damit er beim Systemstart automatisch gestartet wird:
systemctl enable qemu-guest-agent - Starten Sie den Dienst
qemu-guest-agent:
systemctl start qemu-guest-agent
Windows
- Laden Sie die aktuelle ISO-Datei mit den VirtIO-Treibern auf die VM herunter:
- Öffnen Sie die Download-Seite für die VirtIO-Treiber
- Wählen Sie stable-virtio aus
- Laden Sie virtio-win.iso herunter
Empfohlene VirtIO-Treiberversionen:
- Windows Server 2016 und neuer:
Neueste stabile Version
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/ - Windows Server 2012/2012 R2 (EOL):
0.1.248-1
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/virtio-win-0.1.248-1/
- Binden Sie die ISO-Datei ein, indem Sie sie im Datei-Explorer doppelt anklicken.
- Führen Sie
virtio-win-gt-x64.exeaus, das sich im Stammverzeichnis der eingebundenen ISO befindet. - Schließen Sie den Installationsassistenten mit den Standardeinstellungen ab.
- Führen Sie das Installationsprogramm für den QEMU Guest Agent aus, das sich im Unterverzeichnis
guest-agentder eingebundenen ISO befindet.
- Installieren Sie den QEMU Guest Agent mit dem Paketmanager Ihrer Distribution:
- Sorgen Sie dafür, dass das System auf dem aktuellen Software-Stand ist und die verfügbaren Updates eingespielt sind. Oft sind von dieser Thematik auch Systeme betroffen, die einen sehr alten, nicht mehr unterstützten Softwarestand haben. Wenn dies bei Ihnen der Fall ist, sollten Sie in Erwägung ziehen, auf einen aktuelleren Server mit einem Betriebssystem zu wechseln, das noch vom Distributor mit Sicherheitsupdates versorgt wird. Eine solche Änderung ist hier beschrieben und kann auch vom Support gerne in Absprache mit Ihnen in die Wege geleitet werden.
- Sollten Sie selbst ungewöhnliche manuelle Änderungen an den Netzwerkeinstellungen vorgenommen haben, prüfen Sie bitte, ob diese in den Standardzustand zurückversetzt werden können.
- Stellen Sie sicher, dass Ihnen das aktuelle Root- bzw. Administrator-Passwort bekannt ist und ändern Sie es gegebenenfalls, da dies nach der Migration nicht mehr ohne Weiteres möglich ist.
- Sichern Sie Ihre Daten, idealerweise auch extern, da nach der Migration kein Zugriff mehr auf unsere automatischen Backups auf der alten Plattform besteht.
Nach der Migration
Wenn diese Änderungen nicht vor der Migration durchgeführt wurden, ist es wahrscheinlich, dass das System nicht mehr über das Netzwerk erreichbar ist, da die entsprechenden Einstellungen nicht gesetzt werden können. In diesem Fall ist ein manuelles Eingreifen über die Reparaturkonsole erforderlich. Wenden Sie sich dazu im Zweifelsfall gerne mit einem Auftrag über das KIS an den Support, um die entsprechenden Änderungen vornehmen zu können. Geben Sie dabei das entsprechende Root- bzw. Administrator-Passwort an.
In the first half of 2026, we are in the process of migrating a number of virtual servers to the new virtualization platform. In a very small number of cases, issues occur that prevent an automatic migration as intended. This article is relevant to you if Support has explicitly contacted you to inform you that your server is affected by the issue described here and that solutions need to be implemented.
Before the migration
- As part of the migration, it is necessary for the virtualization platform to be able to apply network settings and other control options, such as password changes. For this, it is required that the QEMU Guest Agent is installed and properly accessible.
If necessary, please reinstall it as described here:
Installing the QEMU Guest Agent
Linux
- Install the QEMU Guest Agent using your distribution's package manager:
- Red Hat-based (AlmaLinux, CentOS, RHEL):
yum install qemu-guest-agent - Debian-based (Debian, Ubuntu):
apt install qemu-guest-agent
- Red Hat-based (AlmaLinux, CentOS, RHEL):
- Ensure that
BLACKLIST_RPC=is empty in the configuration file:- Red Hat-based:
/etc/sysconfig/qemu-ga - Debian-based:
/etc/default/qemu-ga
- Red Hat-based:
- Enable the
qemu-guest-agentservice so that it starts automatically at boot:
systemctl enable qemu-guest-agent - Start the
qemu-guest-agentservice:
systemctl start qemu-guest-agent
Windows
- Download the latest VirtIO drivers ISO to the VM:
- Open the VirtIO drivers download page
- Select stable-virtio
- Download virtio-win.iso
Recommended VirtIO driver versions:
- Windows Server 2016 and newer:
Latest stable version
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/ - Windows Server 2012/2012 R2 (EOL):
0.1.248-1
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/virtio-win-0.1.248-1/
- Mount the ISO file by double-clicking it in File Explorer.
- Run
virtio-win-gt-x64.exe, located in the root directory of the mounted ISO. - Complete the installation wizard using the default settings.
- Run the QEMU Guest Agent installer, located in the
guest-agentsubdirectory of the mounted ISO.
- Install the QEMU Guest Agent using your distribution's package manager:
- Ensure that the system is up to date and that the available updates have been installed. Systems affected by this issue are often running very old software versions that are no longer supported. If this is the case for your system, you should consider moving to a newer server with an operating system that is still provided with security updates by the distributor. Such a change is described here and can also be initiated by Support in coordination with you.
- If you have made any unusual manual changes to the network settings yourself, please check whether these can be reverted to the default configuration.
- Make sure that you know the current root or administrator password and change it if necessary, as after the migration this may no longer be possible without additional effort.
- Back up your data, ideally externally as well, since after the migration you will no longer have access to our automatic backups on the old platform.
After the migration
If these changes were not made before the migration, it is likely that the system will no longer be reachable over the network, as the necessary settings cannot be applied. In this case, manual intervention via the repair console is required. If in doubt, please contact Support with a request via KIS so that the necessary changes can be made. Please include the relevant root or administrator password.