HTTP-Server-, PHP- und ionCube-Bundle unter Windows aktualisieren

Während der Aktualisierung steht untermStrich zeitweise nicht zur Verfügung. Lassen Sie die Arbeiten durch Ihren Systembetreuer durchführen.

1. Apache-Dienst und bisherige Einstellungen prüfen

Öffnen Sie auf dem untermStrich-Server die Windows-Dienste und anschließend die Eigenschaften des Apache-Dienstes.

Prüfen Sie im Reiter Anmelden, unter welchem Konto der Dienst ausgeführt wird.

Bisherige Einstellung Was müssen Sie beachten?
Lokales Systemkonto Notieren Sie diese Einstellung. Ein eigenes Benutzerkonto muss nach dem Update nicht wieder eingetragen werden.
Eigenes Benutzerkonto Notieren Sie den Benutzernamen und stellen Sie sicher, dass Ihnen das Kennwort vorliegt. Dieses Konto müssen Sie nach dem Update gegebenenfalls wieder einstellen.

Notieren Sie außerdem den bisher verwendeten Port und gegebenenfalls besondere Anpassungen der Server- und HTTPS-Konfiguration.

2. Bisheriges Bundle deinstallieren

Öffnen Sie in Windows Programme / Apps & Features.

Suchen Sie das HTTP Server, PHP, ionCube Bundle und wählen Sie Deinstallieren.

Starten Sie die Deinstallation.

Bestätigen Sie die Benutzerkontensteuerung.

Bestätigen Sie die weitere Rückfrage mit Ja.

Schließen Sie den Vorgang mit OK ab.

3. Neues Bundle installieren

Laden Sie das aktuelle HTTP-Server-, PHP- und ionCube-Bundle herunter:

Aktuelles Bundle herunterladen

Beachten Sie die auf der Downloadseite angegebenen Voraussetzungen für Ihre Windows- und untermStrich-Version.

Starten Sie das heruntergeladene Setup-Programm und bestätigen Sie die Benutzerkontensteuerung.

Prüfen Sie die Angaben während der Installation.

Verwenden Sie beim Update denselben Port wie bisher.

Übernehmen Sie den Port, den Sie vor der Deinstallation notiert haben.

Schließen Sie die Installation ab. Am Ende können Sie die Willkommensseite öffnen.

4. Apache-Dienstkonto wiederherstellen

Apache lief bisher unter einem eigenen Benutzer

Stellen Sie das zuvor notierte Benutzerkonto wieder ein:

  1. Öffnen Sie erneut die Windows-Dienste.
  2. Öffnen Sie die Eigenschaften des Apache-Dienstes.
  3. Tragen Sie im Reiter Anmelden das bisher verwendete Benutzerkonto und dessen Kennwort ein.
  4. Prüfen Sie die Berechtigungen dieses Kontos für das Apache24-Verzeichnis, das Datenverzeichnis und gegebenenfalls weitere benötigte Netzwerkverzeichnisse.
  5. Starten Sie den Apache-Dienst neu, damit die geänderte Anmeldung wirksam wird.

Warum ist das wichtig?

Der Apache-Dienst greift unter diesem Konto auf die benötigten Verzeichnisse zu. Wird nach dem Update ein anderes Konto verwendet, kann der Zugriff auf Daten- oder Projektverzeichnisse fehlen.

Das ist insbesondere wichtig, wenn sich diese Verzeichnisse auf einer Netzwerkfreigabe befinden.

Die ausführliche Anleitung zum Dienstkonto und zu den Verzeichnisberechtigungen finden Sie hier:

Apache für den Netzwerkzugriff konfigurieren

5. Migration beim Wechsel von PHP 7.4 auf PHP 8 durchführen

Dieser Abschnitt betrifft Installationen, die mit dem Bundle-Update von PHP 7.x, beispielsweise PHP 7.4, auf PHP 8 wechseln.

Besonderheit beim Wechsel der PHP-Version

Ein Wechsel von PHP 7.x auf PHP 8.xx ist mehr als ein gewöhnliches untermStrich-Update. In diesem Fall müssen Sie zusätzlich eine Migration durchführen.

Beachten Sie dabei folgende Reihenfolge:

  1. Aktualisieren Sie zunächst das HTTP-Server-, PHP- und ionCube-Bundle.
  2. Verwenden Sie bei der Installation den bisherigen Port.
  3. Führen Sie anschließend das Migrationsskript aus.
  4. Installieren Sie danach das aktuelle untermStrich-Update nochmals über die Weboberfläche.

Unter Windows befindet sich das Migrationsskript im untermStrich-Verzeichnis:

C:\Apache24\htdocs\ustrich\migrate.bat

Wenn beim Ausführen des Skripts eine Fehlermeldung auftritt:

  1. Beenden Sie den Apache-Dienst.
  2. Führen Sie migrate.bat erneut aus.
  3. Starten Sie den Apache-Dienst anschließend wieder.
  4. Melden Sie sich bei untermStrich an und installieren Sie das aktuelle

Update nochmals über die Weboberfläche.

6. Alle notwendigen Butler wieder installieren/updaten

  1. Installieren/Updaten Sie alle benötigten Widgets