~~DISCUSSION:off~~
====== HTTP-Server-, PHP- und ionCube-Bundle unter Windows aktualisieren ======
<WRAP round important 90%>
Während der Aktualisierung steht untermStrich zeitweise nicht zur Verfügung. Lassen Sie die Arbeiten durch Ihren Systembetreuer durchführen.

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

{{:de:ioncube:dienste7.png?nolink&220|}}
{{:de:ioncube:dienste10.png?nolink&220|}}

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

{{:de:ioncube:ioncube1.png?nolink&500|}}

^ 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**.

{{:de:installation:bundle_unins1.png?350|}}

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

{{:de:installation:bundle_unins2.png?400|}}

Starten Sie die Deinstallation.

{{:de:installation:bundle_unins3.png?300|}}

Bestätigen Sie die Benutzerkontensteuerung.

{{:de:installation:bundle_unins4.png?400|}}

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

{{:de:installation:bundle_unins5.png?400|}}

Schließen Sie den Vorgang mit **OK** ab.

{{:de:installation:bundle_unins6.png?400|}}

===== 3. Neues Bundle installieren =====

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

**[[https://kunden.untermstrich.com/open/httpserver:index|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.

{{:de:installation:bundle1.png?nolink&380|}}

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

{{:de:installation:bundle2.png?nolink&450|}}

{{:de:installation:bundle3.png?nolink&450|}}

<WRAP round important 90%>
**Verwenden Sie beim Update denselben Port wie bisher.**

Übernehmen Sie den Port, den Sie vor der Deinstallation notiert haben.
</WRAP>

{{:de:installation:bundle4.png?nolink&450|}}

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

{{:de:installation:bundle5.png?nolink&450|}}

{{:de:installation:bundle6.png?nolink&450|}}

===== 4. Apache-Dienstkonto wiederherstellen =====

==== Apache lief bisher unter einem eigenen Benutzer ====

Stellen Sie das zuvor notierte Benutzerkonto wieder ein:

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

{{:de:ioncube:ioncube1.png?nolink&600|}}

<WRAP round info 90%>
**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.
</WRAP>

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

**[[de:installation:windows_server_network|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:

  - Aktualisieren Sie zunächst das [[apache_update|HTTP-Server-, PHP- und ionCube-Bundle]].
  - Verwenden Sie bei der Installation den bisherigen Port.
  - Führen Sie anschließend das Migrationsskript aus.
  - 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:__

  - Beenden Sie den Apache-Dienst.
  - Führen Sie ''migrate.bat'' erneut aus.
  - Starten Sie den Apache-Dienst anschließend wieder.
  - Melden Sie sich bei untermStrich an und installieren Sie das aktuelle 
    Update nochmals über die Weboberfläche.
    
    
===== 6. Alle notwendigen Butler wieder installieren/updaten =====
  - [[de:setup:setup:sideboard:setup:options:update_widgets|Installieren/Updaten]] Sie alle benötigten Widgets
\\