Skip to main content

🧰 Schritt 11: Anhang / Troubleshooting & Systembefehle

💡 Hinweis:
Diese Übersicht fasst nützliche Befehle für Diagnose, Systemanalyse
und Fehlersuche auf deinem EndeavourOS ARM / ioBroker-System zusammen.

⚠️ Achtung:
ioBroker-Befehle dürfen niemals mit sudo ausgeführt werden!
Das ist eine bewährte Sicherheitspraxis, da ioBroker – wenn korrekt installiert – keine Administratorrechte benötigt, um zu funktionieren.

Die Verwendung von sudo sollte auf wirklich notwendige Situationen beschränkt bleiben, z.B. bei der Installation oder bei Linux-Updates, jedoch nicht im regulären täglichen Betrieb.


🧩 1. Systeminformationen

uname -a                # Kernelversion & Architektur
hostnamectl             # Hostname, Kernel, Architektur, OS
uptime -p               # Systemlaufzeit

💾 2. Speicher- & Datenträgerstatus

df -h                   # Übersicht belegter und freier Speicherplatz
lsblk                   # Blockgeräte und Partitionen anzeigen
mount | grep sda        # Eingehängte Laufwerke (z.B. SSD)
sudo fstrim -av         # TRIM-Lauf für SSDs

🧠 3. RAM & CPU

free -h                 # RAM-Auslastung in human-readable Format
top                     # Prozesse und Systemlast
htop                    # Erweiterte Prozessanzeige
lscpu                   # CPU-Informationen

🌐 4. Netzwerk & Verbindungen

ip addr show            # Netzwerkinterfaces und IP-Adressen
ping -c3 8.8.8.8        # Internetverbindung prüfen
ping -c3 192.168.0.1    # Router-Verbindung prüfen
ss -tuln                # Offene Ports & laufende Dienste
systemctl status systemd-networkd
systemctl status systemd-resolved

🔍 5. Journal & Logdateien

journalctl -p 3 -xb     # Fehler des letzten Systemstarts anzeigen
journalctl -u iobroker  # Log des ioBroker-Dienstes
sudo dmesg | tail -30   # Letzte Kernelmeldungen
sudo less /var/log/pacman.log    # Paketinstallationen & Updates

🧱 6. Dienste & Status

systemctl list-units --failed      # Zeigt fehlerhafte Systemdienste
systemctl status iobroker.service  # ioBroker-Dienst prüfen
systemctl restart iobroker         # ioBroker neu starten
sudo systemctl daemon-reexec       # Systemd neu laden (ohne Reboot)

🧩 7. Pacman & Paketverwaltung

sudo pacman -Syu                  # Normales Systemupdate
sudo pacman -Syyuu                # Vollständige Neu-Synchronisation (spiegelt ggf. auch Downgrades wider)
sudo pacman -Qdtq                 # Verwaiste Pakete auflisten
sudo pacman -Rsn $(pacman -Qdtq)  # Verwaiste Pakete entfernen (inkl. Abhängigkeiten und Konfigdateien)
sudo pacman -Scc                  # Cache leeren (zweimal bestätigen)

# Wenn du yay nutzt:
yay -Syu                          # ohne sudo! Führt pacman- und AUR-Updates aus
yay -Sc                           # alten Paket-Cache (pacman + AUR) bereinigen
yay -v -Scc                       # pacman- und yay-Cache bereinigen

Hinweis: -Syyuu sollte nur bei Problemen mit Mirrorlisten oder Paketversionen verwendet werden.


🧩 8. ioBroker – Wartung & Kontrolle

iob diag               # Diagnosebericht erstellen
iob stop && iob fix    # Rechte & Dienste reparieren
iob stop && iob update && iob upgrade self && iob upgrade # ioBroker-Update
iob start              # ioBroker starten
sudo reboot            # Neustart nach Wartung

🧩 9. Node.js aktualisieren (z.B. bei neuer LTS)

Nach einem Node.js-Update solltest du einen Rebuild der nativen Module machen, sobald sich die N-API/ABI effektiv geändert hat (typisch bei Node-Major-Updates). Ein Rebuild „schadet“ nicht, er kostet nur Zeit. Dokumentation: Node.js Previous Releases.

iob stop && iob update && iob upgrade self && iob upgrade
sudo pacman -Syu
# Alt-LTS entfernen:
sudo pacman -Rns nodejs-lts-<ALT> npm
# neues LTS installieren (z.B. nodejs-lts-jod (V22), je nach Stand von Arch):
sudo pacman -S nodejs-lts-<NEU> npm
# Versionen:
command -v node nodejs npm npx && node -v && nodejs -v && npm -v && npx -v
# einmal Fixer (Rechte/Capabilities), ersetzt KEIN rebuild:
iob fix
# alle Adapter mit nativen Modulen neu bauen/neu installieren:
cd /opt/iobroker
iobroker rebuild --install
# neu starten und prüfen:
iob start
iob status
# optional:
sudo reboot

Tipp:
Bewahre diese Übersicht direkt im Wiki auf oder drucke sie als Referenzkarte.
So hast du alle wichtigen Diagnose- und Wartungsbefehle stets griffbereit.


Ende der Installations- und Wartungsanleitung

Du hast jetzt ein voll funktionsfähiges, sauberes und wartbares EndeavourOS ARM-System
mit ioBroker, optimiert für Stabilität, Sicherheit und Headless-Betrieb.