⚠️ Fehlerbehebung (Troubleshooting)

In diesem Kapitel werden die technischen Herausforderungen dokumentiert, die während des Aufbaus der Infrastruktur aufgetreten sind, sowie die entsprechenden Lösungen.

1. Hardware & Netzwerk-Konnektivität

Problem: Zu Beginn stand kein Netzwerk-Switch zur Verfügung. Dadurch konnte der Mini-PC nicht physisch mit dem Netzwerk verbunden werden, was den Download von Basispaketen (wie Apache2) unmöglich machte. Lösung: Nach der Bereitstellung eines Switches wurden die DHCP-Einstellungen angepasst, um den Internetzugriff für den Proxmox-Host und die VMs zu ermöglichen.

2. Debian Installation ohne Netzwerk

Problem: Die erste Installation von Debian erfolgte ohne aktive Netzwerkverbindung. Nachträgliche Versuche, die Netzwerkkonfiguration manuell zu korrigieren, blieben erfolglos. Lösung: Das System wurde gelöscht und mit einer aktiven Netzwerkverbindung neu installiert, um eine saubere Konfiguration der Repositories und Schnittstellen zu gewährleisten.

3. PHP-Versionskonflikte bei DokuWiki

Problem: Nach der Installation von DokuWiki war kein Zugriff über den Webbrowser möglich. Die mit Debian gelieferten Standard-PHP-Pakete verursachten Kompatibilitätsprobleme. Lösung: Die vorhandene PHP-Installation wurde vollständig entfernt und durch die benötigten Versionen ersetzt.

# Alte PHP-Pakete entfernen
sudo apt purge php* -y
# Webserver neu starten
sudo systemctl restart apache2

4. DNS-Konfiguration unter FreeBSD

Problem: Der FreeBSD-Server konnte keine Verbindung zum Internet herstellen, um Pakete zu laden, obwohl DHCP aktiv war. Lösung: Es wurde festgestellt, dass die Nameserver in der Datei /etc/resolv.conf nicht korrekt konfiguriert waren. Erst nach der manuellen Anpassung konnte FreeBSD Daten aus dem Internet beziehen.

5. SSL-Zertifikate & Sicherheit

Problem: Der Browser zeigte Warnungen wie “Nicht sicher” an, oder Zertifikate wurden nach Konfigurationsänderungen nicht korrekt erkannt. Lösung: Ein neues Self-Signed Zertifikat wurde über OpenSSL generiert und die automatische Weiterleitung von HTTP auf HTTPS erzwungen.

6. Berechtigungen (Permissions) & Cache

Problem: Fehlermeldung “Extension directory is not writable”. Zudem wurden Änderungen an Logos oder Themes aufgrund des internen Caches nicht sofort angezeigt. Lösung:

Die Besitzrechte wurden rekursiv an den User www-data übertragen.

Der Cache wurde manuell über das Verzeichnis /var/lib/dokuwiki/cache/ geleert.

# Cache leeren
sudo rm -rf /var/lib/dokuwiki/cache/*