[Inteproxy-commits] r306 - in trunk: . server/doc/source

Fri May 27 13:42:38 CEST 2011

Author: sholl
Date: 2011-05-27 13:42:36 +0200 (Fri, 27 May 2011)
New Revision: 306

Modified:
   trunk/ChangeLog
   trunk/server/doc/source/anforderungen.rst
   trunk/server/doc/source/ersterTest.rst
   trunk/server/doc/source/konfiguration.rst
   trunk/server/doc/source/konfigurationsdateiInteProxy.rst
   trunk/server/doc/source/konfigurationsdateiVirtualHost.rst
   trunk/server/doc/source/proxyRemote.rst
   trunk/server/doc/source/versionsgeschichte.rst
Log:
* konfigurationsdateiVirtualHost.rst,
  konfiguration.rst,
  konfigurationsdateiInteProxy.rst,
  proxyRemote.rst,
  anforderungen.rst,
  versionsgeschichte.rst,
  ersterTest.rst: Added some wording, fixed some information.
  Better readable now howfully.




Modified: trunk/ChangeLog
===================================================================

--- trunk/ChangeLog	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/ChangeLog	2011-05-27 11:42:36 UTC (rev 306)
@@ -1,3 +1,14 @@
+2011-05-27  Stephan Holl  <stephan.holl at intevation.de>
+
+	* konfigurationsdateiVirtualHost.rst,
+	  konfiguration.rst,
+	  konfigurationsdateiInteProxy.rst,
+	  proxyRemote.rst,
+	  anforderungen.rst,
+	  versionsgeschichte.rst,
+	  ersterTest.rst: Added some wording, fixed some information.
+	  Better readable now howfully.
+
 2011-05-27  Bjoern Schilberg <bjoern.schilberg at intevation.de>
 
 	* M server/doc/source/installApache.rst,

Modified: trunk/server/doc/source/anforderungen.rst
===================================================================
--- trunk/server/doc/source/anforderungen.rst	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/server/doc/source/anforderungen.rst	2011-05-27 11:42:36 UTC (rev 306)
@@ -17,15 +17,10 @@
 - `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>`_
-- optional für ProxyRemote:
+- `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)
 
-  - `mod_proxy <http://httpd.apache.org/docs/2.2/mod/mod_proxy.html>`_ (Modul erst ab Apache Version 2.2.15  verfügbar)
-
-- optional für URL Rewriting im WMS Capabilities:
-
-  - `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)
-
 .. note:: 
 
    In den Versionen größer oder gleich der Version 2.2.15 sind

Modified: trunk/server/doc/source/ersterTest.rst
===================================================================
--- trunk/server/doc/source/ersterTest.rst	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/server/doc/source/ersterTest.rst	2011-05-27 11:42:36 UTC (rev 306)
@@ -24,9 +24,9 @@
 
 Nutzung von InteProxy Server
 ----------------------------
-Stellen Sie in Ihrer Anwendung der eigentlichen URL für den abgesicherten WMS
-Dienst den Text ``http://servername:64609/`` voran, so wird für diesen
-abgesicherten WMS Dienst explizit der InteProxy Server angesprochen. 
+Stellen Sie in Ihrer Anwendung der eigentlichen URL 
+Text ``http://servername:64609/`` voran. Dadurch wird der angefragte WMS-Dienst 
+explizit durch InteProxy Server angesprochen und abgesichert.
 
 Einfacher Funktionstest (über Web-Browser)
 ------------------------------------------
@@ -44,10 +44,10 @@
  &format=image/png&width=200&height=200
  &srs=epsg:31467&bbox=3427000,5787590,3444000,5800880
 
-Der Browser stellt die Anfrage zunächst an InteProxy Server welcher auf Port
+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 dann die
-eigentliche nachfolgende WMS-Anfrage aus: ::
+eine Karte der Stadt Osnabrück erscheinen, 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

Modified: trunk/server/doc/source/konfiguration.rst
===================================================================
--- trunk/server/doc/source/konfiguration.rst	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/server/doc/source/konfiguration.rst	2011-05-27 11:42:36 UTC (rev 306)
@@ -74,23 +74,24 @@
 Proxy-Umgebung einrichten
 -------------------------
 
-Befindet sich der InteProxy Server im Intranet und Anfragen müssen nach außen
-durch eine Firewall über einen Proxy geleitet werden, muss der Proxy in der
-Datei :file:`/opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf`
-eingetragen werden.
+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.3/server/conf/inteproxy.conf`.
 
 .. code-block:: apache
 
    ProxyRemote * http://intranet.proxy:8080
 
