Die Installation eines Serversystems kann eine aufregende, aber manchmal auch frustrierende Erfahrung sein. Besonders, wenn man ein leistungsstarkes und zuverlässiges Speicherverwaltungssystem wie TrueNAS Core (oder die neuere Version TrueNAS SCALE) auf einer Virtualisierungsplattform wie Proxmox VE einrichten möchte. Alles läuft reibungslos, bis plötzlich eine unerwartete Fehlermeldung auftaucht: „Invalid Checksum„. Ein kleiner Satz, der jedoch große Kopfschmerzen bereiten kann.
Dieser Fehler ist nicht nur ärgerlich, sondern er verhindert auch, dass Sie Ihr TrueNAS-System überhaupt installieren können. Er tritt oft dann auf, wenn Sie die TrueNAS-ISO-Datei als virtuelle CD/DVD in Ihre Proxmox-VM einbinden. Doch keine Sorge, Sie sind nicht allein mit diesem Problem, und es gibt eine bewährte Lösung, die über das bloße erneute Herunterladen der ISO hinausgeht. In diesem umfassenden Leitfaden werden wir genau erklären, warum dieser Fehler auftritt und Ihnen eine detaillierte, Schritt-für-Schritt-Anleitung an die Hand geben, wie Sie ihn ein für alle Mal beheben können.
Was bedeutet „Invalid Checksum” und warum ist er so wichtig?
Eine Prüfsumme (Checksum) ist ein kleiner Wert, der aus einer größeren Datenmenge (in unserem Fall der TrueNAS-Installationsdatei) berechnet wird. Sie dient als eine Art digitaler Fingerabdruck. Wenn Sie eine Datei herunterladen oder kopieren, wird deren Prüfsumme berechnet. Anschließend wird dieser Wert mit einer bekannten, korrekten Prüfsumme (die der Softwareanbieter, z. B. TrueNAS, zur Verfügung stellt) verglichen. Stimmen beide Werte überein, ist die Datei intakt und unverändert.
Der Fehler „Invalid Checksum” bedeutet also, dass die Prüfsumme Ihrer heruntergeladenen oder auf Ihrem Medium befindlichen TrueNAS-ISO-Datei nicht mit der erwarteten Prüfsumme übereinstimmt. Kurz gesagt: Die Datei ist beschädigt oder unvollständig. Das ist kritisch, denn eine beschädigte Installationsdatei kann zu einer fehlerhaften oder instabilen Installation führen.
Typische Ursachen für eine ungültige Prüfsumme
Bevor wir zur spezifischen Proxmox-Lösung kommen, ist es wichtig, die allgemeinen Ursachen für diesen Fehler zu verstehen:
- Fehler beim Herunterladen: Netzwerkprobleme, Verbindungsabbrüche oder Serverprobleme können dazu führen, dass die ISO-Datei unvollständig oder beschädigt heruntergeladen wird.
- Fehlerhafte Speichermedien: Ein defekter USB-Stick, eine fehlerhafte Festplatte oder SSD kann die Integrität der gespeicherten ISO-Datei beeinträchtigen.
- Fehler bei der Datenübertragung: Auch beim Kopieren der ISO von einem Ort zum anderen können Fehler auftreten.
- Softwarefehler: Selten, aber möglich, dass das Tool, das die ISO bereitstellt oder einbindet, einen Fehler verursacht.
Warum tritt der „Invalid Checksum”-Fehler oft speziell bei TrueNAS auf Proxmox auf?
Viele Nutzer entscheiden sich dafür, TrueNAS als virtuelle Maschine (VM) unter Proxmox VE zu betreiben. Dies ist eine hervorragende Möglichkeit, Hardware zu konsolidieren und die Vorteile beider Systeme zu nutzen. Allerdings bringt diese Konfiguration spezifische Herausforderungen mit sich:
- ISO-Bereitstellung: Die TrueNAS-ISO-Datei muss entweder auf den Proxmox-Host heruntergeladen und dann über die Proxmox-Weboberfläche als ISO-Image hinzugefügt werden, oder sie wird direkt in die VM-Hardware eingebunden.
- Virtuelles CD/DVD-Laufwerk: Proxmox emuliert ein virtuelles CD/DVD-Laufwerk, über das die ISO-Datei der VM präsentiert wird. Manchmal kann die Art und Weise, wie diese Emulation erfolgt, oder wie TrueNAS mit dieser Emulation interagiert, zu Problemen führen, die sich als „Invalid Checksum” manifestieren – selbst wenn die ISO-Datei selbst intakt ist. TrueNAS scheint in dieser Hinsicht empfindlicher zu sein als andere Betriebssysteme.
- Interne Proxmox-Speicherung: Die Art und Weise, wie Proxmox die ISO-Datei intern speichert und dann der VM zur Verfügung stellt, kann unter bestimmten Umständen zu subtilen Datenkorruptionen oder Lesezugriffsfehlern führen, die von TrueNAS als Checksummenfehler interpretiert werden.
Erste Schritte zur Fehlerbehebung (Oft notwendig, aber nicht immer ausreichend für Proxmox/TrueNAS)
Bevor wir zur eigentlichen Proxmox-spezifischen Lösung kommen, sollten Sie diese grundlegenden Schritte überprüfen:
- ISO erneut herunterladen: Löschen Sie die vorhandene ISO-Datei und laden Sie sie erneut von der offiziellen TrueNAS-Website herunter. Verwenden Sie möglichst eine kabelgebundene Verbindung, um Netzwerkprobleme zu minimieren.
- Prüfsumme der heruntergeladenen ISO verifizieren: Dies ist ein absolutes Muss! Die TrueNAS-Website stellt immer die offiziellen SHA256- oder MD5-Prüfsummen zur Verfügung. Vergleichen Sie diese mit Ihrer heruntergeladenen Datei.
- Unter Linux (und damit auch auf Ihrem Proxmox-Host über SSH): Öffnen Sie ein Terminal und navigieren Sie zum Speicherort der ISO. Führen Sie dann `sha256sum TrueNAS-*.iso` aus (ersetzen Sie `TrueNAS-*.iso` durch den tatsächlichen Dateinamen).
- Unter Windows: Öffnen Sie PowerShell und verwenden Sie `Get-FileHash -Algorithm SHA256 „C:PfadzurTrueNAS.iso”`.
Stimmen die berechneten Prüfsummen nicht mit den auf der TrueNAS-Website angegebenen überein, ist die Datei definitiv beschädigt, und Sie müssen sie erneut herunterladen.
- Anderen Browser/Download-Manager nutzen: Manchmal können Browser-Erweiterungen oder Download-Manager Probleme verursachen.
- Anderen Download-Server probieren: Falls verfügbar, versuchen Sie einen alternativen Download-Spiegelserver.
Haben Sie alle diese Schritte durchgeführt und die Prüfsumme der ISO auf Ihrem Proxmox-Host (oder dem System, von dem aus Sie die ISO hochladen) ist korrekt, aber Sie erhalten immer noch den „Invalid Checksum”-Fehler während der TrueNAS-Installation in der VM? Dann ist es Zeit für die Proxmox-spezifische Lösung!
Die Proxmox-spezifische Lösung: ISO als virtuelle Festplatte booten!
Der Kern des Problems liegt oft nicht in der ISO-Datei selbst, sondern in der Art und Weise, wie das virtuelle CD/DVD-Laufwerk der Proxmox-VM die Daten an den TrueNAS-Installer übergibt. Die Lösung besteht darin, die ISO-Datei nicht als optisches Medium, sondern als eine virtuelle Festplatte zu präsentieren, von der die VM booten kann. Dies umgeht die potenziellen Probleme mit der CD/DVD-Emulation.
Hier ist die detaillierte Schritt-für-Schritt-Anleitung:
Schritt 1: TrueNAS ISO direkt auf den Proxmox-Host herunterladen und verifizieren
Melden Sie sich per SSH auf Ihrem Proxmox-Host an. Navigieren Sie zu einem geeigneten Verzeichnis, z. B. `/var/lib/vz/template/iso/` oder einem anderen Ihrer Storage-Pfade, wo Sie ISOs ablegen.
cd /var/lib/vz/template/iso/
wget https://download.freenas.org/CORE/13.0/RELEASE/TrueNAS-13.0-RELEASE.iso
# Ersetzen Sie die URL durch die aktuelle Version von TrueNAS Core oder SCALE
Nach dem Download ist es extrem wichtig, die Prüfsumme direkt auf dem Proxmox-Host zu verifizieren. Dies stellt sicher, dass die Datei beim Herunterladen auf den Host intakt geblieben ist:
sha256sum TrueNAS-13.0-RELEASE.iso
# Vergleichen Sie den Ausgabe-Hash mit dem auf der TrueNAS-Downloadseite angegebenen.
Stimmt die Prüfsumme hier nicht überein, müssen Sie den Download wiederholen, bis sie passt! Erst dann können Sie mit dem nächsten Schritt fortfahren.
Schritt 2: Eine neue VM für TrueNAS erstellen
Erstellen Sie eine neue virtuelle Maschine in Proxmox. Die Details sind wichtig, da TrueNAS bestimmte Anforderungen hat. Geben Sie der VM eine aussagekräftige ID (z. B. 100) und einen Namen (z. B. TrueNAS-Storage).
- OS-Typ: Wählen Sie „Other” (oder „FreeBSD” falls verfügbar, aber „Other” ist meist sicher).
- CD/DVD: Wählen Sie „Do not use any media”. Wir werden die ISO später auf andere Weise einbinden.
- System: Standardeinstellungen sind meist in Ordnung (Grafikkarte, SCSI Controller, etc.).
- Festplatten: Fügen Sie *keine* Festplatte für das TrueNAS-Betriebssystem hinzu! Wir werden dies später manuell machen, oder Sie können hier eine kleine Festplatte (z.B. 32-64GB) hinzufügen, die *ausschließlich* für die TrueNAS-Installation vorgesehen ist (z.B. auf `local-lvm`). Die eigentlichen Speicherplatten für ZFS werden später per PCI Passthrough übergeben!
- CPU: Geben Sie mindestens 2 Cores an (oder mehr, je nach Bedarf).
- Memory (RAM): TrueNAS liebt RAM! Geben Sie mindestens 8 GB RAM an. Mehr ist besser, insbesondere für ZFS. Deaktivieren Sie „Ballooning Device”.
- Network: Wählen Sie ein Bridged-Netzwerk (z. B. `vmbr0`).
- Confirm: Überprüfen Sie die Einstellungen und erstellen Sie die VM.
Schritt 3: Die TrueNAS ISO in ein virtuelles Festplatten-Image konvertieren
Dies ist der entscheidende Schritt. Wir werden das ISO-Image in ein QCOW2- oder RAW-Festplatten-Image konvertieren. Dies geschieht wieder auf dem Proxmox-Host per SSH.
cd /var/lib/vz/template/iso/ # Oder wo immer Ihre ISO liegt
qemu-img convert -f iso -O qcow2 TrueNAS-13.0-RELEASE.iso TrueNAS-Installer.qcow2
-f iso: Quellformat ist ISO.-O qcow2: Zielformat ist QCOW2 (alternativ könnten Sie `raw` verwenden, QCOW2 ist aber platzsparender).TrueNAS-13.0-RELEASE.iso: Name Ihrer heruntergeladenen ISO-Datei.TrueNAS-Installer.qcow2: Der Name, den wir dem neuen virtuellen Festplatten-Image geben.
Dieser Befehl erstellt eine neue Datei `TrueNAS-Installer.qcow2` im selben Verzeichnis.
Schritt 4: Das konvertierte Image als Festplatte in die VM importieren
Nun importieren wir das `TrueNAS-Installer.qcow2`-Image in Ihre TrueNAS-VM. Ersetzen Sie `VMID` durch die ID Ihrer TrueNAS-VM (z. B. 100) und `local-lvm` durch den Namen Ihres Storage-Pools, auf dem Sie virtuelle Festplatten speichern möchten (z. B. `local`, `vmdata`, etc.).
qm importdisk VMID /var/lib/vz/template/iso/TrueNAS-Installer.qcow2 local-lvm
# Beispiel für VMID 100 und Storage "local-lvm":
# qm importdisk 100 /var/lib/vz/template/iso/TrueNAS-Installer.qcow2 local-lvm
Dieser Befehl legt das `TrueNAS-Installer.qcow2` als „unreferenced disk” (nicht referenzierte Festplatte) in der Konfiguration Ihrer VM ab.
Schritt 5: Die importierte Festplatte zur VM hinzufügen und Boot-Reihenfolge anpassen
Gehen Sie nun zurück zur Proxmox-Weboberfläche:
- Navigieren Sie zu Ihrer TrueNAS-VM (z. B. VM 100).
- Klicken Sie auf den Reiter „Hardware”.
- Sie sollten eine „Unused Disk” sehen (z. B. `unused0:local-lvm:vm-100-disk-1`). Wählen Sie diese aus.
- Klicken Sie auf „Edit” und dann „Add”. Lassen Sie die Standardeinstellungen, es sei denn, Sie haben spezifische Präferenzen (z. B. SCSI oder VirtIO Block).
- Als Nächstes gehen Sie zu „Options” -> „Boot Order” -> „Edit”.
- Stellen Sie sicher, dass die neu hinzugefügte virtuelle Festplatte des Installers (z. B. `scsi0` oder `virtio0`) ganz oben in der Boot-Reihenfolge steht. Speichern Sie die Änderungen.
Schritt 6: TrueNAS-VM starten und installieren
Starten Sie Ihre TrueNAS-VM. Sie sollte nun von der virtuellen Festplatte `TrueNAS-Installer.qcow2` booten, als wäre es eine normale Festplatte mit dem Installationsmedium. Der TrueNAS-Installer sollte ohne den „Invalid Checksum”-Fehler starten!
Folgen Sie den Anweisungen des TrueNAS-Installers. Wählen Sie als Installationsziel die kleine Festplatte aus, die Sie in Schritt 2 für das Betriebssystem erstellt haben (nicht die Passthrough-Platten!).
Schritt 7: Aufräumen nach der Installation
Nachdem TrueNAS erfolgreich installiert wurde und Sie zum Neustart aufgefordert werden:
- Fahren Sie die VM herunter.
- Gehen Sie in der Proxmox-Weboberfläche erneut zu „Hardware” Ihrer TrueNAS-VM.
- Entfernen Sie die virtuelle Festplatte, die Sie in Schritt 5 hinzugefügt haben (die `TrueNAS-Installer.qcow2`-Disk). Wählen Sie sie aus und klicken Sie auf „Detach” und dann „Remove”.
- Gehen Sie zu „Options” -> „Boot Order” -> „Edit”. Stellen Sie sicher, dass die Festplatte, auf der TrueNAS installiert wurde, nun an erster Stelle der Boot-Reihenfolge steht.
- Sie können auch die `TrueNAS-Installer.qcow2`-Datei manuell vom Proxmox-Host löschen, um Speicherplatz freizugeben:
rm /var/lib/vz/template/iso/TrueNAS-Installer.qcow2
Starten Sie die VM erneut. Ihr TrueNAS-System sollte nun direkt von seiner Systemfestplatte booten.
Weitere wichtige Tipps für TrueNAS auf Proxmox
Nachdem die Installation erfolgreich war, gibt es noch einige Best Practices, die Sie für einen stabilen und performanten TrueNAS-Server unter Proxmox beachten sollten:
- PCI Passthrough für Festplatten/HBA: Um die volle Leistung und vor allem die Datenintegrität von ZFS zu gewährleisten, sollten Sie Ihre Festplatten (oder besser noch einen kompletten Host Bus Adapter – HBA) direkt an die TrueNAS-VM durchreichen. Dies wird als PCI Passthrough bezeichnet und ermöglicht TrueNAS den direkten Zugriff auf die Hardware, ohne dass Proxmox als Zwischenschicht fungiert. Ganz wichtig: TrueNAS niemals virtuelle Festplatten über Proxmox zugewiesen bekommen, wenn diese Teil eines ZFS-Pools sein sollen!
- Dedizierter RAM: TrueNAS ist sehr RAM-hungrig, besonders mit ZFS. Weisen Sie der VM einen festen, ausreichend großen RAM-Betrag zu (mindestens 8 GB, besser 16 GB oder mehr für größere Pools) und deaktivieren Sie das Ballooning Device in den VM-Optionen, um Speicherengpässe zu vermeiden.
- Netzwerk: Verwenden Sie eine VirtIO-Netzwerkkarte für optimale Leistung.
- Keine Proxmox-Snapshots: Erstellen Sie niemals Proxmox-VM-Snapshots von einer TrueNAS-VM, die PCI Passthrough für Festplatten verwendet. Dies kann zu Datenkorruption führen. TrueNAS hat seine eigenen, überlegenen Snapshot-Funktionen für ZFS-Pools.
- Regelmäßige Backups: Auch wenn ZFS robust ist, sind regelmäßige Konfigurations-Backups von TrueNAS (und idealerweise der Proxmox-Host-Konfiguration) unerlässlich.
Fazit
Der „Invalid Checksum”-Fehler während der TrueNAS Core/SCALE Installation in einer Proxmox-VM kann frustrierend sein, aber mit dem richtigen Ansatz ist er leicht zu überwinden. Indem Sie die ISO-Datei nicht als traditionelles CD/DVD-Laufwerk, sondern als virtuelle Festplatte präsentieren, umgehen Sie potenzielle Kompatibilitätsprobleme und stellen sicher, dass der TrueNAS-Installer fehlerfrei läuft. Mit dieser Lösung und den zusätzlichen Best Practices für TrueNAS auf Proxmox können Sie ein stabiles, leistungsstarkes und zuverlässiges Speicherverwaltungssystem aufbauen, das Ihnen viele Jahre gute Dienste leisten wird. Viel Erfolg beim Einrichten Ihres TrueNAS-Servers!