OmniMDE:InstallationApi: Unterschied zwischen den Versionen

Zur Navigation springen Zur Suche springen

OmniMDE:InstallationApi (Quelltext anzeigen)

Version vom 1. Juni 2023, 08:55 Uhr

4.810 Bytes hinzugefügt ,  1. Juni 2023
→‎Installation IIS
 
(18 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>
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>
<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>
 
<br>
Öffnen Sie danach über das Windows-Startmenü oder die entsprechende Desktop-Verknüpfung den '''Internetinformationsdienste (IIS)-Manager'''.
Anschließend klicken Sie bitte auf ''Neue Webplattformkomponenten abrufen''.
 
<br><br>
[[File:omnimde_install_iis_verwaltung_manager_app.png{{!}}250px{{!}}RTENOTITLE]]
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webplatform_manager.png{{!}}250px{{!}}RTENOTITLE]]</li>
 
Sie müssen nun im PHP Manager die PHP Version 8.0 registrieren.
 
[[File:php_manager_install.png{{!}}250px{{!}}RTENOTITLE]]
<br>
<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!'''
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.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_phpmanager.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
Anschließend öffnet sich der PHP-Manager und Sie können direkt den Pfad zur PHP.INI einsehen und diese öffnen.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_phpmanager_version.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
Bearbeiten Sie die Datei mit dem Textverarbeitungsprogramm Ihrer Wahl, wir empfehlen i.d.R. die Freeware [https://notepad-plus-plus.org/downloads/ 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 [https://wiki.htk.de/OmniMDE:InstallationApi#Weiterf%C3%BChrende_Links Weiterführende Links].
<br><br>
*<code>'''post_max_size''' = '''2000M'''<br></code>
*<code>'''upload_max_filesize''' = '''2000M'''<br></code>
*<code>'''max_file_uploads''' = '''100'''<br></code>
*<code>'''memory_limit''' = '''2048M'''<br></code>
<br><br>
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!'''
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_neustart.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br/>
<br/>
post_max_size = 2000M
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
upload_max_filesize = 2000M
max_file_uploads = 100
memory_limit = 2048M
<br/>
<br/>
=== Einrichtung Webseite ===
=== Einrichtung Webseite ===
<br/><br/>
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'''.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webseite_hinzufuegen.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
im Anschließenden Dialog konfigurieren Sie bitte die Webseite wie folgt und bestätigen Sie diesen Dialog mit OK.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_verwaltung_manager_webseite_hinzufuegen_details.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
'''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'''.
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_apiuri_powershell_01.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
Führen Sie nun die beiden folgenden Kommandos aus:
<br/>
* <code>Get-NetIPAddress -AddressFamily IPv4</code>
* <code>Get-Website</code>
<br/>
Die API-Url im folgenden Beispiel lautet:
<br/>
'''http://192.168.178.28:80/OmniMDE'''
<br><br>
<li style="display: inline-block;">[[File:omnimde_install_iis_apiuri_powershell_02.png{{!}}250px{{!}}RTENOTITLE]]</li>
<br>
<br/>
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
<br/>
=== 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:
<br/><br/>
<br/><br/>
=== API-Test ===
* <code>'''http://192.168.178.28:80/OmniMDE/admin'''</code>
<br/>
Wenn die OmniMDE korrekt installiert wurde, öffnet sich die Backend-Konfiguration.
<br><br>
<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>
----
:<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/>
<br/>
http://localhost/OmniMDE/admin
Ein Beispiel-Installationsvideo finden Sie im [https://wiki.htk.de/OmniMDE:InstallationApi#Videos Anhang] dieser Wiki-Seite.
http://localhost/OmniMDE/api.php/sync_license
<br/>
<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 168: 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/>
RiM
Administratoren
170

Bearbeitungen

Abgerufen von „https://wiki.htk.de/Spezial:Mobiler_Unterschied/3236...5008“

Navigationsmenü