[Inteproxy-commits] r370 - trunk/server/doc/source
scm-commit at wald.intevation.org
scm-commit at wald.intevation.org
Thu Nov 12 21:50:18 CET 2015
Author: bjoern
Date: 2015-11-12 21:50:18 +0100 (Thu, 12 Nov 2015)
New Revision: 370
Modified:
trunk/server/doc/source/URLrewriting.rst
trunk/server/doc/source/anforderungen.rst
trunk/server/doc/source/conf.py
trunk/server/doc/source/download.rst
trunk/server/doc/source/ersterTest.rst
trunk/server/doc/source/gettingStarted.rst
trunk/server/doc/source/installApache.rst
trunk/server/doc/source/konfiguration.rst
trunk/server/doc/source/konfigurationsdateiInteProxy.rst
trunk/server/doc/source/konfigurationsdateiVirtualHost.rst
trunk/server/doc/source/linkliste.rst
trunk/server/doc/source/proxyRemote.rst
trunk/server/doc/source/versionsgeschichte.rst
trunk/server/doc/source/vorraussetzungen.rst
Log:
Updated docs for version 1.0.5.
Modified: trunk/server/doc/source/URLrewriting.rst
===================================================================
--- trunk/server/doc/source/URLrewriting.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/URLrewriting.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -1,18 +1,18 @@
-================================
-URL Rewriting in WMS Capabilites
-================================
+=================================
+URL Rewriting in WMS Capabilities
+=================================
Das URL Rewriting ersetzt die URLs in den ausgelieferten Daten des Inteproxy
Servers. So können beispielsweise die URL-Angaben in den OnlineResources des
-WMS Capabilites umgeschrieben werden.
+WMS Capabilities umgeschrieben werden.
-Vorraussetzungen
-----------------
+Voraussetzungen
+---------------
Das URL Rewriting benötigt die folgenden Apache-Module:
-- `mod_substitute <http://httpd.apache.org/docs/2.2/mod/mod_substitute.html>`_ (Modul erst ab Apache Version 2.2.7 verfügbar)
-- `mod_filter <http://httpd.apache.org/docs/2.2/mod/mod_filter.html>`_ (Modul erst ab Apache Version 2.1 verfügbar)
+- `mod_substitute <http://httpd.apache.org/docs/2.4/mod/mod_substitute.html>`_ (Modul erst ab Apache Version 2.2.7 verfügbar)
+- `mod_filter <http://httpd.apache.org/docs/2.4/mod/mod_filter.html>`_ (Modul erst ab Apache Version 2.1 verfügbar)
Konfiguration
@@ -21,8 +21,8 @@
Damit das URL Rewriting angewendet werden kann, müssen zu erst die benötigten
Module geladen werden. Bitte stellen Sie sicher das die benötigten Module in
der jeweiligen Konfiguration ``platform-*.conf`` für Ihre Apache-Umgebung
-korrekt eingetragen sind. Beispielsweise müssen für Windows 2003 in der Datei
-``platform-WindowsServer2003.conf`` folgende Zeilen stehen::
+korrekt eingetragen sind. Beispielsweise müssen für Windows Server 2008/2012 in der Datei
+``platform-WindowsServer.conf`` folgende Zeilen stehen::
LoadModule filter_module modules/mod_filter.so
LoadModule substitute_module modules/mod_substitute.so
@@ -30,28 +30,30 @@
Zusätzlich müssen in der VirtualHost Konfigurationsdatei ihrer Umgebung die
Apache `FilterProvider Direktive
-<http://httpd.apache.org/docs/2.2/mod/mod_filter.html#filterprovider>`_ und die
+<http://httpd.apache.org/docs/2.4/mod/mod_filter.html#filterprovider>`_ und die
Apache `FilterChain Direktive
-<http://httpd.apache.org/docs/2.2/mod/mod_filter.html#filterprovider>`_ gesetzt
-sein. Hier ein Beispiel für Windows 2003 in der Datei
-``inteproxy-WindowsServer2003.conf``::
+<http://httpd.apache.org/docs/2.4/mod/mod_filter.html#filterprovider>`_ gesetzt
+sein. Hier ein Beispiel für Windows 2008/2012 in der Datei ``inteproxy-WindowsServer.conf``::
- FilterProvider fixurls SUBSTITUTE \
- Content-Type "/(application\057vnd.ogc.wms_xml|text\057xml)($|;)/"
- FilterChain fixurls
+ FilterProvider fixurls SUBSTITUTE
+ "%{CONTENT_TYPE} = '/(application\057vnd.ogc.wms_xml|
+ application\057xml|application\057vnd.ogc.se_xml|
+ text\057xml|text\057plain|text\057html)($|;)/'"
+ FilterChain +fixurls
+
**Bitte beachten Sie**: Das die Konfiguration der Direktiven **keine**
Zeilenbrüche aufweisen dürfen. Die Zeilenbrüche dienen nur zur besseren
Lesbarkeit.
Diese beiden Direktiven definieren eine `filter chain` um die URLs in der WMS Capabilities Antwort um zuschreiben.
-**Wichtig**: Die WMS Capabilities Antworten müssen den MIME-Type/Content-Type ``application/vnd.ogc.wms_xml`` besitzen.
+**Wichtig**: Die WMS Capabilities Antworten müssen bspw. den MIME-Type/Content-Type ``application/vnd.ogc.wms_xml`` besitzen.
Für die Aktivierung des URL Rewritings muss mit Hilfe der Konfigurationsdatei
``inteproxy.cfg`` und mit dem Skript ``create-rewrite-rules.py`` mit der Option
``--server-prefix`` zusätzlich eine Apache `Substitute Direktive
-<http://httpd.apache.org/docs/2.2/mod/mod_substitute.html>`_ in der Datei ``inteproxy-rewrite.conf`` erstellt
+<http://httpd.apache.org/docs/2.4/mod/mod_substitute.html>`_ in der Datei ``inteproxy-rewrite.conf`` erstellt
werden. ::
./create-rewrite-rules.py --config-file=inteproxy.cfg \
@@ -64,9 +66,9 @@
Test
----
-Für einen einfachen Test, rufen Sie die folgenden URL (bsp. in einem Browser) auf::
+Für einen einfachen Test, rufen Sie die folgenden URL (bspw. in einem Browser) auf::
- http://<servername>:64609/inteproxy-demo.intevation.org/cgi-bin/frida-wms?
+ http://<servername>:64609/<dienst>?
Request=GetCapabilities&Service=WMS&Version=1.1.0
Nach der erfolgreicher Konfiguration des Inteproxy Servers sollten das WMS Capabilities die geänderten URLs enthalten.
Modified: trunk/server/doc/source/anforderungen.rst
===================================================================
--- trunk/server/doc/source/anforderungen.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/anforderungen.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -10,17 +10,18 @@
Der InteProxy Server benötigt einen aktuellen `Apache HTTP Server
<http://httpd.apache.org>`_ und die folgenden Apache-Module:
-- `mod_rewrite <http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html>`_
+- `mod_rewrite <http://httpd.apache.org/docs/2.4/mod/mod_rewrite.html>`_
- `mod_authz_host
- <http://httpd.apache.org/docs/2.2/mod/mod_authz_host.html>`_ (Modul erst ab Apache Version 2.1 verfügbar)
-- `mod_proxy <http://httpd.apache.org/docs/2.2/mod/mod_proxy.html>`_
+ <http://httpd.apache.org/docs/2.4/mod/mod_authz_host.html>`_ (Modul erst ab Apache Version 2.1 verfügbar)
+- `mod_proxy <http://httpd.apache.org/docs/2.4/mod/mod_proxy.html>`_
- `mod_proxy_http
- <http://httpd.apache.org/docs/2.2/mod/mod_proxy_http.html>`_
-- `mod_ssl <http://httpd.apache.org/docs/2.2/mod/mod_ssl.html>`_
-- `mod_proxy <http://httpd.apache.org/docs/2.2/mod/mod_proxy.html>`_ (Modul erst ab Apache Version 2.2.15 verfügbar)
- - `mod_substitute <http://httpd.apache.org/docs/2.2/mod/mod_substitute.html>`_ (Modul erst ab Apache Version 2.2.7 verfügbar)
- - `mod_filter <http://httpd.apache.org/docs/2.2/mod/mod_filter.html>`_ (Modul erst ab Apache Version 2.1 verfügbar)
+ <http://httpd.apache.org/docs/2.4/mod/mod_proxy_http.html>`_
+- `mod_ssl <http://httpd.apache.org/docs/2.4/mod/mod_ssl.html>`_
+- `mod_proxy <http://httpd.apache.org/docs/2.4/mod/mod_proxy.html>`_ (Modul erst ab Apache Version 2.2.15 verfügbar)
+ - `mod_substitute <http://httpd.apache.org/docs/2.4/mod/mod_substitute.html>`_ (Modul erst ab Apache Version 2.2.7 verfügbar)
+ - `mod_filter <http://httpd.apache.org/docs/2.4/mod/mod_filter.html>`_ (Modul erst ab Apache Version 2.1 verfügbar)
+
.. note::
In den Versionen größer oder gleich der Version 2.2.15 sind
@@ -31,9 +32,9 @@
weitere Anforderungen
=====================
-- `Python <http://www.python.org/>`_
+- `Python <https://www.python.org/>`_
- `lxml XML toolkit <http://lxml.de>`_
Für die Ausführung des ``create-rewrite-rules.py`` Skripts werden zusätzlich
-eine `Python <http://www.python.org/>`_-Umgebung und das Python-Paket `lxml
+eine `Python <https://www.python.org/>`_-Umgebung und das Python-Paket `lxml
<http://lxml.de/>`_ benötigt.
Modified: trunk/server/doc/source/conf.py
===================================================================
--- trunk/server/doc/source/conf.py 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/conf.py 2015-11-12 20:50:18 UTC (rev 370)
@@ -40,16 +40,16 @@
# General information about the project.
project = u'InteProxy Server'
-copyright = u'2010, Bjoern Schilberg'
+copyright = u'2010-2015, Bjoern Schilberg'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
-version = '1.0.4'
+version = '1.0.5'
# The full version, including alpha/beta/rc tags.
-release = '1.0.4'
+release = '1.0.5'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
@@ -93,7 +93,7 @@
# The theme to use for HTML and HTML Help pages. Major themes that come with
# Sphinx are currently 'default' and 'sphinxdoc'.
-html_theme = 'default'
+html_theme = 'classic'
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the
Modified: trunk/server/doc/source/download.rst
===================================================================
--- trunk/server/doc/source/download.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/download.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -19,13 +19,21 @@
.. code-block:: bash
- tar zxf InteProxy-SERVER-1.0.4.tar.gz -C /opt
+ unzip InteProxy-SERVER-1.0.5.zip -d /opt
+ mkdir -p /opt/InteProxy-SERVER-1.0.5/server/logs/
Installation unter Windows
==========================
Laden Sie den aktuellen InteProxy Server herunter und entpacken Sie den
-InteProxy Server in das Verzeichnis ``C:\Program Files\Apache Software
-Foundation\Apache2.2\conf``.
+InteProxy Server in das Verzeichnis ``C:\Apache24\conf``.
+Erstellen Sie zusätlich das Unterverzeichnis `logs` im Verzeichnis
+
+``C:\Apache24\conf\InteProxy-SERVER-1.0.5\server``.
+
+Bspw. in der Windows PowerShell mittels
+
+``mkdir C:\Apache24\conf\InteProxy-SERVER-1.0.5\server\logs``.
+
Modified: trunk/server/doc/source/ersterTest.rst
===================================================================
--- trunk/server/doc/source/ersterTest.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/ersterTest.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -4,28 +4,30 @@
Testen von InteProxy Server
===========================
Der InteProxy Server bietet die Möglichkeit als normaler HTTP-Web-Proxy zu
-arbeiten. Im Folgenden wird die Betriebsart als HTTP-Web-Proxy an Beispielen
+arbeiten. Im Folgenden wird die Betriebsart als HTTP-Web-Proxy
inklusive Konfigurationsschritten vorgestellt.
Nutzerdaten
-----------
-Um die Anwendungsbeispiele gegen den hier beschriebenen Demoserver zu nutzen,
-stehen Ihnen die folgenden Nutzerdaten im OWSProxy zur Verfügung. Server-URL:
-::
+Das folgende Anwendungsbeispiel zeigt die Nutzung der Dienste des VKV-Mapserver
+des Landesamtes für Geoinformation und Landesvermessung Niedersachsen
+Landesvermessung und Geobasisinformation (LGLN). Die Dienste sind aufzurufen mit: ::
+
+ www.geobasisdaten.niedersachsen.de/mapgate/(Dienst)?
- http://inteproxy-demo.intevation.org/cgi-bin/frida-wms
+Bei Verwendung des InteProxy ist ``http://<servername>:64609/`` voranzustellen.
-Zwei Benutzerkonten stehen bereit:
- * User/Passwort = ``meier``/``meier``: Darf alle WMS Ebenen anschauen
- * User/Passwort = ``schmidt``/``schmidt``: Darf alle WMS Ebenen anschauen, außer den Straßen.
+Die Bezeichnung des Dienstes ist aus der ``Kundeninfo über die verfügbaren
+Dienste`` der LGLN zu entnehmen.
-Die Nuterdaten für das Benutzerkonto ``meier`` sind bereits in der Datei
-:file:`inteproxy.cfg` eingetragen.
+Die Nuterdaten/Kennungen für das Benutzerkonto sind in der Datei
+:file:`inteproxy-rewrite.conf` einzutragen.
+
Nutzung von InteProxy Server
----------------------------
Stellen Sie in Ihrer Anwendung der eigentlichen URL
-Text ``http://servername:64609/`` voran. Dadurch wird der angefragte WMS-Dienst
+den Text ``http://<servername>:64609/`` voran. Dadurch wird der angefragte WMS-Dienst
explizit durch InteProxy Server angesprochen und abgesichert.
Einfacher Funktionstest (über Web-Browser)
@@ -33,29 +35,29 @@
Mit diesem Test wird geprüft, ob der InteProxy Server grundsätzlich bei Ihnen
funktioniert und auch nicht durch Firewalls blockiert wird. Stellen Sie
-sicher, dass InteProxy Server gestartet ist. Um zu testen, ob der InteProxy
+sicher, dass InteProxy Server gestartet ist.
+
+Das folgende Beispiel zeigt einen GetCapabilities-Aufruf des Dienstes ``farbe``
+bei Verwendung des InteProxy.
+
+Um zu testen, ob der InteProxy
Server korrekt funktioniert, öffnen Sie einen Web-Browser und geben Sie
-folgende URL ein: ::
+folgende URL ein. ::
- http://servername:64609/inteproxy-demo.intevation.org/cgi-bin/frida-wms?
- Request=GetMap
- &Version=1.1.1&service=WMS
- &layers=strassenall,sehenswuerdigkeiten
- &format=image/png&width=200&height=200
- &srs=epsg:31467&bbox=3427000,5787590,3444000,5800880
+ http://<servername>:64609/www.geobasisdaten.niedersachsen.de/mapgate/farbe?
+ SERVICE=WMS&REQUEST=GetCapabilities&VERSION=1.1.1
Der Browser stellt die Anfrage zunächst an InteProxy Server, welcher auf Port
-64609 auf dem Server auf Anfragen wartet. Nach Eingabe sollte im Browser dann
-eine Karte der Stadt Osnabrück erscheinen, denn der InteProxy Server führt die
-eigentliche nachfolgende WMS-Anfrage an den abgesicherten Dienst aus: ::
+64609 auf dem Server ``<servername>`` auf Anfragen wartet. Nach Eingabe sollte
+im Browser dann ein WMS-GetCapabilities-Dokument erscheinen/zum Speichern
+angeboten werden. Denn der InteProxy Server führt die eigentliche nachfolgende
+WMS-Anfrage an den abgesicherten Dienst aus: ::
- https://inteproxy-demo.intevation.org/cgi-bin/frida-wms?VERSION=1.1.1
- &SERVICE=WMS&REQUEST=GetMap&layers=strassenall,sehenswuerdigkeiten
- &format=image/png&width=200&height=200
- &srs=epsg:31467&bbox=3427000,5787590,3444000,5800880
- &user=meier&password=meier
+ https://www.geobasisdaten.niedersachsen.de/mapgate/farbe?SERVICE=WMS
+ &REQUEST=GetCapabilities&VERSION=1.1.1
+ &user=USERNAME&password=PASSWORT
-Insbesondere wird natürlich nun über das sichere Protokoll „https“ und
-nicht mehr über„http“ kommuniziert. Darüber hinaus hängt der InteProxy
+Insbesondere wird natürlich nun über das sichere Protokoll ``https`` und
+nicht mehr über ``http`` kommuniziert. Darüber hinaus hängt der InteProxy
Server die ihm bekannten Credentials
-``user=meier&passwort=meier`` an die sichere URL an.
+``user=USERNAME&password=PASSWORT`` an die sichere URL an.
Modified: trunk/server/doc/source/gettingStarted.rst
===================================================================
--- trunk/server/doc/source/gettingStarted.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/gettingStarted.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -18,7 +18,7 @@
==========================================
Für den Einsatz des InteProxy Servers benötigen Sie einen **aktuellen** Apache
-HTTP Server (**mindestens Version 2.2.15**).
+HTTP Server (**mindestens Version 2.4**).
|more| Weitere Informationen zur Installation finden Sie im Kapitel
:ref:`Installation Apache HTTP Server <installApache>`.
@@ -32,15 +32,15 @@
Installationspaket.
|more| Weitere Informationen zu der Installation erhalten Sie im Kapitel
-:ref:`Installation InteProxy Server <installation>`.
+:ref:`Installation InteProxy Server <download>`.
Schritt 3: Konfiguration InteProxy Server
=========================================
-Der InterProxy Server wird als separater `VirtualHost
-<http://httpd.apache.org/docs/2.2/mod/core.html#virtualhost>`_ betrieben.
+Der InteProxy Server wird als separater `VirtualHost
+<http://httpd.apache.org/docs/2.4/mod/core.html#virtualhost>`_ betrieben.
Hierzu konfigurieren Sie den InteProxy Server im Kontext der Apache HTTP
Server Konfiguration.
@@ -73,7 +73,7 @@
.. code-block:: bash
- /etc/init.d/apache2 reload
+ service apache2 reload
Windows
-------
@@ -92,11 +92,11 @@
.. code-block:: bash
- http://<servername>:64609/inteproxy-demo.intevation.org/cgi-bin/frida-
- wms?Request=GetCapabilities&Service=WMS&Version=1.1.0
+ http://<servername>:64609/www.geobasisdaten.niedersachsen.de/mapgate/farbe?
+ SERVICE=WMS&REQUEST=GetCapabilities&VERSION=1.1.1
Erhalten Sie ein Capabilities Dokument des abgesicherten Beispiel WMS Dienstes,
-haben Sie den InterProxy Server erfolgreich installiert. Herzlichen
+haben Sie den InteProxy Server erfolgreich installiert. Herzlichen
Glückwunsch! Sie können nun weitere abgesicherte OGC Web Services hinzufügen.
|more| Weitere Erläuterungen zum Testen des InteProxy Servers finden Sie im
Modified: trunk/server/doc/source/installApache.rst
===================================================================
--- trunk/server/doc/source/installApache.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/installApache.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -4,16 +4,16 @@
Installation Apache HTTP Server
===============================
-Für den Einsatz des InteProxy Servers wird **mindestens** die Version 2.2.15
+Für den Einsatz des InteProxy Servers wird **mindestens** die Version 2.4
des Apache HTTP Servers vorausgesetzt. Für die einzelnen Distributionen wie
-Debian, SuSE oder Windows Server erhalten Sie in den nachfolgenden Abschnitten
+Debian, openSUSE oder Windows Server erhalten Sie in den nachfolgenden Abschnitten
detailierter Hinweise zur Installation des Apache HTTP Servers.
Debian
======
-Für den Einsatz des InteProxy Servers unter Debian wird die Version 6.0 (Debian
-Squeeze) empfohlen.
+Für den Einsatz des InteProxy Servers unter Debian wird die Version 8.0 (Debian
+Jessie) empfohlen.
Zum Installieren des Apache HTTP Server über die Kommandozeile, führen Sie den
folgenden Befehl aus:
@@ -22,104 +22,49 @@
apt-get install apache2
-.. note::
-
- Für den Einsatz unter Debian Lenny (Version 5.0) ist der Apache HTTP
- Server aus dem Debian Lenny Backports Repository zu installieren.
+.. note::
+ Für den Einsatz unter Debian Squeeze (Version 6.0) oder Debian Wheezy (Version 7.0) verwenden Sie
+ bitte den Inteproxy Server in der Version 1.0.4.
-SuSE
-====
+openSUSE
+--------
-SUSE Linux Enterprise Server 11
--------------------------------
+Für den Einsatz des InteProxy Servers unter openSUSE ist mindestens die Version
+13.1 erforderlich.
-Für den Einsatz des InteProxy Servers unter SUSE Linux Enterprise Server 11
-ist die Installation des aktuellen Apache Paketes aus dem ``Up-to-date Apache
-packages (SLE_11)`` Repository erforderlich.
+Installieren Sie den Apache HTTP Server mit Hilfe des
+Kommandozeilenwerkzeuges ``zypper``:
-Fügen Sie dazu das ``Apache.repo``, mit Hilfe des Kommandozeilenwerkzeuges ``zypper``
-der Paketverwaltung, wie folgt hinzu:
-
.. code-block:: bash
- zypper ar http://download.opensuse.org/repositories/Apache/SLE_11/ "Apache.repo"
-
-Die Pakete des ``Apache.repo`` sind mit einem Schlüssel signiert. Fügen Sie
-diesen Schlüssel - nach einer Verifizierung der Korrektheit des Schlüssels -
-mit folgendem Befehl hinzu:
-
-.. code-block:: bash
-
- curl -O http://download.opensuse.org/repositories/Apache/SLE_11/repodata/repomd.xml.key
- rpm --import repomd.xml.key
-
-
-Installieren Sie nun den Apache HTTP Server:
-
-.. code-block:: bash
-
zypper install apache2
+.. note::
-SUSE Linux Enterprise Server 10
--------------------------------
+ Für den Einsatz unter openSUSE 11.3 verwenden Sie
+ bitte den Inteproxy Server in der Version 1.0.4.
-Für den Einsatz des InteProxy Servers unter SUSE Linux Enterprise Server 10
-ist die Installation des aktuellen Apache Paketes aus dem ``Up-to-date Apache
-packages (SLE_10)`` Repository erforderlich.
-Fügen Sie das ``Apache.repo``, mit Hilfe des Kommandozeilenwerkzeuges ``zypper``
-der Paketverwaltung wie folgt hinzu:
+Windows Server 2008 / 2012
+==========================
-.. code-block:: bash
+Für den Einsatz des InteProxy Servers unter Windows Server 2008 / 2012 wird ein
+aktueller Apache HTTP Server 2.4.x mit SSL Unterstützung benötigt. Diesen
+können Sie beispielsweise auf der Seite `Apache Haus Downloads
+<https://www.apachehaus.com/cgi-bin/download.plx>`_ herunterladen.
- zypper ar http://download.opensuse.org/repositories/Apache/SLE_10/ "Apache.repo"
+.. note::
-Die Pakete des ``Apache.repo`` sind mit einem Schlüssel signiert. Fügen Sie
-diesen Schlüssel - nach einer Verifizierung der Korrektheit des Schlüssels -
-mit folgendem Befehl hinzu::
+ Es wird ein Apache 2.4 Server Binary in der Ausführung ``Apache 2.4.x VC11`` benötigt.
- curl -O http://download.opensuse.org/repositories/Apache/SLE_10/repodata/repomd.xml.key
- rpm --import repomd.xml.key
+Folgen Sie zur Installation bitte der Installations-Anweisung des Projektes.
+Weitere Informationen zur allgemeinen Konfiguration und Betrieb des Apache HTTP
+Server finden Sie in der Apache Dokumentation `Using Apache with Microsoft
+Windows <http://httpd.apache.org/docs/2.4/platform/windows.html>`_.
-
-Installieren Sie nun den Apache HTTP Server:
-
-.. code-block:: bash
-
- zypper install apache2
-
-
-
-OpenSUSE
---------
-
-Für den Einsatz des InteProxy Servers unter OpenSUSE ist mindestens die Version
-11.3 erforderlich. Ältere OpenSUSE Versionen werden nicht unterstützt.
-
-Installieren Sie den Apache HTTP Server mit Hilfe des
-Kommandozeilenwerkzeuges ``zypper``:
-
-.. code-block:: bash
-
- zypper install apache2
-
-
-Windows Server
-==============
-
-Für den Einsatz des InteProxy Servers unter Windows Server wird ein aktueller
-Apache HTTP Server mit SSL Unterstützung benötigt. Diesen können Sie auf der
-Seite `Downloading the Apache HTTP Server
-<http://httpd.apache.org/download.cgi>`_ des Apache HTTP Server Projektes
-herunterladen.
-
.. note::
- Es wird das MSI-Paket ``Win32 Binary including OpenSSL`` benötigt.
-Installieren Sie den Apache HTTP Server mit Hilfe des Windows
-Installers. Weitere Informationen zur Installation des Apache HTTP Server
-finden Sie in der Apache Dokumentation `Using Apache with Microsoft
-Windows <http://httpd.apache.org/docs/2.2/platform/windows.html>`_.
+ Für den Einsatz unter Windows Server 2003 verwenden Sie
+ bitte den Inteproxy Server in der Version 1.0.4.
Modified: trunk/server/doc/source/konfiguration.rst
===================================================================
--- trunk/server/doc/source/konfiguration.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/konfiguration.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -12,19 +12,19 @@
Einrichten des VirtualHosts
---------------------------
-Der InterProxy Server wird als separater `VirtualHost
-<http://httpd.apache.org/docs/2.2/mod/core.html#virtualhost>`_ betrieben,
+Der InteProxy Server wird als separater `VirtualHost
+<http://httpd.apache.org/docs/2.4/mod/core.html#virtualhost>`_ betrieben,
erstellen Sie hierfür eine symbolische Verknüpfung auf die InteProxy Server
VHost-Konfigurationsdatei
-:file:`/opt/InteProxy-SERVER-1.0.4/server/conf/inteproxy.conf` in dem
+:file:`/opt/InteProxy-SERVER-1.0.5/server/conf/inteproxy.conf` in dem
entsprechenden Apache Verzeichnis.
.. note::
Das Setzen der symbolischen Verknüpfung ist abhängig von der eingesetzten Distribution.
- - **Debian**: ``ln -s /opt/InteProxy-SERVER-1.0.4/server/conf/inteproxy.conf /etc/apache2/sites-available/inteproxy.conf``
- - **SuSE**: ``ln -s /opt/InteProxy-SERVER-1.0.4/server/conf/inteproxy.conf /etc/apache2/vhosts.d/inteproxy.conf``
+ - **Debian**: ``ln -s /opt/InteProxy-SERVER-1.0.5/server/conf/inteproxy.conf /etc/apache2/sites-available/inteproxy.conf``
+ - **SuSE**: ``ln -s /opt/InteProxy-SERVER-1.0.5/server/conf/inteproxy.conf /etc/apache2/vhosts.d/inteproxy.conf``
|more| Eine detailierte Erläuterung der VirtualHost Konfigurationsdatei finden
Sie im Kapitel :ref:`VirtualHost Konfigurationsdatei <vhost>`.
@@ -55,17 +55,17 @@
Für den Betrieb des InteProxy Servers werden bestimmte Apache Module benötigt.
Um diese Module zu laden, entfernen Sie in der InteProxy Server
VHost-Konfigurationsdatei
-:file:`/opt/InteProxy-SERVER-1.0.4/server/conf/inteproxy.conf` den Kommentar
+:file:`/opt/InteProxy-SERVER-1.0.5/server/conf/inteproxy.conf` den Kommentar
vor der ``Include``-Zeile, die Ihrer Distribution entspricht. Nachfolgend sehen
Sie ein Beispiel für das Einbinden der benötigten Apache Module unter Debian.
.. code-block:: apache
## Apache Module for SuSE
- #Include /opt/InteProxy-SERVER-1.0.4/server/conf/platform-suse.conf
+ #Include /opt/InteProxy-SERVER-1.0.5/server/conf/platform-suse.conf
# Apache Module for Debian
- Include /opt/InteProxy-SERVER-1.0.4/server/conf/platform-debian.conf
+ Include /opt/InteProxy-SERVER-1.0.5/server/conf/platform-debian.conf
|more| Welche konkreten Apache Module benötigt werden, erfahren Sie im Kapitel
:ref:`Anforderungen <anforderungen>`.
@@ -77,7 +77,7 @@
Befindet sich der InteProxy Server im Intranet hinter einem Proxy zum
Internet, muss dieser eingerichtet werden, damit Anfragen in das Internet
weitergeleitet werden können.
-Das geschieht in der Datei :file:`/opt/InteProxy-SERVER-1.0.4/server/conf/inteproxy.conf`.
+Das geschieht in der Datei :file:`/opt/InteProxy-SERVER-1.0.5/server/conf/inteproxy.conf`.
.. code-block:: apache
@@ -112,12 +112,11 @@
Einrichten des VirtualHosts
---------------------------
-Um den InterProxy Server als seperaten `VirtualHost
+Um den InteProxy Server als seperaten `VirtualHost
<http://httpd.apache.org/docs/2.0/mod/core.html#virtualhost>`_ zu betreiben,
-ergänzen Sie am Ende der Datei :file:`C:\\Program Files\\Apache Software
-Foundation\\Apache2.2\\conf` die folgende Zeile: ::
+ergänzen Sie am Ende der Datei :file:`C:\\Apache24\\conf\\httpd.conf` die folgende Zeile: ::
- Include conf/InteProxy-SERVER-1.0.4/server/conf/inteproxy-WindowsServer2003.conf
+ Include conf\InteProxy-SERVER-1.0.5\server\conf\inteproxy-WindowsServer.conf
|more| Eine detailierte Erläuterung der VirtualHost Konfigurationsdatei finden
Sie im Kapitel :ref:`VirtualHost Konfigurationsdatei <vhost>`.
@@ -128,7 +127,7 @@
Der InteProxy Server nimmt Anfragen auf der Portnummer ``64609`` entgegen.
Ergänzen Sie die InteProxy Server Portnummer, im Kontext der Apache HTTP
Server-Konfiguration, in dem Sie die folgende Zeile in der Datei
-:file:`C:\\Programme\\Apache Group\\Apache2\\conf\\httpd.conf` hinzufügen:
+:file:`C:\\Apache24\\conf\\httpd.conf` hinzufügen:
.. code-block:: apache
@@ -138,14 +137,14 @@
--------------------------------------
-Für den Betrieb von InteProxy Server unter Windows sind die benötigten
+Für den Betrieb von InteProxy Server unter Windows Server 2008/2012 sind die benötigten
Module bereits vorkonfiguriert. Diese stehen in der Datei
-`conf/InteProxy-SERVER-1.0.4/server/conf/platform-WindowsServer2003.conf`.
+`conf/InteProxy-SERVER-1.0.5/server/conf/platform-WindowsServer.conf`.
.. code-block:: apache
# Apache Module für Windows Server
- Include "conf/InteProxy-SERVER-1.0.4/server/conf/platform-WindowsServer2003.conf"
+ Include "conf/InteProxy-SERVER-1.0.5/server/conf/platform-WindowsServer.conf"
|more| Welche konkreten Apache Module benötigt werden, erfahren Sie im Kapitel
:ref:`Anforderungen <anforderungen>`.
@@ -157,7 +156,7 @@
Befindet sich der InteProxy Server im Intranet hinter einem Proxy zum
Internet, muss dieser eingerichtet werden, damit Anfragen in das Internet
weitergeleitet werden können.
-Das geschieht in der Datei :file:`inteproxy-WindowsServer2003.cong`:
+Das geschieht in der Datei :file:`inteproxy-WindowsServer.conf`:
.. code-block:: apache
@@ -178,10 +177,13 @@
------------------------
Testen Sie die Konfiguration auf syntaktische Korrektheit, bevor Sie die
-Konfigurationsdateien neu laden. Verwenden Sie hierzu das Programm ``Test
-Configuration`` aus ``Programme -> Apache HTTP Server 2.x.x -> Configure Apache
-Server``.
+Konfigurationsdateien neu laden. Bspw. auf der Eingabeaufforderung oder in der
+Windows PowerShell mittels: ::
+ C:\Apache24\bin\httpd.exe -t
+
+
+
.. |more| image:: images/more.png
:align: middle
:alt: mehr Infos
Modified: trunk/server/doc/source/konfigurationsdateiInteProxy.rst
===================================================================
--- trunk/server/doc/source/konfigurationsdateiInteProxy.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/konfigurationsdateiInteProxy.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -145,7 +145,7 @@
.. code-block:: bash
- /etc/init.d/apache2 reload
+ service apache2 reload
Wird beim Ausführen des Python-Skriptes ``create-rewrite-rules.py`` keine
Konfigurationsdatei angegeben, wird nach der Datei ``inteproxy.cfg`` im
Modified: trunk/server/doc/source/konfigurationsdateiVirtualHost.rst
===================================================================
--- trunk/server/doc/source/konfigurationsdateiVirtualHost.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/konfigurationsdateiVirtualHost.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -4,23 +4,23 @@
VirtualHost Konfigurationsdatei
===============================
-Der InterProxy Server wird als separater `VirtualHost
-<http://httpd.apache.org/docs/2.2/mod/core.html#virtualhost>`_ betrieben, die
+Der InteProxy Server wird als separater `VirtualHost
+<http://httpd.apache.org/docs/2.4/mod/core.html#virtualhost>`_ betrieben, die
Konfiguration des VirtualHost erfolgt in der Datei
-:file:`/opt/InteProxy-SERVER-1.0.4/server/conf/inteproxy.conf`.
+:file:`/opt/InteProxy-SERVER-1.0.5/server/conf/inteproxy.conf`.
Die Inhalte der Datei :file:`inteproxy.conf` werden in dem folgenden Block
-erläutert; sie bezieht sich auf GNU/Linux-Systeme. Windows-Benutzer nehmen
-entsprechend die Datei :file:`inteproxy-WindowsServer2003.conf`
+erläutert; sie bezieht sich auf GNU/Linux-Systeme. Windows-Server-Benutzer nehmen
+entsprechend die Datei :file:`inteproxy-WindowsServer.conf`
.. code-block:: apacheconf
<VirtualHost *:64609>
ServerAdmin name at domain.de
- DocumentRoot /opt/InteProxy-SERVER-1.0.4/server
+ DocumentRoot /opt/InteProxy-SERVER-1.0.5/server
- TransferLog /opt/InteProxy-SERVER-1.0.4/server/logs/access_log
+ TransferLog /opt/InteProxy-SERVER-1.0.5/server/logs/access_log
| **# ZWINGEND ERFORDERLICH! Benötigte Module laden!**
| **# Zum Laden der benötigten Apache Module entfernen Sie den Kommentar**
@@ -29,13 +29,13 @@
.. code-block:: apacheconf
## Apache Module für SuSE
- #Include /opt/InteProxy-SERVER-1.0.4/server/conf/platform-suse.conf
+ #Include /opt/InteProxy-SERVER-1.0.5/server/conf/platform-suse.conf
## Apache Module für Debian
- #Include /opt/InteProxy-SERVER-1.0.4/server/conf/platform-debian.conf
+ #Include /opt/InteProxy-SERVER-1.0.5/server/conf/platform-debian.conf
## Apache Module für Windows Server
- #Include "conf/InteProxy-SERVER-1.0.4/server/conf/platform-WindowsServer2003.conf"
+ #Include "conf/InteProxy-SERVER-1.0.5/server/conf/platform-WindowsServer.conf"
# Intranet Proxy
ProxyRemote * http://intranet.proxy:8080
@@ -43,8 +43,12 @@
.. code-block:: apacheconf
RewriteEngine On
- # RewriteLogLevel 0
- RewriteLog /opt/InteProxy-SERVER-1.0.4/server/logs/rewrite.log
+
+ # Using a high trace log level for mod_rewrite will slow down your Apache HTTP
+ # Server dramatically! Use a log level higher than trace2 only for debugging!
+ # http://httpd.apache.org/docs/current/mod/mod_rewrite.html#Logging
+
+ LogLevel alert rewrite:alert
.. code-block:: apacheconf
@@ -58,11 +62,23 @@
.. code-block:: apacheconf
- FilterProvider gzinflate INFLATE resp=Content-Encoding $gzip
- FilterProvider fixurls SUBSTITUTE
- Content-Type "/(application\057vnd.ogc.wms_xml|text\057xml)($|;)/"
- FilterProvider gzdeflate DEFLATE
- Content-Type "/(application\057vnd.ogc.wms_xml|text\057xml)($|;)/"
+ LogLevel alert filter:alert
+
+
+ FilterProvider gzinflate INFLATE "%{resp:Content-Encoding} =~ /gzip/"
+
+ FilterProvider fixurls SUBSTITUTE "%{CONTENT_TYPE} =~ /(application\057vnd.ogc.wms_xml|
+ application\057xml|
+ application\057vnd.ogc.se_xml|
+ text\057xml|text\057plain|
+ text\057html)($|;)/"
+
+ FilterProvider gzdeflate DEFLATE "%{CONTENT_TYPE} =~ /(application\057vnd.ogc.wms_xml|
+ application\057xml|
+ application\057vnd.ogc.se_xml|
+ text\057xml|text\057plain|
+ text\057html)($|;)/"
+
FilterChain +gzinflate +fixurls +gzdeflate
.. code-block:: apacheconf
@@ -71,7 +87,7 @@
# aktuelle InteProxy Funktionalität. Sollte die Datei nicht existieren, lesen
# Sie im Kapitel 10 wie Sie diese erstellen können.
- Include /opt/InteProxy-SERVER-1.0.4/server/conf/inteproxy-rewrite.conf
+ Include /opt/InteProxy-SERVER-1.0.5/server/conf/inteproxy-rewrite.conf
.. code-block:: apacheconf
@@ -84,8 +100,7 @@
# URLs zugreifen, die mit / beginnen.
<Directory />
- Order Deny,Allow
- Deny from All
+ Require all denied
</Directory>
.. code-block:: apacheconf
Modified: trunk/server/doc/source/linkliste.rst
===================================================================
--- trunk/server/doc/source/linkliste.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/linkliste.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -2,20 +2,20 @@
Linkliste
=========
- * http://archive.apache.org/dist/httpd/binaries/win32/ (Apache HTTP Server Archive für historische win32 Versionen)
- * http://codespeak.net/lxml/
+ * https://www.apachehaus.com/cgi-bin/download.plx (Apache 2.4 Server Binaries von Apache Haus Downloads)
+ * http://lxml.de/
* http://httpd.apache.org (Apache HTTP Server)
- * http://httpd.apache.org/docs/2.2/mod/core.html (Apache Core Features)
- * http://httpd.apache.org/docs/2.2/mod/mod_auth_basic.html (Apache Module mod_auth_basic)
- * http://httpd.apache.org/docs/2.2/mod/mod_authz_host.html (Apache Module mod_authz_host)
- * http://httpd.apache.org/docs/2.2/mod/mod_filter.html (Apache Module mod_filter)
- * http://httpd.apache.org/docs/2.2/mod/mod_proxy.html (Apache Module mod_proxy)
- * http://httpd.apache.org/docs/2.2/mod/mod_proxy_http.html (Apache Module mod_proxy_http)
- * http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html (Apache Module mod_rewrite)
- * http://httpd.apache.org/docs/2.2/mod/mod_ssl.html (Apache Module mod_ssl)
- * http://httpd.apache.org/docs/2.2/mod/mod_substitute.html (Apache Module mod_substitute)
+ * http://httpd.apache.org/docs/2.4/mod/core.html (Apache Core Features)
+ * http://httpd.apache.org/docs/2.4/mod/mod_auth_basic.html (Apache Module mod_auth_basic)
+ * http://httpd.apache.org/docs/2.4/mod/mod_authz_host.html (Apache Module mod_authz_host)
+ * http://httpd.apache.org/docs/2.4/mod/mod_filter.html (Apache Module mod_filter)
+ * http://httpd.apache.org/docs/2.4/mod/mod_proxy.html (Apache Module mod_proxy)
+ * http://httpd.apache.org/docs/2.4/mod/mod_proxy_http.html (Apache Module mod_proxy_http)
+ * http://httpd.apache.org/docs/2.4/mod/mod_rewrite.html (Apache Module mod_rewrite)
+ * http://httpd.apache.org/docs/2.4/mod/mod_ssl.html (Apache Module mod_ssl)
+ * http://httpd.apache.org/docs/2.4/mod/mod_substitute.html (Apache Module mod_substitute)
* http://inteproxy.wald.intevation.org (InteProxy - Security extension for unsecure OWS clients to secure spatial data infrastructures)
* http://www.debian.org/ (Debian GNU/Linux)
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html (GNU General Public License, version 2)
- * http://www.python.org/ (Python Programming Language)
+ * https://www.python.org/ (Python Programming Language)
* https://wiki.deegree.org/deegreeWiki/iGeoSecurity (iGeoSecurity - short description of iGeoSecurity)
Modified: trunk/server/doc/source/proxyRemote.rst
===================================================================
--- trunk/server/doc/source/proxyRemote.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/proxyRemote.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -7,9 +7,9 @@
Müssen Anfragen über einen Proxy Server, welcher sich im Intranet befindet,
nach außen durch eine Firewall geleitet werden, *muss* hierzu die Direktive
`ProxyRemote
-<http://httpd.apache.org/docs/2.2/mod/mod_proxy.html#proxyremote>`_ verwendet
+<http://httpd.apache.org/docs/2.4/mod/mod_proxy.html#proxyremote>`_ verwendet
werden. Die Direktive `ProxyRemote` benötigt das Apache-Module `mod_proxy
-<http://httpd.apache.org/docs/2.2/mod/mod_proxy.html>`_.
+<http://httpd.apache.org/docs/2.4/mod/mod_proxy.html>`_.
Die Direktive `ProxyRemote` leitet Proxy-Anfragen, die der lokale Proxy empfangen
hat, an einen anderen Proxy-Server weiter.
Modified: trunk/server/doc/source/versionsgeschichte.rst
===================================================================
--- trunk/server/doc/source/versionsgeschichte.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/versionsgeschichte.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -2,8 +2,16 @@
Versionsgeschichte
==================
-Aktuell ist Version 1.0.4 vom 16. Juni 2011.
+Aktuell ist Version 1.0.5 vom 13. November 2015.
+Neu seit Version 1.0.5 vom 13. November 2015
+--------------------------------------------
+ * Anpassung: Konfigurationsdateien und Dokumentation für den Einsatz des
+ InteproxyServers unter Debian 8, openSUSE 13, Windows Server 2008 Standard und
+ Windows Server 2012 Server Standard. Diese Version ist ausschließlich für
+ die zuvor genannten Betriebssysteme zu verwenden. Für älter Versionen verwenden
+ Sie bitte die Version 1.0.4.
+
Neu seit Version 1.0.4 vom 16. Juni 2011
----------------------------------------
* Erweiterung: Überarbeitung der Dokumentation zu InteProxy Server.
Modified: trunk/server/doc/source/vorraussetzungen.rst
===================================================================
--- trunk/server/doc/source/vorraussetzungen.rst 2013-06-27 12:52:52 UTC (rev 369)
+++ trunk/server/doc/source/vorraussetzungen.rst 2015-11-12 20:50:18 UTC (rev 370)
@@ -4,6 +4,6 @@
Für den Betrieb des InteProxy Servers benötigen Sie,
-* einen aktuellen Apache HTTP Server (mindestens Version 2.2.15),
+* einen aktuellen Apache HTTP Server (mindestens Version 2.4),
* eine Python-Umgebung (optional),
-* das *lxml XML toolkit* für Python.
+* das *lxml XML toolkit* für Python (optional).
More information about the Inteproxy-commits
mailing list