Einrichten des IIS für DataFlex WebApp Server. Einrichten des IIS (Internet Information Server) für DataFlex WebApp Server

Transkript

1 Einrichten des IIS (Internet Information Server) für DataFlex WebApp Server Inhalt Einrichten des IIS (Internet Information Server) für DataFlex Web App Server... 1 Windows Windows Windows Windows Vista/ Windows Server Windows Server Windows Server 2003 / Server Server WebApp ohne Unterpfad ausführen URL Rewrite Module Anpassungen am ASP Code DataFlex WebApp Check DATA PROJECT GmbH Seite 1

2 Windows 10 Systemsteuerung > Programme > Programme und Features > Windows Features aktivieren oder deaktivieren Im Verzeichnisbaum folgende Sachen anklicken; Unter Windows 10 muss zusätzlich noch darauf geachtet werden, dass der Punkt "Statischer Inhalt" unter "Allgemeine HTTP-Features" aktiviert ist DATA PROJECT GmbH Seite 2

3 Für DataFlex muss auf 64 Bit Systemen bis zur Version v18.2 die 32 Bit Unterstützung angeschaltet werden (ab v19.0 ist das nicht mehr notwendig): Suche: iis > Starten > Maschinen-Name aufklicken > Anwendungspools > Default Anwendungspool > rechte Maustaste: Erweiterte Einstellungen 2017 DATA PROJECT GmbH Seite 3

4 Windows 8.1 Systemsteuerung > Programme und Features > Windows Features aktivieren oder deaktivieren Im Verzeichnisbaum folgende Sachen anklicken; Bei Eingabe von localhost im Browser sollte folgendes Bild erscheinen: 2017 DATA PROJECT GmbH Seite 4

5 Unter Windows 8.1 muss zusätzlich noch darauf geachtet werden, dass der Punkt "Statischer Inhalt" unter "Allgemeine HTTP-Features" aktiviert ist. Für DataFlex muss auf 64 Bit Systemen bis zur DataFlex Version v18.2 die 32 Bit Unterstützung angeschaltet werden: Suche: iis > Starten > Maschinen-Name aufklicken > Anwendungspools > Default Anwendungspool > rechte Maustaste: Erweiterte Einstellungen 2017 DATA PROJECT GmbH Seite 5

6 Windows 8 Systemsteuerung > Programme > Windows Features aktivieren / deaktivieren > Im Verzeichnisbaum folgende Sachen anklicken und öffnen: Internetinformationsdienste > WWW-Dienste > Anwendungsentwicklungsfeatures danach: ASP und ISAPI Erweiterungen anhaken und alles mit ok übernehmen Zur Kontrolle jetzt im Browser localhost eingeben und die Start-Seite vom ISS öffnet sich: Zu beachten bei 64bit Betriebssystemen: Unter 64bit Betriebssystemen muss im IIS noch eine weitere Einstellung getätigt werden, damit die Web-Anwendungen unter diesem laufen können. Starten Sie zunächst den Internetinformationsdienste-Manager (zu finden unter Systemsteuerung > System und Sicherheit) mit Doppelklick. Im linken Teil des Fensters Verbindungen wählen, den kleinen Pfeil anklicken. Anwendungspools auswählen und anklicken. Danach rechtsklicken auf Ihren DefaultAppPool oder den Anwendungspool, den Sie in Ihrer Web-App eingestellt haben. Wählen Sie nun aus diesem Menü Erweiterte Einstellungen Erweiterte Einstellungen öffnen, 32-Bit-Anwendungen aktivieren mit der Maus markieren, rechts, wo False vorgesteuert ist, öffnet sich ein kleines Fenster mit einem Pfeil, diesen anklicken, Box mit True und False öffnet sich, True anklicken und mit OK bestätigen DATA PROJECT GmbH Seite 6

7 Windows Vista/7 Um ASP auf Ihrem IIS zu installieren, müssen Sie Windows-Funktionen aktivieren oder deaktivieren. Dieses erreichen Sie in Windows Vista und Windows 7 über Systemsteuerung > Programme > Windows- Funktionen aktivieren oder deaktivieren. In diesem Fenster aktivieren Sie folgende Optionen: Kompatibilität mit IIS-Metabasis und IIS 6-Konfiguration ASP ISAPI-Erweiterungen Unter 64bit Betriebssystemen muss im IIS noch die 32 Bit Unterstützung (siehe Windows 8.1) eingeschaltet werden DATA PROJECT GmbH Seite 7

