Überblick

Es wird hier beschrieben, wie ein Apache Webserver als Proxyserver für die Vertec Weboberfläche eingesetzt werden kann. Der Zugriff auf den Vertec Webserver via einen Proxyserver empfiehlt sich, wenn die Weboberfläche aus dem Internet erreichbar sein soll. Ausserdem erlaubt eine solche Konstellation die Verwendung von SSL Verschlüsselung via Apache. Das Konfigurationsbeispiel beschreibt eine Installation auf 2 Rechnern:

Vertec Server Rechner

interner Rechner, auf dem der Vertec Webserver läuft.

Apache Rechner

Webserver Rechner, öffentlich über http bzw. https erreichbar (z.B. in DMZ).

Anfragen an den Webserver unter einem bestimmten URL Pfad werden an den Vertec Server weitergeleitet (proxying).

Apache httpd.conf File

Folgende Einstellungen müssen im Konfigurationsfile von Apache (http.conf) vorgenommen werden. Diese Beschreibung setzt grundlegende Kenntnisse der Apache Konfiguration voraus.

Die Module mod_rewrite, proxy_http_module und mod_proxy sollten geladen sein.

Die Vertec Weboberfläche soll unter dem Pfad "vertecweb" eingebunden werden, der VertecServer läuft auf dem Rechner vertecserver auf Port 8095. Anstatt eines Hostnamen kann auch die IP Nummer des Vertec Servers angegeben werden. Der Webserver (Apache) sei unter www.mysite.com erreichbar. Die folgenden Zeilen im entsprechenden Bereich des httpd.conf (Location oder Virtualserver Abschnitt) bewirken die Umleitung von Anfragen an den Vertec Webserver:

RewriteEngine On
RewriteRule ^/vertecweb/(.*)$ http://vertecserver:8095/$1 [P]

Vertec.ini File

Damit die Seiten, die für die Weboberfläche generiert werden, die richtigen Link URLs erhalten, muss das Konfigurationsfile Vertec.ini von Vertec Server angepasst werden. Dieses befindet sich im Programmverzeichnis von VertecServer (=Verzeichnis in dem sich das verwendete VertecServer.exe befindet).

Verantwortlich für das Aussehen der generierten Links sind die beiden Werte Root URL und Protocol Version (siehe auch Webserver Einstellungen in Vertec.ini).

Root URL

gibt Hostname und Pfad für die generierten URLs an.

Protocol Version

kann http oder https (für SSL) sein. Default ist http.

Die folgende Konfiguration wäre geeignet, unsere Beispielsite mit SSL verschlüsselt zu betreiben. Die eigentliche SSL Konfiguration für Apache wird hier nicht beschrieben:

[Webserver]
Root URL=www.mysite.ch/vertecweb
Protocol Version=https

Wahlweiser Zugriff via http oder https auf die gleiche Instanz von VertecServer wird nicht unterstützt, da die Konfiguration von Protocol Version in Vertec.ini statisch ist und sich nicht nach der aktuell verwendeten URL richtet.

Test

1. Am Besten wird zuerst getestet, ob der VertecServer lokal erreichbar ist. Mit einem Webbrowser auf dem Vertec Server Rechner wird überprüft ob http://localhost:8095/) ansprechbar ist. Gewisse Teile der Seite werden ev. unvollständig sein, weil generierte URLs falsch sind. Die Link URLs können überprüft werden und sollten dem öffentlichen Zugang (https://www.mysite.com/vertecweb/...) entsprechen.
2. In einem zweiten Schritt kann das Proxying via Apache getestet werden. Diese Tests sollten auf dem Apache Rechner stattfinden und für unser Beispiel die URL http://vertecserver:8095/ verwenden. Falls der Vertec Server Host nicht erreicht werden kann, sollte dies vom Apache Rechner her unter Verwendung von "ping" (Test, ob Host erreichbar ist) untersucht werden. Naheliegende Problemquellen sind Firewall Einstellungen.