-Ersetzen Sie dazu die obige Beispiel URL, durch die URL Ihres Proxies.
+Ersetzen Sie dazu die obige Beispiel URL `http://intranet.proxy:8080` durch die URL Ihres Proxies.
 
 .. note::
 
    Müssen Anfragen nicht über einen Proxy nach außen geleitet werden,
-   kommentieren Sie die Zeile mit der Direktive ``ProxyRemote`` aus.
+   kommentieren Sie die Zeile mit der Direktive ``ProxyRemote`` durch das
+   Einfügen einer Raute (#) aus.
 
-|more| Weitere Informationen zur Proxy Konfiguration erhalten Sie im Kapitel
+|more| Weitere Informationen zur Proxy-Konfiguration erhalten Sie im Kapitel
 :ref:`Nutzung eines Intranet-Proxies <proxy>`.
 
 Testen der Konfiguration
@@ -137,42 +138,40 @@
 --------------------------------------
 
 
-Für den Betrieb von InteProxy Server werden bestimmte Apache Module benötigt.
-Um die benötigten Apache Module zu laden, entfernen Sie in der InteProxy Server
-VHost-Konfigurationsdatei
-:file:`inteproxy-WindowsServer2003.conf` den Kommentar
-vor der ``Include``-Zeile, die Ihrer Distribution entspricht. Im folgenden Beispiel
-sehen Sie das Einbinden der benötigten Apache Module unter Windows.
+Für den Betrieb von InteProxy Server unter Windows sind die benötigten
+Module bereits vorkonfiguriert. Diese stehen in der Datei
+`conf/InteProxy-SERVER-1.0.3/server/conf/platform-WindowsServer2003.conf`.
 
 .. code-block:: apache
 
    # Apache Module für Windows Server
    Include "conf/InteProxy-SERVER-1.0.3/server/conf/platform-WindowsServer2003.conf"
 
-|more| Welche konkreten Apache Module benötigt werden erfahren Sie im Kapitel
+|more| Welche konkreten Apache Module benötigt werden, erfahren Sie im Kapitel
 :ref:`Anforderungen <anforderungen>`.
 
 
 Proxy-Umgebung einrichten
 -------------------------
 
-Befindet sich der InteProxy Server im Intranet und Anfragen müssen nach außen
-durch eine Firewall über einen Proxy geleitet werden, muss der Proxy in der
-Datei :file:`inteproxy-WindowsServer2003.conf` eingetragen werden.
+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`:
 
 .. code-block:: apache
 
    ProxyRemote * http://intranet.proxy:8080
 
+Ersetzen Sie dazu die obige Beispiel URL `http://intranet.proxy:8080` durch die URL Ihres Proxies.
 
-Ersetzen Sie dazu die obige Beispiel URL, durch die URL Ihres Proxies.
-
 .. note::
 
    Müssen Anfragen nicht über einen Proxy nach außen geleitet werden,
-   kommentieren Sie die Zeile mit der Direktive ``ProxyRemote`` aus.
+   kommentieren Sie die Zeile mit der Direktive ``ProxyRemote`` durch das
+   Einfügen einer Raute (#) aus.
 
-|more| Weitere Informationen zur Proxy Konfiguration erhalten Sie im Kapitel
+|more| Weitere Informationen zur Proxy-Konfiguration erhalten Sie im Kapitel
 :ref:`Nutzung eines Intranet-Proxies <proxy>`.
 
 Testen der Konfiguration

Modified: trunk/server/doc/source/konfigurationsdateiInteProxy.rst
===================================================================
--- trunk/server/doc/source/konfigurationsdateiInteProxy.rst	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/server/doc/source/konfigurationsdateiInteProxy.rst	2011-05-27 11:42:36 UTC (rev 306)
@@ -10,11 +10,6 @@
 Server Konfigurationsdatei :file:`inteproxy.cfg` **oder** durch die manuelle
 Erstellung der Datei :file:`inteproxy-rewrite.conf`.
 
-.. note::
-
-   Für die Einrichtung weiterer abgesicherter OGC Web Services unter Windows
-   empfehlen wir die :ref:`manuelle Einrichtung <inteproxy-rewrite>`.
-
 .. _inteproxy.cfg:
 
 Automatische Einrichtung
@@ -229,8 +224,8 @@
 Direktive Subsitute
 -------------------
 
-Die Substitute Direktive definiert ein Such- und ein Ersetzungs-Pattern welche
-auf den Response Body angewendet wird. Die Syntax ist dabei wie folgt:
+Die Substitute Direktive definiert ein Such- und ein Ersetzungs-Pattern, welche
+auf den Response-Body angewendet wird. Die Syntax ist dabei wie folgt:
 
 .. code-block:: apacheconf
 

Modified: trunk/server/doc/source/konfigurationsdateiVirtualHost.rst
===================================================================
--- trunk/server/doc/source/konfigurationsdateiVirtualHost.rst	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/server/doc/source/konfigurationsdateiVirtualHost.rst	2011-05-27 11:42:36 UTC (rev 306)
@@ -10,7 +10,8 @@
 :file:`/opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf`.
 
 Die Inhalte der Datei :file:`inteproxy.conf` werden in dem folgenden Block
-erläutert.
+erläutert; sie bezieht sich auf GNU/Linux-Systeme. Windows-Benutzer nehmen
+entsprechend die Datei :file:`inteproxy-WindowsServer2003.conf`
 
 .. code-block:: apacheconf
 

Modified: trunk/server/doc/source/proxyRemote.rst
===================================================================
--- trunk/server/doc/source/proxyRemote.rst	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/server/doc/source/proxyRemote.rst	2011-05-27 11:42:36 UTC (rev 306)
@@ -5,7 +5,7 @@
 ==============================
 
 Müssen Anfragen über einen Proxy Server, welcher sich im Intranet befindet,
-nach außen durch eine Firewall geleitet werden, kann hierzu die Direktive
+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
 werden. Die Direktive `ProxyRemote` benötigt das Apache-Module `mod_proxy
@@ -16,10 +16,10 @@
 
 .. code-block:: bash
 
-   |---------|    |------------|     |----------------|    |---------------|
-   | Klient  |    | InteProxy  |     | intranet.proxy |    | abgesicherter |
-   |         | -> |  Server    | ->  |     :8080      | -> |     Dienst    |
-   |---------|    |------------|     |----------------|    |---------------|
+       |---------|    |------------|     |----------------|    |---------------|
+       | Klient  |    | InteProxy  |     | intranet.proxy |    | abgesicherter |
+       |         | -> |  Server    | ->  |     :8080      | -> |     Dienst    |
+       |---------|    |------------|     |----------------|    |---------------|
 
 Im nachfolgenden Beispiel werden
 alle Proxy-Anfragen an ``intranet.proxy:8080`` weitergeleitet::
@@ -30,13 +30,14 @@
   oder ein * für beliebige URLs. 
 - Der zweite Parameter ist die vollständige URL des Remote-Servers.
 
-Die Direktive `ProxyRemote` muss in der Datei :file:`inteproxy.conf`
-eingetragen werden. Passen Sie in dieser Datei die URL für Ihren Proxy
+Die Direktive `ProxyRemote` steht in der Datei :file:`inteproxy.conf`
+eingetragen. Passen Sie in dieser Datei die URL für Ihren Proxy
 entsprechend an.
 
 .. note::
 
-   Wird kein Proxy benötigt, müssen Sie die `ProxyRemote` Direktive auskommentieren.
+   Wird kein Proxy benötigt, müssen Sie die `ProxyRemote` Direktive mit
+   einer Raute (#) auskommentieren.
 
 
 Nach erfolgter Anpassung müssen Sie die Apache HTTP Server Konfigurationen neu
@@ -45,6 +46,6 @@
 
 .. note::
 
-   Für eine die ``HTTPS_upstream-proxy`` Unterstützung benötigen Sie einen
+   Für die ``HTTPS_upstream-proxy`` Unterstützung benötigen Sie einen
    Apache HTTP Server ab Version 2.2.15 (vgl. Kapitel :ref:`anforderungen`)!  Eine
    Proxy Authentifizierung wird zur Zeit noch nicht unterstützt.

Modified: trunk/server/doc/source/versionsgeschichte.rst
===================================================================
--- trunk/server/doc/source/versionsgeschichte.rst	2011-05-27 07:58:05 UTC (rev 305)
+++ trunk/server/doc/source/versionsgeschichte.rst	2011-05-27 11:42:36 UTC (rev 306)
@@ -9,6 +9,7 @@
   * Anpassung: Konfigurationsdatei inteproxy-rewrite.conf für das Umschreiben von GetCapabilities Antworten.   
   * Anpassung: Konfigurationsdateien und Dokumentation für den Einsatz des
     InteproxyServers unter openSUSE 11.3
+  * Erweiterung: Überarbeitung der Dokumentation zu InteProxy Server.
 
 Neu seit Version 1.0.2 vom 11. September 2010
 ---------------------------------------------

