Installation: Back-End API
 OmniMDE Logo | |
| Hersteller | HTK GmbH & Co. KG |
|---|---|
| Erstrelease | 26.08.2016 |
| Akt. Version | R202209RC10 - 20.12.2024 |
| Webseite | http://www.omnimde.de |
Haftungsausschluss IIS-Server
- Achtung Der HTK API Server (Microsoft IIS Server) muss immer durch Ihren IT-Verantwortlichen Installiert und konfiguriert werden! Sollte dies aus besonderen Gründen nicht möglich sein und eine Microsoft IIS Installation explizit durch HTK gewünscht sein, so übernehmen wir keinerlei Haftung für dessen Sicherheit! Desweiteren empfehlen wir ausdrücklich keine Freigabe von Ports, welche eine Nutzung der OmniMDE API von außerhalb des internen Firmennetzwerks möglich machen. Wenn die MDE Geräte über das Intranet nicht auf den IIS-Server zugreifen können, dann bietet sich hier eine VPN Lösung an. HTK bietet hierfür allerdings keine eigene Lösung an und empfiehlt dieses Anwendungsszenario nicht. Wir weisen nochmals darauf hin, dass die OmniMDE Lösung nur für den Einsatz im Intranet konzipiert wurde. Die Lösung verwendet keine geeigneten Sicherheitsprotokolle um außerhalb des Intranets genutzt zu werden!.
Quelldaten
Nachdem Sie den heruntergeladenen Release entpackt haben, finden Sie die folgende Ordnerstruktur:
Die Back-End API befindet sich im Ordner PHP API
Beschreibung
Die Installation der Back-End API sollte gemäß den Systemvoraussetzungen des HTK API Server (Microsoft_IIS-Server) auf einem dediziertem/abgesicherten Server erfolgen. Die Installation besteht aus mehreren (Teil-)Schritten.
Der grobe Ablauf sieht wie folgt aus:
NEUINSTALLATION
- Schritt 1: Installation IIS
- Schritt 2: Installation PHP und Tools
- Schritt 3: Installation Backend-API
- Schritt 4: Konfiguration Zugriffsrechte
- Schritt 5: Prüfung/Konfiguration PHP.INI
- Schritt 6: Einrichtung Webseite
- Schritt 7: Ermittlung der API-Url
- Schritt 8: API-Test
UPGRADE/UPDATE
- Schritt 1: Installation Backend-API
- Schritt 2: Konfiguration Zugriffsrechte
- Schritt 3: Prüfung/Konfiguration PHP.INI
- Schritt 4: Ermittlung der API-Url
- Schritt 5: API-Test
Installation
Installation IIS
Serverrolle (IIS)
Zuerst muss auf dem dafür vorgesehenen dediziertem/abgesichertem Server die IIS-Serverrolle installiert/hinzugefügt werden.
Falls dies bereits der Fall ist, kann dieser Schritt übersprungen werden.
Zur Installation der Serverrolle gehen Sie bitte wie folgt vor:
Öffnen Sie über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den Server-Manager.
Im Server-Manager klicken Sie bitte oben Rechts auf Verwalten dann auf Rollen und Features hinzufügen:
In dem sich daraufhin öffnendem Assistenten wählen Sie bitte zunächst Rollenbasierte oder Featurebasierte Installation und klicken Sie auf weiter.
Anschließend wählen Sie bitte Einen Server aus dem Serverpool wählen. I.d.R. gibt es in der Liste nur einen Server zur Auswahl, sollte dies nicht so sein, müssten Sie den richtigen Server aus dem Pool wählen und dann weiter klicken.
Im nächsten Schritt des Assistenten markieren Sie bitte alle Punkt im Bereich Webserver (IIS) außer FTP-Server.
Danach bestätigen Sie den Assistenten mit weiter.
Im nächsten und letzten Schritt klicken Sie bitte einfach auf Installieren.
Sobald dies abgeschlossen ist, können Sie den Server-Manager schließen.
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
Webplattform-Manager
Um der IIS-Serverrolle bzw. dem IIS-Server die nötigen Komponenten (PHP, MSSQL-PHP-Treiber) muss zunächst der Microsoft-Webplattform-Manager installiert werden.
Sollte dieser bereits installiert sein, so kann dieser Schritt übersprungen werden.
Gehen Sie hierzu bitte wie folgt vor:
Öffnen Sie über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den Internetinformationsdienste (IIS)-Manager.
Anschließend klicken Sie bitte auf Neue Webplattformkomponenten abrufen.
Es öffnet sich nun der Standard Internet-Browser des Systems. Auf der Microsoft-Website klicken Sie bitte auf den grünen Button install this extension.
Sollte der Link nicht funktionieren können Sie unseren HTK-Mirror verwenden.
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
Installation PHP und Tools
PHP & MSSQL-PHP-Treiber
Es folgt nun die Installation von PHP und dem entsprechenden MSSQL-Treiber für PHP. Sollte dieser bereits installiert sein, so kann dieser Schritt übersprungen werden.
Öffnen Sie über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den Internetinformationsdienste (IIS)-Manager.
Anschließend klicken Sie bitte auf Neue Webplattformkomponenten abrufen.
Es öffnet sich nun der Webplatform Installer. Bitte filtern Sie dort auf PHP 8.0 (x64).
Drücken Sie daraufhin bitte bei PHP 8.0.0 (x64) und Microsoft Drivers 5.9 (x64) for PHP v.8.0 for SQL Server in IIS jeweils den Button hinzufügen.
BITTE WÄHLEN SIE NICHT DIE PUNKTE MIT IISExpress IM NAMEN. Drücken Sie anschließend Installieren.
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
PHP Manager
Nun installieren wir den PHP Manager for IIS'. Unserer Erfahrung nach schlägt die Installation des PHP-Managers über den Webplattform Installer seit geraumer Zeit leider wegen eines CRC Fehlers fehl. Die Installation erfolgt daher Manuell. Sollte dieser bereits installiert sein, so kann dieser Schritt übersprungen werden.
Zur Installation öffnen Sie einfach den entsprechenden Weblink. Wenn Sie den Offiziellen Microsoft Link öffnen öffnet sich die Microsoft-Webseite in Ihrem Standard Internet-Browser und Sie können den PHP-Manager über install this extension installieren.
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
Installation Backend-API
Zur Installation der Backend-API müssen Sie die entsprechenden Dateien aus dem Release-Ordner in den IIS wwwroot-Ordner installieren.
Die Back-End API befindet sich im Ordner PHP API
Erstellen Sie bitte unter C:\inetpub\wwwroot einen Ordner OmniMDE und fügen Sie den Gesamten Inhalt des Ordners PHP API dort ein.
- Achtung Sollte es bereits eine installierte/konfigurierte OmniMDE geben, empfehlen wir dringend das Sie die config.db Datei unter C:\inetpub\wwwroot\OmniMDE\core\config\ sichern!
Konfiguration Zugriffsrechte
Nun müssen die entsprechenden Windows-Dateiberechtigungen gesetzt werden. Hierbei ist es wichtig das der Benutzer IUSR volle Berechtigungen hat.
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
Prüfung/Konfiguration PHP.INI
Nun muss die PHP.INI modifiziert bzw. geprüft werden. ACHTUNG! Ohne diese Einstellungen kann es zu einer niedrigeren Performance und zu Problemen beim Fotoupload kommen! Bitte beachten Sie allerdings das ALLE Intranet-Anwendungen die PHP-Basiert sind von den Änderungen betroffen sind!
Der einfachste Weg die aktuell verwendete PHP.INI zu lokalisieren ist über den PHP-Manager for IIS im Internetinformationsdienste (IIS) Manager.
Klicken Sie hierzu im Linken Baum auf Ihren Servernamen und dann in der Übersicht auf den PHP-Manager.
Anschließend öffnet sich der PHP-Manager und Sie können direkt den Pfad zur PHP.INI einsehen und diese öffnen.
Bearbeiten Sie die Datei mit dem Textverarbeitungsprogramm Ihrer Wahl, wir empfehlen i.d.R. die Freeware Notepad++.
Suchen Sie nun manuell (STRG+F) die folgenden Einträge und setzen Sie bitte die folgenden Werte. Weitere Informationen zu den einzelnen Werten finden Sie unter Weiterführende Links.
post_max_size = 2000Mupload_max_filesize = 2000Mmax_file_uploads = 100memory_limit = 2048M
Anschließend starten Sie den IIS-Serverdienst bitte einmal neu. ACHTUNG! Alle Intranet-Anwendungen die auf dem IIS-Server installiert sind, können ggf. während des Neustarts einen kurzen Moment ausfallen!
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
Einrichtung Webseite
Nun muss noch eine entsprechende Webseite im Internetinformationsdienste (IIS) Manager hinzugefügt werden.
Führen Sie hierzu einen Rechtsklick auf den Servernamen im linken Baum aus und wählen Sie Webseite hinzufügen.
im Anschließenden Dialog konfigurieren Sie bitte die Webseite wie folgt und bestätigen Sie diesen Dialog mit OK.
ACHTUNG! Bitte konfigurieren Sie hier einen entsprechend abgesicherten Port! Siehe hierzu auch Haftungsausschluss
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
Ermittlung Api Url
Um die API-URL zu ermitteln, öffnen Sie eine Windows Powershell Konsole als Administrator.
Führen Sie nun die beiden folgenden Kommandos aus:
Get-NetIPAddress -AddressFamily IPv4Get-Website
Die API-Url im folgenden Beispiel lautet:
http://192.168.178.28:80/OmniMDE
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
API-Test
Sie können die API prüfen indem Sie zuerst die API-URL ermitteln (in unserem Beispiel http://192.168.178.28:80/OmniMDE) und dann folgenden webseite in Ihrem Standard-Internerbrowser aufrufen:
Wenn die OmniMDE korrekt installiert wurde, öffnet sich die Backend-Konfiguration.
- Achtung Wenn sich die Einstellungen innerhalb der Backend-Konfiguration nicht ändern lassen, liegt dies i.d.R. an einer fehlende Dateiberechtigung des IUSR Benutzers.
Ein Beispiel-Installationsvideo finden Sie im Anhang dieser Wiki-Seite.
Anhang
Videos
- Schritt 1: Installation IIS
- Schritt 2: Installation PHP und Tools
- Schritt 3: Installation Backend-API
- Schritt 4: Konfiguration Zugriffsrechte
- Schritt 5: Prüfung/Konfiguration PHP.INI
- Schritt 6: Einrichtung Webseite
- Schritt 7 & 8: Ermittlung der API-Url & API-Test
Weiterführende Links
OmniMDE Systemvoraussetzungen
PHP.INI SETTINGS
PHP.INI: post_max_size
PHP.INI: max_file_uploads
PHP.INI: upload_max_filesize
PHP.INI: memory_limit
WEBPLATFORM-INSTALLER
DOWNLOAD -> OFFIZIELL: WebPlatformInstaller_x64_en-US.msi
DOWNLOAD -> HTK-MIRROR: WebPlatformInstaller_x64_en-US.msi
PHP-MANAGER FOR IIS
DOWNLOAD -> OFFIZIELL: PHPManagerForIIS_V1.5.0.msi
DOWNLOAD -> HTK-MIRROR: PHPManagerForIIS_V1.5.0.msi
VC-REDIST + PHP EXT + ODBC DRIVER
DOWNLOAD -> HTK-MIRROR: vcredist_phpext_odbc.zip