OmniMDE:InstallationApi: Unterschied zwischen den Versionen

Zur Navigation springen Zur Suche springen
 
(10 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 4: Zeile 4:
== Haftungsausschluss IIS-Server ==
== Haftungsausschluss IIS-Server ==
----
----
:<div style="text-indent:10px;"><span style="color:#e74c3c"><big>'''Achtung'''</big>&nbsp;&nbsp;&nbsp;Der HTK API Server (Microsoft IIS Server)&nbsp;muss&nbsp;<span style="font-size: larger;"><u>immer</u>&nbsp;</span>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 <span style="font-size: larger;"><u>keine</u>&nbsp;</span>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 <span style="text-decoration: underline;">nur für den Einsatz im Intranet konzipiert wurde</span>. <span style="font-size: 12pt;">Die Lösung verwendet<span style="text-decoration: underline;"> keine geeigneten Sicherheitsprotokolle</span> um außerhalb des Intranets genutzt zu werden!.</span></div>
:<div style="text-indent:10px;"><span style="color:#e74c3c"><big>'''Achtung'''</big>&nbsp;&nbsp;&nbsp;Der HTK API Server (Microsoft IIS Server)&nbsp;muss&nbsp;<span style="font-size: larger;"><u>immer</u>&nbsp;</span>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 <span style="font-size: larger;"><u>keine</u>&nbsp;</span>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 <span style="text-decoration: underline;">nur für den Einsatz im Intranet konzipiert wurde</span>. <span style="font-size: 12pt;">Die Lösung verwendet<span style="text-decoration: underline;"> keine geeigneten Sicherheitsprotokolle</span> um außerhalb des Intranets genutzt zu werden!.</span></span></div>
----
'''<span style="color:#e74c3c"><span style="font-size: 12pt;">&nbsp; &nbsp; &nbsp; &nbsp;Achtung&nbsp; &nbsp;</span></span>'''<span style="color:#e74c3c"><span style="font-size: 12pt;">Microsoft hat den Webplattform-Installer eingestellt!</span></span><span style="color:#e74c3c"><span style="font-size: 12pt;"></span></span>
 
== Quelldaten ==
== Quelldaten ==
<br/>
<br/>
Zeile 66: Zeile 67:


<br>
<br>
Im nächsten Schritt des Assistenten markieren Sie bitte alle Punkt im Bereich ''Webserver (IIS)'' <span style="text-decoration: underline;" >außer</span> ''FTP-Server''.
Im nächsten Schritt des Assistenten markieren Sie bitte alle Punkt im Bereich ''Webserver (IIS)'' <span style="text-decoration: underline;">außer</span> ''FTP-Server''.
Danach bestätigen Sie den Assistenten mit ''weiter''.
Danach bestätigen Sie den Assistenten mit ''weiter''.
<br><br>
<br><br>
Zeile 74: Zeile 75:
Im nächsten und letzten Schritt klicken Sie bitte einfach auf ''Installieren''.
Im nächsten und letzten Schritt klicken Sie bitte einfach auf ''Installieren''.
Sobald dies abgeschlossen ist, können Sie den ''Server-Manager'' schließen.
Sobald dies abgeschlossen ist, können Sie den ''Server-Manager'' schließen.
==== 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'''.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_app.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br>
Anschließend klicken Sie bitte auf ''Neue Webplattformkomponenten abrufen''.
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webplatform_manager.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br>
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''.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_webplatforminstaller_website.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
Sollte der Link nicht funktionieren können Sie unseren [https://wiki.htk.de/OmniMDE:InstallationApi#Weiterf%C3%BChrende_Links HTK-Mirror] verwenden.


=== Installation PHP und Tools ===
=== Installation PHP und Tools ===
==== PHP &amp; MSSQL-PHP-Treiber ====
==== PHP &amp; 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.
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'''.
 
<br><br>
Laden Sie zunächst die '''PHP Version 8.0 (x64) Non Thread Safe''' über die offizielle Seite: [https://windows.php.net/download#php-8.0 PHP] herunter. Achten Sie dabei, dass Sie die Zip Datei herunterladen. Entpacken Sie den PHP Ordner in einen geeigneten Pfad.
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_app.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Öffnen Sie danach über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den '''Internetinformationsdienste (IIS)-Manager'''.
 
[[File:omnimde_install_iis_verwaltung_manager_app.png{{!}}250px{{!}}RTENOTITLE]]
 
Sie müssen nun im PHP Manager die PHP Version 8.0 registrieren.
 
[[File:php_manager_install.png{{!}}250px{{!}}RTENOTITLE]]
<br>
<br>
Anschließend klicken Sie bitte auf ''Neue Webplattformkomponenten abrufen''.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webplatform_manager.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
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''.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_webplatforminstaller_php8_mssql_64.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br><br/>
===== PHP Manager =====
===== 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.
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.
Zeile 115: Zeile 98:
<br><br>
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_phpmanager_website.png{{!}}250px{{!}}RTENOTITLE]]</li>
<li style="display: inline-block;">[[File:omnimde_install_iis_phpmanager_website.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br>
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br>
<br>


Zeile 136: Zeile 123:
<li style="display: inline-block;">[[File:omnimde_install_iis_webseite_berechtigungen.png|250px|RTENOTITLE]]</li>
<li style="display: inline-block;">[[File:omnimde_install_iis_webseite_berechtigungen.png|250px|RTENOTITLE]]</li>
<br/>
<br/>
 
<br/>
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br/>
=== Prüfung/Konfiguration PHP.INI ===
=== 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!'''
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!'''
Zeile 160: Zeile 149:
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_neustart.png{{!}}250px{{!}}RTENOTITLE]]</li>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_neustart.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br>
 
