Fehler und Abbrüche
Verhalten bei fehlgeschlagenen oder unterbrochenen RAUC-Updates.
Fehler vor dem Neustart
Wird das Bundle abgelehnt, bleiben die bisherige Systemversion und der aktive Slot unverändert. Die konkrete Fehlermeldung hängt unter anderem von der RAUC-Version, dem Bundle-Format, dem Dateisystem und dem Bootloader ab. Die folgenden Fehlerklassen decken die wichtigsten Fälle ab:
| Fehlerklasse | Typische Ursache | Maßnahme |
|---|---|---|
| Bundle nicht gefunden oder nicht lesbar | Falscher Pfad, USB nicht eingehängt oder fehlende Berechtigung | Pfad, USB-Einbindung und Zugriffsrechte prüfen |
| Signatur ungültig oder unbekannt | Bundle beschädigt oder Zertifikat nicht im Keyring | Freigegebenes Bundle und passenden Keyring verwenden |
| Bundle nicht kompatibel | Bundle gehört zu einem anderen Gerät oder Produkttyp | Passendes qdGate-Bundle verwenden |
| Version nicht zulässig | Bundle-Version oder Update-Reihenfolge nicht freigegeben | Freigegebene Update-Reihenfolge beachten |
| Bundle kann nicht gemountet oder verifiziert werden | Beschädigter Datenträger oder beschädigtes Bundle | Bundle erneut übertragen und Speicher prüfen |
| Kein passender Ziel-Slot verfügbar | Bundle und Slot-Konfiguration passen nicht zusammen | Passendes Bundle verwenden und Diagnoseausgabe sichern |
| Ziel-Slot kann nicht beschrieben werden | Kein Speicherplatz, Schreibfehler oder Hardwareproblem | Speicherplatz, Versorgung und RAUC-Status prüfen |
| Bootloader-Slot kann nicht aktualisiert werden | Fehler beim Zugriff auf die Bootloader-Konfiguration | Update nicht wiederholen und Diagnoseausgabe sichern |
Sichere bei einem Fehler die vollständige RAUC-Ausgabe. Für eine ausführlichere Diagnose können folgende Befehle verwendet werden:
rauc status --detailed
rauc install --debug [BUNDLE-PFAD]Weitere Hinweise zur Diagnose enthält die offizielle RAUC-Dokumentation.
Abbruch während des Updates
Ein Update darf nicht durch Ausschalten oder Trennen der Versorgung unterbrochen werden. Das System soll nach einem fehlgeschlagenen Update in den zuletzt funktionsfähigen Zustand zurückkehren.
Fehler bei der Updatebestätigung
Wenn rauc status mark-good fehlschlägt, liegt möglicherweise ein Fehler in der Bootloader- oder
Slot-Konfiguration vor. Führe in diesem Fall rauc status --detailed aus und sichere die vollständige
Ausgabe. Starte das System nicht wiederholt neu, bevor der Fehler untersucht wurde.