Nach einem Neustart meldet Ubuntu Failed to start redis-server.service - Advanced key-value store. Die Meldung allein erklärt die Ursache nicht: Ein Portkonflikt, eine ungültige Konfiguration oder ein nicht beschreibbares Datenverzeichnis können zum gleichen Ergebnis führen. Statt Redis blind neu zu installieren, liest du zuerst die konkrete Fehlermeldung aus dem systemd-Journal.
Betriebsart feststellen
Diese Anleitung gilt für eine systemd-verwaltete Redis-Installation auf Linux, etwa über Ubuntu-Pakete. Bei Redis in Docker musst du dagegen Containerlogs und die Compose-Konfiguration prüfen. Führe die Befehle mit einem Konto aus, das sudo verwenden darf.
Dienststatus auslesen
sudo systemctl status redis-server --no-pager -l
sudo journalctl -u redis-server -b -n 100 --no-pager
Beispielausgabe (frei erfunden, nicht selbst getestet):
redis-server.service: Main process exited, code=exited, status=1/FAILURE
redis-server.service: Failed with result 'exit-code'.
Diese allgemeinen Zeilen sind noch keine Diagnose. Suche im Journal unmittelbar davor nach konkreten Redis-Meldungen wie einem nicht lesbaren Pfad, einem Syntaxfehler oder einer bereits verwendeten Adresse. Die offizielle Redis-Dokumentation findest du unter Redis Management.
Konfiguration prüfen
Unter Ubuntu-Paketinstallationen liegt die Konfiguration häufig unter /etc/redis/redis.conf. Prüfe zunächst, ob sie existiert und ob du Änderungen rückgängig machen kannst. Sichere die Datei, bevor du sie bearbeitest.
sudo test -f /etc/redis/redis.conf && echo 'Konfiguration vorhanden'
sudo cp -a /etc/redis/redis.conf /etc/redis/redis.conf.bak
Öffne die Datei nur, wenn das Journal tatsächlich auf ein Konfigurationsproblem deutet. Kontrolliere insbesondere bind, port, dir und Logpfade. Ändere keine Sicherheitseinstellungen pauschal, um den Start zu erzwingen.
Portkonflikt erkennen
sudo ss -ltnp | grep ':6379' || true
Wenn ein anderer Prozess Port 6379 belegt, identifiziere ihn anhand der Prozessinformationen. Beende ihn nicht blind: Es könnte eine absichtlich gestartete Redis-Instanz sein. Der Port kann zudem bewusst anders konfiguriert sein. In diesem Fall musst du den tatsächlichen Wert aus der Konfiguration verwenden.
Dateirechte kontrollieren
Wenn das Journal Permission denied oder einen Fehler beim Schreiben von RDB/AOF-Dateien nennt, prüfe den betroffenen Pfad. Die folgenden Befehle sind rein lesend.
sudo systemctl cat redis-server
sudo ls -ld /var/lib/redis /var/log/redis
sudo df -h
sudo df -i
Ein voller Datenträger oder fehlende Inodes können ebenfalls Schreibvorgänge verhindern. Ändere Eigentümer und Berechtigungen nur für den tatsächlich betroffenen Pfad und erst nachdem du den vorgesehenen Dienstbenutzer festgestellt hast. chmod 777 ist keine Lösung.
Speicher und OOM prüfen
sudo journalctl -k -b --no-pager | grep -i -E 'out of memory|oom|killed process' | tail -30
free -h
Wenn der Kernel Redis wegen Speichermangels beendet hat, ist die Speicherbelegung der Ausgangspunkt. Kontrolliere gleichzeitig andere Dienste und mögliche Redis-Speicherlimits. Eine pauschale Erhöhung des Limits kann das Problem lediglich verschieben.
Dienst erneut starten
Erst nachdem du die im Journal belegte Ursache behoben hast, startest du Redis neu und überprüfst die Antwort. Der Test mit redis-cli setzt voraus, dass das Programm installiert ist und Redis lokal ohne zusätzliche Authentifizierung erreichbar sein darf.
sudo systemctl restart redis-server
sudo systemctl is-active redis-server
redis-cli ping
Beispielausgabe (nicht selbst getestet):
active
PONG
active und PONG sind ein gutes Zeichen, ersetzen aber keinen Funktionstest deiner abhängigen Anwendung. Bei Authentifizierung oder Unix-Socket-Konfiguration kann der Ping anders aussehen. Veröffentliche niemals Redis-Passwörter aus Konfigurationsdateien oder Logs.
Wenn Redis weiter ausfällt
Vergleiche die letzten Journalmeldungen mit dem Zeitpunkt des Neustarts. Prüfe auch, ob ein Paketupdate oder eine Änderung an systemd-Overrides vorausging. Die Redis-Konfiguration sollte nicht ohne Absicherung an öffentliche Interfaces gebunden werden; Redis ist normalerweise ein interner Dienst. Dokumentiere die konkrete Ursache und sichere vor größeren Reparaturen sowohl die Konfiguration als auch vorhandene persistente Daten.

Schreiben Sie einen Kommentar