Inhaltsverzeichnis

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 System. Voraussetzungen finden Sie in der macOS-Installationsübersicht und in den 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:

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 macOS-Installationsübersicht.

Weiterführende Informationen