8 Windows Server 2016 Unter Windows Server 2016 müssten Sie den zuerst den IIS installieren, indem Sie die entsprechende Rolle hinzufügen 2017 DATA PROJECT GmbH Seite 8

9 Wählen Sie den entsprechenden Server aus: Und markieren Sie hier die Einstellungen für Web Server (IIS) 2017 DATA PROJECT GmbH Seite 9

10 Vergessen Sie nicht, Unter Anwendungsentwicklung die ASP Option an zu klicken und unter Verwaltungsprogramme die IIS 6-Metabasiskompatibilität zu aktivieren: 2017 DATA PROJECT GmbH Seite 10

11 Die Installation des IIS und der benötigten Komponenten ist nun abgeschlossen. Bei 64 Bit Systemen müssen Sie bei Verwendung von DataFlex 18.2 (und niedriger) die 32 Bit Unterstützung aktivieren. Sollten Sie nur DataFlex ab der Version 19.0 verwenden, ist dies nicht notwendig. Um die 32 Bit Unterstützung zu aktivieren setzt man einen weiteren Parameter direkt beim Aufruf des IIS: Anwendungspools DefaultAppPool Erweiterte Einstellungen 2017 DATA PROJECT GmbH Seite 11

12 Der Parameter 32-Bit-Anwendungen wird auf True gesetzt DATA PROJECT GmbH Seite 12

13 Windows Server 2012 Unter Windows Server 2012 müssten Sie den zuerst den IIS installieren, indem Sie die entsprechende Rolle hinzufügen Wählen Sie den entsprechenden Server aus: 2017 DATA PROJECT GmbH Seite 13

14 Und markieren Sie hier die Einstellungen für Web Server IIS Vergessen Sie nicht, die Option ASP mit anzuklicken: 2017 DATA PROJECT GmbH Seite 14

15 Unter Kompatibilität ist noch ein Häkchen unter Verwaltungsprogramm notwendig: Hier ist die Installation fertig. Bei 64 Bit Systemen ist noch das Einstellen der 32 Bit Unterstützung notwendig. Dazu setzt man einen weiteren Parameter direkt beim Aufruf des IIS: Anwendungspools DefaultAppPool Erweiterte Einstellungen 2017 DATA PROJECT GmbH Seite 15

16 Der Parameter 32-Bit- Anwendungen wird auf True gesetzt DATA PROJECT GmbH Seite 16

17 Windows Server 2003 / 2008 Unter Windows Server 2003/2008 wird ASP schon standardmäßig mit dem IIS zusammen installiert. Diesen installieren Sie über die Serververwaltung. Funktion hinzufügen oder entfernen (Server 2003) bzw. Rolle hinzufügen (Server 2008) und installieren über den nun auftauchenden Assistent den Anwendungsserver. Überprüfen Sie nach der Installation noch einmal, dass Active Server Pages mit dem IIS installiert wurde. Dies können Sie unter folgendem Fenster überprüfen und gegebenenfalls nachinstallieren: 2017 DATA PROJECT GmbH Seite 17

18 Server 2003 Systemsteuerung > Software > Windows-Komponenten hinzufügen/entfernen Klicken Sie hier auf Anwendungsserver und danach auf Details ; nun auf Internetinformationsdienste(IIS) und wieder auf Details ; nun auf WWW-Dienst und wieder auf Details. In dem nun aktiven Fenster können Sie sehen, ob Active Server Pages aktiviert ist, oder nicht. Sollte es hier nun keinen Haken haben, setzen Sie einen herein und bestätigen Sie alle Fenster mit OK und beenden Sie den ganzen Vorgang über Weiter > 2017 DATA PROJECT GmbH Seite 18

19 Server 2008 Öffnen Sie den Server-Manager und wählen Sie den Webserver aus. Klicken Sie auf Rollendienste hinzufügen und überprüfen Sie, ob ASP, ISAPI-Erweiterungen und IIS 6-Metabasiskompatibilität installiert sind. Setzen Sie gegebenenfalls das entsprechende Häkchen und beenden Sie den Vorgang mit dem Assistenten. Zu beachten bei 64bit Betriebssystemen: Unter 64bit Betriebssystemen muss im IIS noch eine weitere Einstellung getätigt werden, damit die Web-Anwendungen unter diesem laufen können DATA PROJECT GmbH Seite 19

