====== macOS: Serverkomponenten aktualisieren und Störungen beheben ======
Diese Seite beschreibt, wie Apache und PHP 8.3 einer bestehenden untermStrich-Installation unter macOS aktualisiert werden. Danach finden Sie die Hinweise, wie Sie Störungen beim Start von Apache, bei der Erreichbarkeit, beim Dateizugriff und bei Homebrew eingrenzen.
**Vor jeder Änderung eine vollständige Datensicherung erstellen.** Sichern Sie Datenbank, untermStrich-Dateien und Serverkonfiguration. Informieren Sie die Benutzer, da untermStrich während der Arbeiten zeitweise nicht erreichbar ist.
===== Vorbereitung =====
==== Terminal öffnen ====
Alle Befehle auf dieser Seite werden im **Terminal** ausgeführt. Sie finden es unter **Programme → Dienstprogramme → Terminal**. Befehle mit **sudo** verlangen das Kennwort des Administrators. Dabei werden keine Zeichen angezeigt; das ist normal.
==== Installation prüfen ====
Ermitteln Sie zunächst die **untermStrich- und PHP-Version** im Bereich [[de:sysinfo:start|System]]. Voraussetzungen finden Sie in der [[de:installation:installation_macos|macOS-Installationsübersicht]] und in den [[https://docs.brew.sh/Installation#macos-requirements|Homebrew-Systemvoraussetzungen]].
Der Installationspfad von Homebrew wird so ermittelt:
brew --prefix
Auf Apple-Silicon-Rechnern (M1 und neuer) lautet das Ergebnis üblicherweise ''/opt/homebrew'', bei Intel-Rechnern ''/usr/local''. Maßgeblich ist immer die Ausgabe auf Ihrem Server.
==== Betriebsart von Apache ====
Apache kann als **Benutzerdienst** oder als **Systemdienst** eingerichtet sein:
* **Benutzerdienst:** startet bei der Anmeldung des Benutzers und wird ohne ''sudo'' verwaltet.
* **Systemdienst:** startet beim Hochfahren des Macs und wird mit ''sudo'' verwaltet.
Welche Betriebsart vorliegt, zeigen die beiden Übersichten:
brew services list
sudo brew services list
Der Eintrag **httpd** erscheint in der Übersicht der tatsächlich verwendeten Betriebsart. Behalten Sie diese bei. Apache sollte nicht gleichzeitig als Benutzer- und als Systemdienst laufen, da beide denselben Port belegen können.
Alle folgenden Befehle zum Stoppen und Starten gelten für diese Betriebsart: ohne ''sudo'' beim Benutzerdienst, mit ''sudo'' beim Systemdienst.
===== Apache und PHP aktualisieren =====
Die folgenden Befehle gelten für eine vorhandene Homebrew-Installation mit **httpd** und **php@8.3**.
==== Paketinformationen aktualisieren ====
brew update
brew outdated
''brew update'' aktualisiert Homebrew selbst und die Liste verfügbarer Pakete. Dabei wird noch nichts installiert. ''brew outdated'' zeigt, welche installierten Pakete neuere Versionen haben. Prüfen Sie die Ausgabe, bevor Sie fortfahren.
==== Apache stoppen ====
Benutzerdienst:
brew services stop httpd
Systemdienst:
sudo brew services stop httpd
==== Aktualisieren ====
brew upgrade httpd php@8.3
Der Befehl wird ohne ''sudo'' unter dem Benutzer ausgeführt, der die Homebrew-Installation verwaltet. Die Paketnamen sind bewusst angegeben: Ein ''brew upgrade'' ohne Paketnamen aktualisiert alle installierten Pakete und kann weitere Komponenten verändern. Benötigte Abhängigkeiten werden automatisch mit aktualisiert.
==== Konfiguration prüfen und Apache starten ====
Prüfen Sie zuerst die Apache-Konfiguration:
"$(brew --prefix httpd)/bin/httpd" -t
**Syntax OK** bedeutet, dass die Konfiguration formal in Ordnung ist. Eine Fehlermeldung nennt meist Datei und Zeile. Beheben Sie sie, bevor Sie starten.
Starten Sie anschließend Apache in der bisherigen Betriebsart:
Benutzerdienst:
brew services start httpd
Systemdienst:
sudo brew services start httpd
Melden Sie sich danach in untermStrich an. Im Bereich **System** sollte die erwartete PHP-Version angezeigt werden.
===== Apache startet nicht =====
Apache versuchen manuell im Vordergund zu starten:
/opt/homebrew/bin/httpd -DFOREGROUND
==== Port prüfen ====
Eine Standardinstallation verwendet Port 8080 für HTTP und 8443 für HTTPS. Prüfen Sie, ob der Port belegt ist:
sudo lsof -i:8080
Ein Eintrag mit **(LISTEN)** bedeutet, dass ein Prozess auf diesem Port auf Verbindungen wartet. In der Spalte **COMMAND** steht das Programm, in der Spalte **PID** die Prozessnummer. Beenden Sie einen Prozess erst, wenn klar ist, zu welcher Anwendung er gehört. Handelt es sich um einen bereits laufenden Apache, wurde der Dienst eventuell doppelt gestartet.
==== Veraltete PID-Datei ====
Nach einem Absturz kann eine veraltete Datei den Start verhindern. Die Datei heißt ''httpd.pid'' und liegt typischerweise unter:
/opt/homebrew/var/run/httpd/httpd.pid (Apple Silicon)
/usr/local/var/run/httpd/httpd.pid (Intel)
**Die Datei nur löschen, wenn beide Bedingungen zutreffen:** Apache läuft nachweislich nicht, und die Datei ist veraltet. Im Zweifel prüft der Systembetreuer den Pfad aus der tatsächlichen Konfiguration.
===== untermStrich ist nicht erreichbar =====
Dieser Fall liegt vor, wenn Apache läuft, die Adresse im Browser aber nicht erreichbar ist. Prüfen Sie zunächst, ob die Adresse den richtigen Port enthält, zum Beispiel ''http://server:8080/ustrich/''.
==== Listen-Einstellung in httpd.conf ====
Die Netzwerkeinstellung steht in der Konfigurationsdatei ''httpd.conf'':
/opt/homebrew/etc/httpd/httpd.conf (Apple Silicon)
/usr/local/etc/httpd/httpd.conf (Intel)
Die bisherige Anleitung nennt dort folgende Zeile:
Listen 0.0.0.0:8080
Diese Zeile lässt Apache auf Port 8080 an allen IPv4-Netzwerkschnittstellen auf Verbindungen warten. Ob das für Ihre Installation passt, hängt von Netzwerk und Firewall ab. Ändern Sie die Zeile nur nach Absprache mit dem Systembetreuer. Nach einer Änderung prüfen Sie die Konfiguration mit dem Test aus dem Abschnitt „Apache und PHP aktualisieren“ und starten Apache neu.
===== Dokumente lassen sich nicht öffnen oder speichern =====
Dieser Fall liegt vor, wenn die Anmeldung funktioniert, Dateien aber nicht geöffnet, erstellt oder gespeichert werden können. Meist fehlen dem Apache-Benutzer ausreichende Rechte auf das Verzeichnis, oder macOS blockiert den Zugriff auf einen geschützten Speicherort.
==== Verzeichnisrechte prüfen ====
Wählen Sie im Finder das Daten- bzw. Projektverzeichnis aus und öffnen Sie **Ablage → Informationen**. Der Benutzer, unter dem Apache läuft, benötigt dort Lese- und Schreibrechte. Eingebundene Netzwerkverzeichnisse müssen erreichbar sein. Rechteänderungen sollten mit dem Systembetreuer abgestimmt werden.
==== Datenschutz von macOS prüfen ====
Seit macOS 10.15 (Catalina) fragt macOS vor dem Zugriff auf Dokumente, Downloads, den Schreibtisch, iCloud Drive oder Netzwerkvolumes um Erlaubnis. Diese Freigabe gilt pro Programm und ist unter **Systemeinstellungen → Datenschutz & Sicherheit → Dateien & Ordner** einsehbar.
Der **Festplattenvollzugriff** unter **Systemeinstellungen → Datenschutz & Sicherheit** erlaubt einem Programm deutlich mehr Zugriff. Aktivieren Sie ihn nur, wenn die Fehlermeldung darauf hinweist, und nur für das tatsächlich benötigte Programm.
===== Homebrew meldet einen Fehler =====
Wenn Homebrew-Befehle Fehler melden, kann die Ursache bei den Command Line Tools für Xcode, bei einer Abhängigkeit oder bei der Installation liegen.
==== Diagnose mit brew doctor ====
brew doctor
Nicht jede Warnung erfordert eine Änderung. Bewerten Sie die Ausgabe im Zusammenhang mit der konkreten Fehlermeldung.
==== Command Line Tools für Xcode ====
Veraltete oder unpassende Command Line Tools können Homebrew-Fehler auslösen. Sie werden entfernt und anschließend neu installiert:
sudo rm -rf /Library/Developer/CommandLineTools
Bestätigen Sie danach den Installationsdialog von macOS. Das Entfernen sollte nur nach Rücksprache mit dem Systembetreuer erfolgen.
==== Fehler bei einer Abhängigkeit ====
Bei der Meldung ''_apr_crypto_block_cleanup'' hilft folgender Befehl:
brew reinstall apr-util
Dieser Befehl ist nur für diesen konkreten Fehler vorgesehen. Danach wird Apache wie im Abschnitt „Apache und PHP aktualisieren“ beschrieben aktualisiert.
==== Neuinstallation als letzte Möglichkeit ====
Eine Neuinstallation sollte nur erfolgen, wenn die übrigen Maßnahmen nicht helfen, und nur mit dem Systembetreuer und nach Datensicherung:
brew remove httpd
brew install httpd
brew install php@8.3
===== Hinweise zu älteren Anleitungen =====
Die bisherigen Anleitungen für Big Sur, Mojave und Catalina beschreiben frühere Serverumgebungen. Sie belegen nicht, dass diese Umgebungen heutige Anforderungen erfüllen. Maßgeblich bleibt die [[de:installation:installation_macos|macOS-Installationsübersicht]].
* Feste Pfade unter ''/usr/local'' passen nicht automatisch zu Apple Silicon. Verwenden Sie den mit ''brew --prefix'' ermittelten Pfad.
* ''brew cleanup'' entfernt alte Paketversionen und Zwischenspeicher. Der Befehl ist kein allgemeiner Reparaturschritt.
* Der frühere Hinweis, Homebrew am Basepath ''/usr/local/var/www/'' zu erkennen, ist nicht zuverlässig. Das Standardverzeichnis bei Apple Silicon lautet ''/opt/homebrew/var/www/''.
* Die frühere Installation von ''php@7.4'' ist nicht mehr vorgesehen.
===== Weiterführende Informationen =====
* [[de:installation:installation_macos|macOS-Installationsübersicht]]
* [[de:installation:mac111_detail83|Apache und PHP 8.3 unter macOS konfigurieren]]
* [[https://docs.brew.sh/Manpage|Homebrew: Befehle und Dienstverwaltung]]
* [[https://httpd.apache.org/docs/2.4/programs/httpd.html|Apache: Optionen und Konfigurationstest]]
* [[https://support.apple.com/de-de/guide/mac-help/mchld5a35146/mac|Apple: Zugriff auf Dateien und Ordner steuern]]