<br/>
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br/>
=== Einrichtung Webseite ===
=== Einrichtung Webseite ===
Nun muss noch eine entsprechende Webseite im ''Internetinformationsdienste (IIS) Manager'' hinzugefügt werden.
Nun muss noch eine entsprechende Webseite im ''Internetinformationsdienste (IIS) Manager'' hinzugefügt werden.
Zeile 172: Zeile 163:
<br>
<br>
'''ACHTUNG! Bitte konfigurieren Sie hier einen entsprechend abgesicherten Port! Siehe hierzu auch [https://wiki.htk.de/OmniMDE:InstallationApi#Haftungsausschluss_IIS-Server Haftungsausschluss]
'''ACHTUNG! Bitte konfigurieren Sie hier einen entsprechend abgesicherten Port! Siehe hierzu auch [https://wiki.htk.de/OmniMDE:InstallationApi#Haftungsausschluss_IIS-Server Haftungsausschluss]
 
<br/>
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br/>
=== Ermittlung Api Url ===
=== Ermittlung Api Url ===
Um die API-URL zu ermitteln, öffnen Sie eine '''Windows Powershell''' Konsole als '''Administrator'''.
Um die API-URL zu ermitteln, öffnen Sie eine '''Windows Powershell''' Konsole als '''Administrator'''.
Zeile 189: Zeile 182:
<li style="display: inline-block;">[[File:omnimde_install_iis_apiuri_powershell_02.png{{!}}250px{{!}}RTENOTITLE]]</li>
<li style="display: inline-block;">[[File:omnimde_install_iis_apiuri_powershell_02.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br>
 
<br/>
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br/>
=== API-Test ===
=== API-Test ===
Sie können die API prüfen indem Sie zuerst die [https://wiki.htk.de/OmniMDE:InstallationApi#Ermittlung_Api_Url API-URL ermitteln] (in unserem Beispiel ''http://192.168.178.28:80/OmniMDE'') und dann folgenden webseite in Ihrem Standard-Internerbrowser aufrufen:
Sie können die API prüfen indem Sie zuerst die [https://wiki.htk.de/OmniMDE:InstallationApi#Ermittlung_Api_Url API-URL ermitteln] (in unserem Beispiel ''http://192.168.178.28:80/OmniMDE'') und dann folgenden webseite in Ihrem Standard-Internerbrowser aufrufen:
Zeile 197: Zeile 192:
Wenn die OmniMDE korrekt installiert wurde, öffnet sich die Backend-Konfiguration.
Wenn die OmniMDE korrekt installiert wurde, öffnet sich die Backend-Konfiguration.
<br><br>
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_api_admin_test.png{{!}}250px{{!}}RTENOTITLE]]</li>
<li style="display: inline-block;">[[File:Omnimde_konfiguration_backend_api_01_A.png{{!}}250px{{!}}RTENOTITLE]]</li><br>
<li style="display: inline-block;">[[File:Omnimde_konfiguration_backend_api_01.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br>
----
----
:<div style="text-indent:10px;"><span style="color:#e74c3c"><big>'''Achtung'''</big>&nbsp;&nbsp;&nbsp;Wenn sich die Einstellungen innerhalb der Backend-Konfiguration nicht ändern lassen, liegt dies i.d.R. an einer fehlende Dateiberechtigung des IUSR Benutzers.</span></div>
:<div style="text-indent:10px;"><span style="color:#e74c3c"><big>'''Achtung'''</big>&nbsp;&nbsp;&nbsp;Wenn sich die Einstellungen innerhalb der Backend-Konfiguration nicht ändern lassen, liegt dies i.d.R. an einer fehlende Dateiberechtigung des IUSR Benutzers.</span></div>
----
----
<br/>
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br/>


== Anhang ==
== Anhang ==
=== Videos ===
<br/>
* '''Schritt 1: Installation IIS'''
** [[File:omnimde_installation_iis_backend_api_schritt_1.mp4||494px]]<br/>
* '''Schritt 2: Installation PHP und Tools'''
** [[File:omnimde_installation_iis_backend_api_schritt_2.mp4||494px]]<br/>
* '''Schritt 3: Installation Backend-API'''
** [[File:omnimde_installation_iis_backend_api_schritt_3.mp4||494px]]<br/>
* '''Schritt 4: Konfiguration Zugriffsrechte'''
** [[File:omnimde_installation_iis_backend_api_schritt_4.mp4||494px]]<br/>
* '''Schritt 5: Prüfung/Konfiguration PHP.INI'''
** [[File:omnimde_installation_iis_backend_api_schritt_5.mp4||494px]]<br/>
* '''Schritt 6: Einrichtung Webseite'''
** [[File:omnimde_installation_iis_backend_api_schritt_6.mp4||494px]]<br/>
* '''Schritt 7 &amp; 8: Ermittlung der API-Url &amp; API-Test'''
** [[File:omnimde_installation_iis_backend_api_schritt_7_8.mp4||494px]]<br/>
=== Weiterführende Links ===  
=== Weiterführende Links ===  
<br/>[https://wiki.htk.de/OmniMDE:Systemvoraussetzungen#HTK_API_Server_(Microsoft_IIS-Server) '''OmniMDE Systemvoraussetzungen''']<br/>
<br/>[https://wiki.htk.de/OmniMDE:Systemvoraussetzungen#HTK_API_Server_(Microsoft_IIS-Server) '''OmniMDE Systemvoraussetzungen''']<br/>
Zeile 217: Zeile 233:
[https://www.iis.net/downloads/community/2018/05/php-manager-150-for-iis-10 '''DOWNLOAD''' -> OFFIZIELL: PHPManagerForIIS_V1.5.0.msi]<br/>
[https://www.iis.net/downloads/community/2018/05/php-manager-150-for-iis-10 '''DOWNLOAD''' -> OFFIZIELL: PHPManagerForIIS_V1.5.0.msi]<br/>
[https://wiki.htk.de/filemirror/PHPManagerForIIS_V1.5.0.msi '''DOWNLOAD''' -> HTK-MIRROR: PHPManagerForIIS_V1.5.0.msi]<br/><br/>
[https://wiki.htk.de/filemirror/PHPManagerForIIS_V1.5.0.msi '''DOWNLOAD''' -> HTK-MIRROR: PHPManagerForIIS_V1.5.0.msi]<br/><br/>
'''VC-REDIST + PHP EXT + ODBC DRIVER'''<br/>
[https://wiki.htk.de/filemirror/vcredist_phpext_odbc.zip '''DOWNLOAD''' -> HTK-MIRROR: vcredist_phpext_odbc.zip]<br/><br/>
170

Bearbeitungen

Navigationsmenü