Apache aktualisieren (i-doit Windows Installer)#
Der i-doit Windows Installer bringt einen eigenen Apache-Webserver mit und richtet ihn als Dienst Apache2.4 ein. Eine Paketverwaltung, die Apache aktualisiert, gibt es unter Windows nicht. Das Update besteht darin, die Programmdateien von Apache gegen einen neueren Build von Apache Lounge zu tauschen. Konfiguration und i-doit selbst bleiben dabei unverändert.
Getestet am 20.11.2026 mit i-doit 39.2 auf Windows Server 2022
- i-doit Windows Installer 1.1.1 (PHP 8.4.27 Thread Safe), frisch installiert mit Standardwerten
- Apache 2.4.55 (Apache Lounge VS17) → 2.4.71 (Apache Lounge VS18,
httpd-2.4.71-261112-Win64-VS18.zip) - Danach geprüft: Anmeldung, Objekt anlegen und speichern, Admin Center. Rückweg auf 2.4.55 ebenfalls getestet.
Der Tausch selbst dauerte rund 3 Sekunden, mit Sicherung des Apache-Ordners rund 2 Minuten. Andere Windows-Versionen haben wir nicht getestet.
Kurzfassung#
- Sicherung oder Snapshot anlegen
- Installierte Version feststellen:
C:\ProgramData\i-doit\apache-2.4\bin\httpd.exe -v - Aktuellen Build "Win64" als ZIP von Apache Lounge laden und die Prüfsumme vergleichen
- Visual C++ Redistributable auf den Stand bringen, den Apache Lounge verlangt
- Dienst
Apache2.4stoppen, Ordnerapache-2.4sichern - Nur die Ordner
binundmodulesersetzen,confundhtdocsbleiben - Konfiguration prüfen und Dienst
Apache2.4starten - Nachweis im Apache-Log, i-doit prüfen
Voraussetzungen#
- i-doit, installiert mit dem i-doit Windows Installer. Prüfen: Der Ordner
C:\ProgramData\i-doit\apache-2.4existiert und der DienstApache2.4läuft. - Ein Konto mit Administratorrechten und eine PowerShell als Administrator.
- Internetzugang vom Server zu
www.apachelounge.comundaka.ms. Ohne Internetzugang die Dateien an einem anderen Rechner laden und auf den Server kopieren. - Ein Wartungsfenster von wenigen Minuten.
i-doit liegt im Apache-Ordner
Der Installer legt i-doit unter C:\ProgramData\i-doit\apache-2.4\htdocs ab, die angepasste Konfiguration unter C:\ProgramData\i-doit\apache-2.4\conf. Den Ordner apache-2.4 deshalb nie komplett ersetzen und beim Rückweg nie htdocs aus einer Sicherung zurückkopieren. Getauscht werden nur bin und modules.
1. Sichern#
Vor dem Update einen Snapshot der virtuellen Maschine anlegen oder mindestens die Datenbanken und den Ordner C:\ProgramData\i-doit sichern, siehe Daten sichern und wiederherstellen. Schritt 5 sichert den Apache-Ordner zusätzlich.
2. Ausgangsstand festhalten#
1 2 3 | |
Beispiel vor dem Update:
1 2 | |
Die zweite Abfrage zeigt die installierte Version des Visual C++ Redistributable, nach Schritt 4 zum Beispiel v14.52.37029.00.
3. Neuen Build laden und prüfen#
Auf apachelounge.com/download die ZIP-Datei "Win64" des aktuellen Apache 2.4 laden. Zu jeder Datei veröffentlicht Apache Lounge eine Datei .zip.txt mit der SHA256-Prüfsumme. Beispiel mit dem getesteten Build:
1 2 3 4 5 6 7 | |
Die vorletzte Zeile muss True ausgeben. Bei False die Datei nicht verwenden. Dateiname und Prüfsumme sind ein Beispiel. Apache Lounge bietet meist nur den aktuellen Build an, deshalb Dateiname, Pfad und Prüfsumme immer von der Download-Seite übernehmen.
curl.exe statt Invoke-WebRequest
Invoke-WebRequest aus Windows PowerShell 5.1 bricht bei apachelounge.com mit "308 Permanent Redirect" ab. curl.exe ist in Windows enthalten und folgt der Weiterleitung.
4. Visual C++ Redistributable aktualisieren#
Apache Lounge nennt auf der Download-Seite die Version des Visual C++ Redistributable, die der Build braucht. Für den VS18-Build war das 14.52.37029. Der Installer bringt eine ältere Version mit (im Test 14.44). Das Redistributable kommt direkt von Microsoft:
1 2 3 | |
Die zweite Zeile muss Valid ausgeben. Im Test war kein Neustart nötig.
5. Apache stoppen und sichern#
1 2 3 4 | |
Die Sicherung enthält auch htdocs mit i-doit und dauerte im Test rund zwei Minuten. Für den Rückweg werden daraus nur bin und modules gebraucht.
6. bin und modules ersetzen#
1 2 3 | |
Die beiden Ordner werden komplett ersetzt, nicht zusammengeführt. Ältere Builds enthalten Dateien, die neuere nicht mehr haben, und umgekehrt. Alle anderen Ordner aus dem ZIP (conf, htdocs, logs und so weiter) werden nicht kopiert. Der Dienst muss nicht neu eingerichtet werden, weil Pfad und Name von httpd.exe gleich bleiben.
7. Konfiguration prüfen und Apache starten#
1 2 3 | |
httpd.exe -t muss Syntax OK melden. Apache schreibt Syntax OK auf den Fehlerkanal. PowerShell kann die Zeile deshalb als Fehler darstellen, das ist kein Fehler.
8. Nachweis und i-doit prüfen#
1 2 | |
Ergebnis im Test:
1 2 3 | |
Die Zeile AH00455 zeigt, dass der laufende Dienst die neue Apache-Version nutzt und PHP geladen hat. Danach in i-doit anmelden, ein Objekt öffnen und speichern und das Admin Center aufrufen.
Läuft alles, können der Ordner C:\apache-update und nach einigen Tagen die Sicherung apache-2.4-backup-... gelöscht werden.
Stolperfallen#
- Nur
binundmodulestauschen. Ein komplettes Ersetzen des Ordnersapache-2.4löscht i-doit (htdocs) und die vom Installer angepasstehttpd.conf. - Apache vorher stoppen. Sonst sind
httpd.exeund die Module gesperrt und lassen sich nicht ersetzen. - Visual C++ Redistributable. Apache Lounge setzt die auf der Download-Seite genannte Version voraus. Im Test startete der neue Build auch mit der älteren Version, unterstützt ist das laut Apache Lounge aber nicht.
Rückweg#
Getestet: Dienst stoppen, bin und modules aus der Sicherung zurückkopieren, Dienst starten. htdocs, conf und logs bleiben unberührt.
1 2 3 4 5 6 | |