# Beispiel-Lösung: Runbook «Speicherplatz auf web01 knapp oder voll»

*KI-Universum, Welt 12, Mission «Runbook-Generator». Fiktiver Server web01 (Linux, nginx, PHP-Anwendung unter /var/www/app). Entstanden aus `stoerungsnotizen.txt`. Befehle sind Beispiele für ein typisches Linux-System – Pfade und Dienstnamen auf echten Systemen vorher prüfen.*

**Version 1.0 · Verantwortlich: Informatikdienst (Rolle) · Getestet im Blindflug: offen**

## Zweck und Auslöser

- Monitoring meldet «Speicher / über 85 %» (Warnung) oder «über 95 %» (dringend).
- Website zeigt Fehler 500, Uploads scheitern, Meldung «No space left on device».

## Voraussetzungen

- SSH-Zugang mit persönlichem Schlüssel und sudo-Recht (Zugangsdaten stehen im Passwortmanager des Informatikdienstes, **nicht** hier).
- Bei «dringend»: Schulleitung bzw. Sekretariat kurz informieren («Website gestört, wir sind dran»).

## Sicherung vor Änderungen

Nichts löschen, bevor klar ist, was es ist. Ist der Datenträger voll, scheitert jede Sicherung auf denselben Datenträger – darum grosse Logdateien zuerst auf einen **anderen** Datenträger oder ins Archiv sichern, wenn sie noch gebraucht werden könnten (Fehlersuche, Sicherheitsvorfälle).

## Schritte

| Nr. | Tätigkeit | Art | Prüfpunkt | Wenn nicht … |
|---|---|---|---|---|
| 1 | `df -h` – welcher Datenträger ist voll? | nur lesen | Zeile mit hoher Belegung gefunden | Monitoring-Meldung mit Datenträger vergleichen |
| 2 | `sudo du -xh /var --max-depth=2 \| sort -h \| tail -15` – wer frisst den Platz? | nur lesen | Grösster Ordner bekannt | Mit dem nächsten Ordner (z. B. `/home`) wiederholen |
| 3 | `sudo lsof +L1` – gibt es gelöschte Dateien, die ein Dienst noch offen hält? | nur lesen | Liste leer oder Dienst bekannt | Dienst notieren, in Schritt 6 berücksichtigen |
| 4 | Ursache benennen, z. B. `/var/www/app/storage/logs/debug.log` sehr gross, Log-Stufe steht auf «debug» | nur lesen | Ursache im Ticket notiert | Eskalation |
| 5 | **Mit Freigabe:** Datei auf einen **anderen** Datenträger mit genug freiem Platz sichern (vorher `df -h /pfad/zum/archiv` prüfen), ohne Bestehendes zu überschreiben: `sudo cp -n debug.log /pfad/zum/archiv/debug-DATUM.log`, danach `sudo gzip /pfad/zum/archiv/debug-DATUM.log` (`cp -n` überschreibt keine vorhandene Datei, `gzip` überschreibt eine vorhandene .gz-Datei nicht ohne Rückfrage) | verändert | Archivdatei vorhanden, Grösse plausibel | Kein Archivziel mit freiem Platz: Rücksprache, ob die Datei verzichtbar ist |
| 6 | **Mit Freigabe:** offene Logdatei leeren statt löschen: `sudo truncate -s 0 debug.log` (der Dienst schreibt weiter, der Platz wird sofort frei) | verändert | `df -h` zeigt wieder Platz | Bei gelöschten, aber offenen Dateien (Schritt 3): betroffenen Dienst neu laden bzw. neu starten |
| 7 | **Mit Freigabe:** Log-Stufe der Anwendung zurück auf «warning» (Konfiguration vorher kopieren) | verändert | Datei wächst nicht mehr spürbar (nach 10 Min. `ls -lh` vergleichen) | Konfigurationskopie zurückspielen |
| 8 | Website und Upload testen | nur lesen | Startseite und Test-Upload klappen | Eskalation |

## Rückfallplan

- Konfigurationsänderung (Schritt 7): gesicherte Kopie zurückspielen, Dienst neu laden.
- Gelöschte oder geleerte Logs lassen sich nur aus dem Archiv (Schritt 5) oder einer Sicherung zurückholen – darum Schritt 5 nie überspringen, wenn die Logs noch gebraucht werden könnten.

## Eskalation

- Schritt 4 findet keine klare Ursache oder Schritt 6 schafft keinen Platz: Leitung Informatikdienst.
- Hinweise auf einen Sicherheitsvorfall (unbekannte Dateien, fremde Prozesse): nichts löschen, Vorfallprozess der Schule auslösen.

## Abschluss

- Kurzmeldung an die Schulleitung (Was, wie lange, wer betroffen, was dauerhaft ändert).
- Ticket für die dauerhafte Behebung: Logrotation für die Anwendung einrichten, Monitoring-Warnungen an eine gelesene Adresse senden, Log-Stufe nach Updates prüfen.

## Was aus den Störungsnotizen bewusst NICHT übernommen wurde

1. `rm -rf /var/log/nginx/*` – löscht Beweise, und solange nginx die Dateien offen hält, wird kein Platz frei. Ersetzt durch Schritt 3 und Schritt 6.
2. Das Admin-Passwort im Klartext – gehört nie in Notizen oder Runbooks. **Sofortmassnahme:** Passwort ändern lassen, da es in einem Chat stand.
3. «Erst Kaffee» statt Information der Schulleitung – ersetzt durch klare Informationspflicht bei «dringend».
4. Die eigentliche Ursache «Monitoring-Warnungen gehen an eine Adresse, die niemand liest» – das ist kein Runbook-Schritt, sondern ein Ticket. Ohne dieses Ticket kommt die Störung wieder.
