i-doit für Windows Server installieren#
Wie i-doit unter dem Betriebssystem Windows installiert wird, beschreiben wir in diesem Artikel.
Das i-doit Installationspaket für Windows wird im Kundenportal zur Verfügung gestellt.
Die Inhalte des Pakets sehen wie folgt aus:
- i-doit Windows Installer.exe
- idoit-XX.zip
- src.zip
- windowsdesktop-runtime-6.0.14-win-x64.exe
Im Installationspaket wird immer die aktuelle i-doit Version mitgeliefert. Ebenfalls wird durch den src.zip
Ordner eine Installation ohne Internetverbindung ermöglicht.
Da der i-doit Windows installer die windowsdesktop-runtime-6.0.14
benötigt, wird diese ebenfalls zur Verfügung gestellt falls während der installation keine Internetverbindung vorhanden ist.
Installation#
Nach dem Ausführen der i-doit Windows Installer.exe
bekommt man folgende GUI angezeigt:
Nach einem Klick auf Installieren werden im Hintergrund alle benötigten Elemente installiert.
Es werden installiert:
- Apache 2.4
- PHP 8.0
- MariaDB 10.5
- i-doit
Ist die Windows Firewall aktiviert wird abgefragt ob die Applikation freigegeben werden darf
Bei erfolgreicher Installation wird in einem kleinem Fenster "i-doit has been installed successfully." angezeigt.
Nach einem Klick auf OK wird automatisch ein neues Browsertab mit der localhost
URL geöffnet und kann i-doit im vollen Umfang nutzen.
Sollte bei der Installation ein Fehler unterlaufen sein, wird automatisch ein log im i-doit Ordner erstellt
Konfiguration#
Der Speicherort der PHP, MariaDB oder Apache Konfiguration:
-
PHP:
C:\i-doit\php\php.ini
-
MariaDB:
C:\ProgramData\MariaDB\data\my.ini
-
Apache:
C:\i-doit\apache-2.4\conf\httpd.conf
HTTPS einrichten (optional)#
Die folgende Anleitung zeigt, wie Sie SSL für Windows mit i-doit einrichten.
Es werden nur die notwendigen Schritte beschrieben, die benötigt werden um HTTPS zu konfigurieren.
Dieser Abschnitt kann übersprungen werden.
Voraussetzungen#
Vorab benötigen Sie ein gültiges Zertifikat im .crt
und .key
Format. Dieses können Sie mit OpenSSL erstellen.
OpenSSL können Sie z.B. hier herunterladen und installieren: OpenSSL
Sobald OpenSSL installiert ist, können Sie Win64 OpenSSL Command Prompt über die Windows-Suchleiste öffnen, indem Sie nach "OpenSSL" suchen. Hier geben Sie nun folgenden Befehl ein, um das Zertifikat zu erstellen:
1 |
|
Das Zertifikat und der Private Key wurden nun in dem Ordner erstellt, in dem der Befehl ausgeführt wurde. Kopieren Sie diese z.B. in den Ordner i-doit\apache-2.4\conf\extra\
.
Konfigurationsschritte#
- Erstellen der ssl.conf-Datei
Navigieren Sie zu Ihrem i-doit-Ordner unter i-doit\apache-2.4\conf\extra\
und erstellen Sie die Datei ssl.conf
. Die Datei sollte folgenden Inhalt haben:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
|
Hinweis: Passen Sie die Pfade und Konfigurationseinstellungen entsprechend Ihrer eigenen Umgebung an und stellen Sie sicher, dass Ihr Zertifikat und privater Schlüssel in den angegebenen Pfaden vorhanden sind.
- Anpassungen in der httpd.conf
Bearbeiten Sie die httpd.conf
-Datei, die sich unter i-doit\apache-2.4\conf\
befindet:
- Fügen Sie
Listen 443
hinzu und kommentieren SieListen 80
aus. Dadurch wird i-doit nicht mehr über http erreichbar sein. - Fügen Sie außerdem folgende Zeilen ein:
LoadModule ssl_module modules/mod_ssl.so
undInclude conf/extra/ssl.conf
Die Datei sollte dann so aussehen, wenn vorher nichts geändert wurde:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 |
|
- Apache-Webserver neustarten:
- Drücken Sie Win+R , geben Sie cmd
ein und drücken Sie Enter.
- Oder geben Sie cmd
in der Windows-Suchleiste ein, um die Eingabeaufforderung zu öffnen
Geben Sie den folgenden Befehl ein, um den Apache-Webserver neu zu starten:
1 |
|
Der Apache-Webserver wurde nun neu gestartet. Prüfen Sie die installation und ob i-doit über HTTPS erreichbar ist.
Das wars! Ihre i-doit-Installation ist jetzt für SSL auf Windows konfiguriert.
Deinstallation#
Um i-doit wieder zu deinstallieren muss zuerst der Apache2 service gestoppt werden.
Dafür geben wir in der Eingabeaufforderung folgenden Befehl ein:
1 |
|
Ist der Apache2 Service gestoppt, kann Apache2 deinstalliert werden:
1 |
|
Anschließend wird MariaDB deinstalliert indem wir unter Programme hinzufügen oder entfernen MariaDB entfernen.
Alternativ kann MariaDB auch über die Eingabeaufforderung deinstalliert werden:
1 |
|
MariaDB deinstallieren ohne Daten zu löschen:
1 |
|
Jetzt muss noch der i-doit Ordner gelöscht werden und der PHP PATH
muss aus den Umgebungsvariabeln entfernt werden: