GPU-Treiber aktualisieren: November 2026

Diese Anleitung führt Sie durch das November-2026-Upgrade einer bestehenden GPU-VM am Campus im A-Gebäude. Sie benötigen SSH-Zugang und sudo-Rechte. Ihre Daten, Anwendungen und CUDA-Umgebungen bleiben bestehen.

Wartungsfreigabe abwarten

Beginnen Sie erst, wenn die Cloud-Administration Ihre VM nach der Host-Wartung freigegeben hat. Bis zum Abschluss des Treiberwechsels kann die GPU vorübergehend nicht nutzbar sein.

1. VM öffnen und Arbeiten beenden

  1. Melden Sie sich im Self-Service-Portal am Campus an und öffnen Sie Compute → Instances.
  2. Klicken Sie auf den Namen Ihrer GPU-VM. Notieren Sie die IP-Adresse und verbinden Sie sich wie gewohnt per SSH.
  3. Beenden Sie GPU-Anwendungen, Trainingsläufe und GPU-Container. Sichern Sie wichtige Daten nach Ihrem Backup-Konzept.

Führen Sie alle folgenden Befehle im Terminal Ihrer VM aus. Lassen Sie einen bisher festgelegten Kernel für den Treiberwechsel zunächst unverändert.

2. Installation vorbereiten

Installieren Sie die benötigten Werkzeuge und sichern Sie die vorhandene Lizenzkonfiguration:

sudo apt-get update
sudo apt-get install build-essential dkms "linux-headers-$(uname -r)" curl
sudo cp -a /etc/nvidia "/root/nvidia-vor-upgrade-$(date +%Y%m%d-%H%M%S)"

Die Anleitung gilt für Ubuntu-VMs mit dem bisherigen SPARCI-Treiber. Falls Sie den Treiber selbst über Ubuntu-Pakete installiert haben, stimmen Sie den Wechsel vorher im Supportkanal ab.

3. Neuen Treiber herunterladen

Die folgenden Befehle laden den bereitgestellten Gasttreiber direkt in Ihre VM und prüfen die Datei:

cd ~
curl -fL 'https://cloud.uni-koblenz.de/s/Bjzkx45FqGtRSzQ/download' \
  -o nvidia-vgpu.run
printf '%s  %s\n' \
  '6513b2bd6431b502ce686c6f546b1947b7577107a6132cebb80fb08a9540263f' \
  nvidia-vgpu.run | sha256sum --check

Fahren Sie nur fort, wenn nvidia-vgpu.run: OK erscheint.

4. Treiber installieren

Stoppen Sie die NVIDIA-Dienste und starten Sie den Installer:

sudo systemctl stop nvidia-gridd
if systemctl cat nvidia-persistenced.service >/dev/null 2>&1; then
    sudo systemctl stop nvidia-persistenced
fi
sudo sh ./nvidia-vgpu.run \
  --dkms \
  --kernel-module-type=proprietary \
  --no-opengl-files \
  --no-install-compat32-libs

Bestätigen Sie die Aktualisierung im Installer. Nach erfolgreichem Abschluss aktivieren Sie den Lizenzdienst für den nächsten Start und prüfen den Modulbau:

sudo systemctl add-wants multi-user.target nvidia-gridd.service
dkms status

Beim NVIDIA-Eintrag muss installed für den Kernel des nächsten VM-Starts stehen. Bei einer Fehlermeldung oder fehlendem Modul starten Sie noch nicht neu; beachten Sie Hilfe bei Problemen.

5. VM neu starten

sudo update-initramfs -u -k all
sudo reboot

Die SSH-Verbindung wird getrennt. Warten Sie kurz und verbinden Sie sich erneut.

6. GPU prüfen und Anwendung testen

nvidia-smi
nvidia-smi -q | grep -A 3 'vGPU Software Licensed Product'

Die GPU muss mit dem zugewiesenen Speicher erscheinen. Der Lizenzstatus soll nach einigen Minuten Licensed (Expiry: …) anzeigen; Unlicensed (Unrestricted) genügt nicht.

Starten Sie anschließend einen kurzen Test mit Ihrer bisherigen GPU-Anwendung. Geben Sie im Supportkanal mit Ihrem VM-Namen kurz Rückmeldung, ob alles funktioniert.

Hilfe bei Problemen

  • Installer meldet „module in use“: Beenden Sie noch laufende GPU-Prozesse oder Container. Mit sudo fuser -v /dev/nvidia* können Sie die Prozesse ermitteln.
  • Modulbau schlägt fehl: Prüfen Sie /var/log/nvidia-installer.log und die passenden Kernel-Header. Starten Sie erst mit erfolgreich gebautem Modul neu.
  • GPU fehlt oder VM startet nicht: Melden Sie VM-Name und Fehlermeldung im Supportkanal, damit die Administration die Zuweisung und Platzierung prüfen kann.
GPU wird erkannt, bleibt aber ohne Lizenz

Die vorhandene Lizenzkonfiguration und der Token können weiterverwendet werden. Falls /etc/nvidia/gridd.conf fehlt, stellen Sie die Datei aus der Sicherung aus Schritt 2 wieder her. Für Compute-vGPUs muss darin FeatureType=4 gesetzt sein.

Prüfen Sie die Token-Dateirechte und starten Sie den Lizenzdienst neu:

sudo find /etc/nvidia/ClientConfigToken -maxdepth 1 -type f -name '*.tok' -exec chmod 744 {} \;
sudo systemctl restart nvidia-gridd

Wenn der Token fehlt oder die Lizenz weiterhin nicht bezogen wird, fragen Sie im Supportkanal nach dem aktuellen Token. Teilen Sie die Token-Datei selbst nicht im Kanal.

Bei anhaltenden Problemen nennen Sie im Supportkanal VM-Name, Zeitpunkt und fehlgeschlagenen Schritt sowie die Ausgaben von uname -r, dkms status und nvidia-smi.