Zum Inhalt

Rescue Mode

Übersicht

Der „Rescue Mode“ startet ein minimal konfiguriertes JupyterLab‑Image, das ein temporäres Home‑Verzeichnis (/rescue‑home) verwendet. Das ursprüngliche Home‑Verzeichnis wird unter

/rescue‑home/original‑home

eingebunden, sodass Sie dort lesen‑ und schreiben‑können, ohne die reguläre Umgebung zu starten.

Wann ist der Rescue‑Mode sinnvoll?

Der Rescue Mode kann helfen, wenn JupyterLab nicht startet, zum Beispiel aufgrund von:

  • vollem Home-Verzeichnis.
  • versehentlich installierten defekten Paketen (z. B. in .local).
  • bearbeiteten oder fehlerhaften Shell-Konfigurationsdateien (z. B. .bashrc).
  • einer defekten Benutzerumgebung durch inkompatible Erweiterungen oder Software.

Der Rescue Mode kann genutzt werden, um Dateien im ursprünglichen Home-Verzeichnis zu löschen oder zu reparieren, ohne eine reguläre JupyterLab-Umgebung zu starten.

Was passiert im Rescue Mode?

Beim Start des Rescue Mode

  • wird ein temporäres, sauberes Home-Verzeichnis (/rescue-home) erstellt,
  • wird das ursprüngliche Home-Verzeichnis unter /rescue-home/original-home eingebunden,
  • wird eine JupyterLab-Session mit einer minimalen Umgebung ohne Erweiterungen oder Benutzereinstellungen gestartet.

Dadurch können Dateien im ursprünglichen Home-Verzeichnis sicher angesehen, geändert oder gelöscht werden.

Typische Anwendungsfälle

  • Bereinigung des Home-Verzeichnisses.
  • Löschen defekter Dateien/Ordner.
  • Entfernen oder Umbenennen von Paketen im Verzeichnis ~/.local/lib/pythonX.Y/site‑packages.
  • Zurücksetzen von .bashrc, .profile oder dem gesamten .jupyter‑Verzeichnis.
  • Kopieren wichtiger Daten aus dem Original‑Home in einen gesicherten Ordner innerhalb von /rescue‑home.

Vorgehensweise zur Reparatur einer defekten Umgebung

  1. Log‑Viewer prüfen – Nachdem Sie auf der Spawn-Seite auf „Start“ geklickt haben, um den Server zu starten, öffnen Sie den Link „Logs“ auf der folgenden Seite und suchen Sie nach Fehlermeldungen. (z. B. Hinweis auf ein Paket im Home‑Verzeichnis). Die JupyterLab-Umgebung soll ihre eigenen Pakete ausschließlich aus dem Image beziehen; Pakete im Home‑Verzeichnis können hier stören.
  2. Server stoppen (Falls das Server läuft) – Im Hub‑Menü klicken Sie auf Home > Stop My Server.
  3. Rescue Mode starten – Im Hub‑Menü klicken Sie auf Home > Start My Server. Wählen Sie „Rescue Mode“ aus und klicken Sie auf „Start“.
  4. Original‑Home öffnen – Öffnen Sie im Dateibrowser auf der linken Seite den Ordner original-home/.
  5. Problematische Dateien entfernen/umbenennen – Diese Dateien können aufgrund der Installation inkompatibler Pakete in der Benutzerumgebung (Home-Verzeichnis) zu Problemen führen. Zum Beispiel: 
    rm -rf ~/original-home/.local/lib/python3.12/site-packages/defektes_paket
    Ein typisches Beispiel ist ein im Home‑Verzeichnis installiertes jupyterlab‑Paket – das ist fast immer falsch und muss entfernt werden (ggf. alle mit jupyterlab beginnenden Dateien/Ordner). Achten Sie dabei auf die korrekte Python‑Version, die in der JupyterLab‑Umgebung installiert ist. Gelegentlich ist es nötig, den gesamten Inhalt von site‑packages zu löschen, um eine saubere Umgebung zu erhalten.
  6. Wenn das Problem weiterhin besteht, sichern Sie die Datei .bashrc oder den Ordner .jupyter. Zum Beispiel: 
    mv original-home/.bashrc original-home/.bashrc.bak
    Hinweis: Um versteckte Dateien im Dateibrowser anzuzeigen, aktivieren Sie im Menü View > Show Hidden Files.
  7. Server neu starten – Im Hub‑Menü: File > Hub Control Panel > Stop My Server wählen, danach Start My Server.