Table of Contents
⚠️ 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/*
