Rescue Mode

JupyterHub Rescue mode dokumentation¶

Übersicht¶

Das Rescue mode Image ist ein speziell für den Zweck entworfenes Container-Image, das Benutzern hilft, sich von beschädigten Umgebungen zu erholen, die verhindern, dass ihre Standard-JupyterLab-Sitzungen korrekt starten.

Dieses Image startet eine minimale JupyterLab-Umgebung mit einem temporären, sauberen $HOME-Verzeichnis (/rescue-home) und bietet Lese-/Schreibzugriff auf das ursprüngliche Home-Verzeichnis über einen montierten Pfad (/rescue-home/original-home).

Wann sollte man das Rescue mode Image verwenden?¶

Verwende das Rescue mode Image, wenn:

• JupyterLab fällt aus aufgrund von:
• Du hast versehentlich ein beschädigtes Paket installiert (z. B. in .local)
• Du hast Shell-Konfigurationsdateien bearbeitet oder beschädigt (z. B. .bashrc)
• Deine Benutzerumgebung ist beschädigt aufgrund von unvereinbaren Erweiterungen oder Software
• Du möchtest sicher Dateien in deinem ursprünglichen Home löschen oder reparieren, ohne eine vollständige JupyterLab-Sitzung zu stören.

Was macht das rescue mode-Image?¶

• Erstellt ein temporäres, sauberes $HOME bei /rescue-home
• Montiert dein ursprüngliches Home-Verzeichnis an /rescue-home/original-home
• Startet eine minimale JupyterLab-Sitzung (keine Erweiterungen oder Benutzereinstellungen geladen)
• Lässt dich sicher Dateien in deinem echten Home anzeigen, ändern oder löschen

Was du im Rescue mode Image machen kannst¶

• Beschädigte Dateien anzeigen und löschen
• Korrupte Pakete in .local/ entfernen oder umbenennen
• .bashrc, .profile oder .jupyter-Ordner zurücksetzen oder verschieben
• Überprüfen, was sich in deinem ursprünglichen Home-Verzeichnis befindet
• Dateien von deinem ursprünglichen Home in den rettungssicheren Raum kopieren

Wie man eine beschädigte Umgebung repariert¶

1. Starte das Rescue mode Image aus der Imageauswahl.
2. Navigiere zu original-home/.
3. Identifiziere und behebe/entferne problematische Inhalte:
4. z. B. rm -rf ~/original-home/.local/lib/python3.12/site-packages/broken_package. Ein broken package könnte z. B. jupyterlab sein und du musst möglicherweise alle Dateien und Ordner entfernen, die mit jupyterlab beginnen. Achte auch auf die Python-Version und ersetze sie durch die Version, die bereits in der JupyterLab-Umgebung installiert ist. Manchmal musst du alles unter site-packages entfernen, damit deine Umgebung sauber wird.
5. z. B. mv original-home/.bashrc original-home/.bashrc.bak
6. Melde dich ab und starte dein reguläres JupyterLab-Image neu.

Hinweis: Wenn du die versteckten Dateien im Browser sehen möchtest, kannst du dies über das Menü aktivieren: view/Show Hidden Files