Self-Service Restore (SSR) - Dateiwiederherstellung in Nutanix VMs
Die Nutanix Infrastruktur bietet die Möglichkeit, direkt aus dem Betriebsystem heraus als administrativer Benutzer virtuelle Festplatten aus den sogenannten VM Recovery Points an die virtuelle Maschine zu hängen, um daraus einzelne Dateien wiederherstellen zu können. Hierbei ist sowohl der Zugriff auf die selbst erstellten, als auch auf die vom System automatisch erstellten VM Recovery Points möglich. Für die Durchführung ist kein gesonderter Incident an den Servicedesk erforderlich.
Vorgehensweise
Linux
In den LRZ Linux-VMs ist bereits das notwendige Kommandozeilentool ngtcli vorinstalliert. Sämtliche Befehle sind mit root Rechten auszuführen.
Auflisten der vorhandenen VM Recovery Points
ngtcli ssr list-snapshots
Communicating with Nutanix Data Protection Service...
Snapshot Id Disk Labels Logical Drives Create Time
------------ ------------ -------------------- --------------------
180319617 scsi0:0 2026.07.02 02:02 AM
scsi0:1 2026.07.02 02:02 AM
scsi0:2 2026.07.02 02:02 AM
scsi0:3 2026.07.02 02:02 AM
179165234 scsi0:0 2026.07.01 02:01 AM
scsi0:1 2026.07.01 02:01 AM
scsi0:2 2026.07.01 02:01 AM
scsi0:3 2026.07.01 02:01 AM
177579513 scsi0:0 2026.06.30 02:01 AM
scsi0:1 2026.06.30 02:01 AM
scsi0:2 2026.06.30 02:01 AM
scsi0:3 2026.06.30 02:01 AM
175838078 scsi0:0 2026.06.29 02:01 AM
scsi0:1 2026.06.29 02:01 AM
scsi0:2 2026.06.29 02:01 AM
scsi0:3 2026.06.29 02:01 AM
174460821 scsi0:0 2026.06.28 02:01 AM
scsi0:1 2026.06.28 02:01 AM
scsi0:2 2026.06.28 02:01 AM
scsi0:3 2026.06.28 02:01 AM
173267563 scsi0:0 2026.06.27 02:01 AM
scsi0:1 2026.06.27 02:01 AM
scsi0:2 2026.06.27 02:01 AM
scsi0:3 2026.06.27 02:01 AM
In diesem Beispiel gibt es 6 VM Recovery Points. Jede der 4 virtuellen Festplatten (scsi0:0 bis scsi0:3) der Beispiel-VM wurde dabei berücksichtigt.
Identifizieren der Festplatte, von der Dateien wiederhergestellt werden sollen
Zum Identifizieren der richtigen Festplatte bietet sich das Tool lssci an.
lsscsi
[0:0:0:0] disk NUTANIX VDISK 0 /dev/sda [0:0:1:0] disk NUTANIX VDISK 0 /dev/sdb [0:0:2:0] disk NUTANIX VDISK 0 /dev/sdc [0:0:3:0] disk NUTANIX VDISK 0 /dev/sdd [1:0:0:0] cd/dvd QEMU QEMU DVD-ROM 2.5+ /dev/sr0
Hier betrachten wir ausschließlich die Zeilen vom Typ "disk". Die zweite und dritte Ziffer korrespondieren mit der SCSI ID ("Disk Label") der vorigen Ausgabe.
Beispiel: scsi0:2 → [0:0:2:0] → /dev/sdc
Einhängen einer spezifischen Festplatte aus einem VM Recovery Point
ngtcli ssr attach-disk snapshot-id=173267563 disk-label=scsi0:2
Communicating with Nutanix Data Protection service Verifying if the disk is attached Disk attached successfully, bringing it online Hiding system reserved disks, if any ... Disk attached successfully. Snapshot Id Original Disk Label Attached Disk Label Detach Time ------------ -------------------- -------------------- -------------------- 173267563 scsi0:2 () scsi0:4 (/dev/sde) 2026.07.04 12:14 PM
In diesem Beispiel wurde die 3. virtuelle Festplatte scsi0:2 (üblicherweise im System sichtbar als /dev/sdc) des VM Recovery Point vom 27.06.2026 als zusätzliche Festplatte scsi0:4 (/dev/sde) in das System eingehängt.
Bitte unbedingt die "Detach Time" beachten!
Auf diese Weise eingehängte Festplatten werden automatisch nach 1 Tag aus dem System zwangsentfernt. Dies ist auch nicht änderbar!
Daher sollte nach Beendigung des Wiederherstellungsvorgangs die Festplatte zeitnah wieder ausgehängt werden!
Mounten der Recovery Festplatte
mount -o nouuid /dev/sde /mnt/
Essenziell ist hier die Angabe der Mountoption nouuid, da es sich um ein Dateisystem handelt, das ja bereits mit der gleichen UUID in der VM vorhanden ist! Für Recovery Zwecke ist dies jedoch legitim, daher muss dies an dieser Stelle ignoriert werden. Vergisst man die Mountoption, erhält man einen Fehler.
Fehlermeldung bei Vergessen der Mountoption nouuid
mount: /mnt: wrong fs type, bad option, bad superblock on /dev/sde, missing codepage or helper program, or other error. dmesg(1) may have more information after failed mount system call.
Wiederherstellen der gewünschten Dateien
Nun können die entsprechenden Dateien wiederhergestellt werden, indem man sie von der Recovery Festplatte auf eine der "normalen" virtuellen Festplatten kopiert.
Unmittelbar nach Abschluss des Vorgangs sollte man die Recovery Festplatte direkt wieder aushängen.
Unmounten der Recovery Festplatte
umount /mnt
Auflisten der in die VM eingehängten Recovery Festplatten
ngtcli ssr list-attached-disks
Communicating with Nutanix Data Protection Service... Snapshot Id Original Disk Label Attached Disk Label Detach Time ------------ -------------------- -------------------- -------------------- 173267563 scsi0:2 () scsi0:4 (/dev/sde) 2026.07.04 12:14 PM
Aushängen der Recovery Festplatte aus der VM
ngtcli ssr detach-disk attached-disk-label=scsi0:4
Unmounting the disk Communicating with Nutanix Data Protection service Verifying if the disk is detached Disk detached successfully.
Damit ist der Wiederherstellungsvorgang abgeschlossen.