20 Starten Sie zunächst den Internetinformationsdienste-Manager (zu finden unter Systemsteuerung > Verwaltung). Im linken Teil Verbindungen des Fensters, wählen Sie Anwendungspools aus und rechtsklicken dort entweder auf Ihren DefaultAppPool, oder den Anwendungspool, den Sie in Ihrer Web-App eingestellt haben. Wählen Sie nun aus diesem Menü Erweiterte Einstellungen Und setzen Sie den Punkt 32-Bit-Anwendungen aktivieren auf True DATA PROJECT GmbH Seite 20

21 WebApp ohne Unterpfad ausführen Um eine WebApp so laufen zu lassen, dass sie nicht unter sondern direkt unter läuft, müssen ein paar Dinge am IIS eingestellt und installiert werden sowie Anpassungen am ASP Code vorgenommen werden. URL Rewrite Module 2.0 Zunächst benötigen wir eine Erweiterung des IIS, die sich nicht über die Windowskonfiguration installieren lässt; URL Rewrite Module 2.0. URL Rewrite Module 2.0 finden Sie unter Diese Erweiterung macht es Ihnen möglich, Einfluss darauf zu nehmen, welche Inhalte beim Aufruf der Seiten des Servers angezeigt werden sollen, wenn er mit einem bestimmten Namen angesprochen wird. Nachdem Sie URL Rewrite installiert haben, taucht dieses nun bei Ihnen im IIS unter dem Punkt IIS auf. Navigieren Sie nun im Verbindungen Abschnitt zur so genannten Default Web Site. Wählen Sie danach URL Rewrite aus. Nach einem Doppelklick auf URL Rewrite stehen Ihnen im rechten Aktionen Bereich neue Aktionen zur Verfügung. Wählen Sie hier nun Regel(n) hinzufügen und nun Leere Regel. Geben Sie nun einen Namen für die neue Regel ein. Anschließend wird als Muster bei Übereinstimmung mit URL das Muster.* eingegeben. Dieses Feld ist dafür verantwortlich, über Regular Expressions heraus zu finden, ob diese Regel für die aktuelle Aktion des Servers Anwendung findet. Als nächstes kommen wir zu dem Punkt Bedingungen DATA PROJECT GmbH Seite 21

22 Klicken Sie im Bedingungen Bereich auf Hinzufügen. In das neu auf gegangene Fenster geben Sie nun als Bedingungseingabe {HTTP_HOST} und als Muster.* ein. Fügen Sie nun eine Weitere Bedingung hinzu. Diesmal kommt in die Bedingungseingabe {QUERY_STRING} und als Muster ^/<WebAppVirtualDirectory>/ (ersetzen Sie <WebAppVirtualDirectory> durch das Virtual Directory Ihrer Webapp. Stellen Sie außerdem sicher, das diesmal nicht Entspricht dem Muster in der Comboliste steht, sondern Entspricht nicht dem Muster. Geben Sie nun in das Feld URL umschreiben unter Aktion folgendes ein: \<WebAppVirtualDirectory>\{R:0} Setzen Sie als letztes noch ein Häkchen in die Checkbox Verarbeitung von nachfolgenden Regeln beenden und Übernehmen Sie die Regel oben rechts. Anpassungen am ASP Code Die notwendigen Anpassungen betreffen nur die Cookies der WebApp. Durchsuchen Sie im AppHtml alle ASP Dateien nach Response.Cookies und fügen Sie nach jeder Zeile, die Response.Cookies enthält 'Response.Cookies( ).Path = / ' ein. Hintergrund dessen ist, dass die Cookies ansonsten mit dem Unterpfad des WebApp Projektes gespeichert werden und die WebApp selbst, die dann vom Hauptverzeichnis des Web-Servers aufgerufen wird, keinen Zugriff mehr auf diese hat. Ein Wichtiger Hinweis zum Schluss: Kontrollieren Sie vor der Installation von DataFlex die ordnungsgemäße IIS Installation mit dem Tool: DataFlex WebApp Check Dieses Tool gehört mittlerweile als Standard in jede DataFlex Installation. Sie finden es unter dem Namen DataFlexWebAppCheck.exe im DataFlex.\Bin Verzeichnis 2017 DATA PROJECT GmbH Seite 22