Einrichten des IIS (Internet Information Server) für ... · Unter Windows Server 2012 müssten Sie den zuerst den IIS installieren, indem Sie die entspre- chende Rolle hinzufügen

Einrichten des IIS für DataFlex WebApp Server

© 2017 DATA PROJECT GmbH Seite 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 10 ..................................................................................................................... 2

Windows 8.1 .................................................................................................................... 4

Windows 8 ....................................................................................................................... 6

Windows Vista/7 ............................................................................................................... 7

Windows Server 2016 .......................................................................................................... 8

Windows Server 2012 ...................................................................................................... 13

Windows Server 2003 / 2008 ............................................................................................ 17

Server 2003 .................................................................................................................... 18

Server 2008 .................................................................................................................... 19

WebApp ohne Unterpfad ausführen .................................................................................... 21

URL Rewrite Module 2.0 ................................................................................................... 21

Anpassungen am ASP Code ............................................................................................ 22

„DataFlex WebApp Check“ ................................................................................................ 22



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 "Stati-

scher Inhalt" unter "Allgemeine HTTP-Features" aktiviert ist.



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 An-

wendungspool > rechte Maustaste: Erweiterte Einstellungen



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:



Unter Windows 8.1 muss zusätzlich noch darauf geachtet werden, dass der Punkt "Sta-

tischer Inhalt" unter "Allgemeine HTTP-Features" aktiviert ist.

Für DataFlex muss auf 64 Bit Systemen bis zur DataFlex Version v18.2 die 32 Bit Unter-

stützung angeschaltet werden:

Suche: iis > Starten > Maschinen-Name aufklicken > Anwendungspools > Default An-

wendungspool > rechte Maustaste: Erweiterte Einstellungen



Windows 8

Systemsteuerung > Programme > Windows Features aktivieren / deaktivieren > Im Verzeichnisbaum folgende Sachen anklicken und öffnen: Internetinformationsdienste > WWW-Dienste > Anwendungs-entwicklungsfeatures 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-Mana-ger (zu finden unter Systemsteuerung > System und Sicher-heit) mit Doppelklick. Im linken Teil des Fensters „Verbin-dungen“ wählen, den kleinen Pfeil anklicken.

„Anwendungspools“ auswählen und ankli-cken. 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.



Windows Vista/7

Um ASP auf Ihrem IIS zu installieren, müssen Sie „Windows-Funktionen aktivieren oder deaktivie-ren“. 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.



Windows Server 2016

Unter Windows Server 2016 müssten Sie den zuerst den IIS installieren, indem Sie die entspre-chende Rolle hinzufügen



Wählen Sie den entsprechenden Server aus:

Und markieren Sie hier die Einstellungen für Web Server (IIS)



Vergessen Sie nicht, Unter Anwendungsentwicklung die ASP Option an zu klicken und unter Verwal-tungsprogramme die IIS 6-Metabasiskompatibilität zu aktivieren:



Die Installation des IIS und der benötigten Komponenten ist nun abgeschlossen. Bei 64 Bit Syste-men müssen Sie bei Verwendung von DataFlex 18.2 (und niedriger) die 32 Bit Unterstützung akti-vieren. 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



Der Parameter 32-Bit-Anwendungen wird auf True gesetzt.



Windows Server 2012

Unter Windows Server 2012 müssten Sie den zuerst den IIS installieren, indem Sie die entspre-chende Rolle hinzufügen

Wählen Sie den entsprechenden Server aus:



Und markieren Sie hier die Einstellungen für Web Server IIS

Vergessen Sie nicht, die Op-tion ASP mit anzuklicken:



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



Der Parameter 32-Bit-Anwendungen wird auf True gesetzt.



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 instal-liert wurde. Dies können Sie unter folgendem Fenster überprüfen und gegebenenfalls nachinstallie-ren:



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 >“



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.



Starten Sie zunächst den Internetinformations-dienste-Manager (zu finden unter Systemsteue-rung > Verwaltung). Im linken Teil „Verbindungen“ des Fensters, wählen Sie „Anwendungspools“ aus und rechtsklicken dort entweder auf Ihren „Defaul-tAppPool“, 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-Anwen-dungen aktivieren“ auf True.



WebApp ohne Unterpfad ausführen

Um eine WebApp so laufen zu lassen, dass sie nicht unter http://server/WebAppName sondern direkt unter http://server 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 in-stallieren lässt; URL Rewrite Module 2.0.

URL Rewrite Module 2.0 finden Sie unter https://www.iis.net/download/URLRewrite

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“ angespro-chen 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 Mus-ter 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.



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 <WebAppVirtualDi-

rectory> 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 ge-speichert werden und die WebApp selbst, die dann vom Hauptverzeichnis des Web-Servers aufgeru-fen 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

Documents

Einrichten des IIS (Internet Information Server) für ... · Unter Windows Server 2012 müssten Sie den zuerst den IIS installieren, indem Sie die entspre- chende Rolle hinzufügen