====== ⚠️ 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.

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

===== 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.

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