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

Thu May 26 17:04:53 CEST 2011

Author: bjoern
Date: 2011-05-26 17:04:51 +0200 (Thu, 26 May 2011)
New Revision: 304

Added:
   trunk/server/doc/source/konfiguration.rst
   trunk/server/doc/source/vorraussetzungen.rst
Modified:
   trunk/ChangeLog
   trunk/server/doc/source/anforderungen.rst
   trunk/server/doc/source/download.rst
   trunk/server/doc/source/gettingStarted.rst
   trunk/server/doc/source/index.rst
   trunk/server/doc/source/installApache.rst
   trunk/server/doc/source/konfigurationsdateiInteProxy.rst
   trunk/server/doc/source/linkliste.rst
   trunk/server/doc/source/proxyRemote.rst
Log:
Revised version of inteproxy server documentation.



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

--- trunk/ChangeLog	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/ChangeLog	2011-05-26 15:04:51 UTC (rev 304)
@@ -1,5 +1,19 @@
 2011-05-26  Bjoern Schilberg <bjoern.schilberg at intevation.de>
 
+	* M  server/doc/source/installApache.rst,
+	  A  server/doc/source/konfiguration.rst,
+	  M  server/doc/source/gettingStarted.rst,
+	  M  server/doc/source/konfigurationsdateiInteProxy.rst,
+	  M  server/doc/source/proxyRemote.rst,
+	  M  server/doc/source/anforderungen.rst,
+	  M  server/doc/source/linkliste.rst,
+	  A  server/doc/source/vorraussetzungen.rst,
+	  M  server/doc/source/index.rst,
+	  M  server/doc/source/download.rst:
+	  Revised version.
+
+2011-05-26  Bjoern Schilberg <bjoern.schilberg at intevation.de>
+
 	* M server/doc/source/installApache.rst,
 	  M server/doc/source/konfigurationsdateiVirtualHost.rst,
 	  M server/doc/source/einfuehrung.rst,

Modified: trunk/server/doc/source/anforderungen.rst
===================================================================
--- trunk/server/doc/source/anforderungen.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/anforderungen.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -4,8 +4,6 @@
 Anforderungen
 =============
 
-
-
 Benötigte Apache HTTP Server Module
 ===================================
 

Modified: trunk/server/doc/source/download.rst
===================================================================
--- trunk/server/doc/source/download.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/download.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -1,11 +1,29 @@
 .. _download:
 
-=========================
-Download InteProxy Server
-=========================
+=================================
+Installation des InteProxy Server
+=================================
 
 Die aktuellste Version des InteProxy Servers befinden sich unter:
 http://inteproxy.wald.intevation.org.
 
 Der InteProxy Server ist Freie Software und unter der `GNU GPL (Version 2)
 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>`_ lizensiert.
+
+
+Installation unter Linux
+========================
+
+Laden Sie den aktuellen InteProxy Server herunter und entpacken Sie den
+InteProxy Server in das Verzeichnis :file:`/opt`. 
+
+.. code-block:: bash
+
+   tar zxf InteProxy-SERVER-1.0.3.tar.gz -C /opt
+
+
+Installation unter Windows
+==========================
+
+Laden Sie den aktuellen InteProxy Server herunter und entpacken Sie den
+InteProxy Server in das Verzeichnis ``C:\Programme\Apache Group\Apache2\conf``.

Modified: trunk/server/doc/source/gettingStarted.rst
===================================================================
--- trunk/server/doc/source/gettingStarted.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/gettingStarted.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -3,142 +3,63 @@
 ===============
 
 Dieses Tutorial führt Sie schrittweise durch den InteProxy Server
-Installationsprozeß unter Linux. 
+Installationsprozess. 
 
-Die grünen Pfeile verweisen auf Kapitel zu denen Sie "mehr Infos" zu dem
-beschriebenen Schritt erhalten.
+Die grünen Pfeile verweisen auf Kapitel zu denen Sie "mehr Infos" erhalten.
 
 .. note::
 
-   Führen Sie die nachfolgenden Schritte als `root`-Benutzer aus.
+   Es kann erforderlich sein, dass Sie die nachfolgenden Schritte als
+   `root`-Benutzer bzw. als Administrator ausführen müssen.
 
 
-
 Schritt 1: Installation Apache HTTP Server
 ==========================================
 
 Installieren Sie einen **aktuellen** Apache HTTP Server (**mindestens Version
-2.2.15**) mit Hilfe der Paketverwaltung der verwendeten Linux-Distribution.
+2.2.15**).
 
 |more| Hier finden Sie weitere Informationen zur :ref:`Installation des Apache
 HTTP Server <installApache>`.
 
 
 
-Schritt 2: Herunterladen des InteProxy Servers
-==============================================
+Schritt 2: Installation des InteProxy Servers
+=============================================
 
-Laden Sie den aktuellen InteProxy Server herunter und entpacken Sie den
-InteProxy Server in das Verzeichnis :file:`/opt`. ::
+Laden Sie den aktuellen InteProxy Server herunter und entpacken Sie das
+Installationspaket.
 
- tar zxf InteProxy-SERVER-1.0.3.tar.gz -C /opt
+|more| Weitere Informationen zu der Installation erhalten Sie im Kapitel
+:ref:`Installation des InteProxy Servers <installation>`.
 
-|more| Wo Sie den InteProxy Server herunterladen können erfahren Sie im Kapitel
-:ref:`Download InteProxy Server <download>`.
 
 
+Schritt 3: Konfiguration des InteProxy Servers 
+==============================================
 
-Schritt 3: Einrichten der Apache Umgebung
-=========================================
-
-
-Einrichten des VirtualHosts
----------------------------
-
 Der InterProxy Server wird als separater `VirtualHost
-<http://httpd.apache.org/docs/2.2/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.3/server/conf/inteproxy.conf` in dem
-entsprechenden Apache Verzeichnis.
+<http://httpd.apache.org/docs/2.2/mod/core.html#virtualhost>`_ betrieben.
+Hierzu konfigurieren Sie bitte den InteProxy Server im Kontext der Apache HTTP
+Server Konfiguration. 
 
-.. note::
+|more| Informationen zur Konfiguration des InteProxy Server unter Linux finden
+Sie im Kapitel :ref:`Konfiguration des Inteproxy Servers unter Linux
+<konfigurationLinux>` und zur Konfiguration unter Windows im Kapitel
+:ref:`Konfiguration des Inteproxy Servers unter Windows
+<konfigurationWindows>`.
 
-   Das Setzen des symbolischen Links ist abhängig von der eingesetzten Distribution.
 
-   - **Debian**: ``ln -s /opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf /etc/apache2/sites-available/inteproxy.conf``
-   - **SuSE**: ``ln -s /opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf /etc/apache2/vhosts.d/inteproxy.conf``
 
-|more| Eine detallierte Erläuterung der VirtualHost Konfigurationsdatei finden
-Sie im Kapitel :ref:`VirtualHost Konfigurationsdatei <vhost>`.
+Schritt 4: InteProxy Server starten
+===================================
 
 
-Konfigurieren der InteProxy Server Portnummer
----------------------------------------------
+Linux
+-----
 
-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 hinzufügen:
-
-.. code-block:: apache
-
-   Listen 64609
-
 .. note::
 
-   Die Konfigurationsdatei für das Setzen der Portnummer ist abhängig von der
-   eingesetzten Distribution.
-
-   - **Debian**: :file:`/etc/apache2/ports.conf`
-   - **SuSE**:   :file:`/etc/apache2/listen.conf`
-
-
-Einbinden der benötigten Apache Module
---------------------------------------
-
-.. warning::
-
-   Dieser Schritt ist zwingend erforderlich.
-
-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:`/opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf` den Kommentar
-vor der ``Include``-Zeile, welche Ihrer Distribution entspricht. Im folgenden Beispiel
-sehen Sie das Einbinden der benötigten Apache Module unter Debian.
-
-.. code-block:: apache
-
-   ## Apache Module for SuSE
-   #Include /opt/InteProxy-SERVER-1.0.0/server/conf/platform-suse.conf
-
-   # Apache Module for Debian
-   Include /opt/InteProxy-SERVER-1.0.0/server/conf/platform-debian.conf
-
-   ## Apache Module for Windows Server
-   #Include /opt/InteProxy-SERVER-1.0.0/server/conf/platform-windows.conf
-
-
-|more| Welche konkreten Apache Module benötigt werden erfahren Sie im Kapitel
-:ref:`Anforderungen <anforderungen>`.
-
-
-Proxy-Umgebung einrichten (optional)
-------------------------------------
-
-.. note::
-
-   Dieser Schritt ist optional.
-
-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.
-
-.. code-block:: apache
-
-   ProxyRemote * http://intranet.proxy:8080
-
-|more| Weitere Informationen zur Proxy Konfiguration erhalten Sie im Kapitel
-:ref:`ProxyRemote Unterstützung <proxy>`.
-
-
-
-Schritt 4: InteProxy Server starten
-===================================
-
-.. note::
-
    Unter Debian muss vor einem Neuladen der Apache Konfiguration der InteProxy
    Server VirtualHost aktiviert werden.
 
@@ -152,10 +73,16 @@
 
   /etc/init.d/apache2 reload
 
+Windows
+-------
 
-Schritt 5: Installation testen
-==============================
+Nach erfolgreichem Test des neu eingerichteten VirtualHost
+``inteproxy-WindowsServer2003`` können Sie den Apache HTTP Server zum Beispiel
+über den ``Apache Service Monitor`` neustarten.
 
+Schritt 5: InteProxy Server testen
+==================================
+
 Für einen einfachen Test, rufen Sie die folgenden URL (bsp. in einem Browser)
 auf:
 
@@ -173,8 +100,8 @@
 
 
 
-Schritt 6: Einrichtung weitere abgesicherten OGC Web Services
-=============================================================
+Schritt 6: Einrichtung weiterer abgesicherter OGC Web Services
+==============================================================
 
 |more| Wie Sie weitere abgesicherte OGC Web Services hinzufügen können
 erfahren Sie im Kapitel :ref:`Einrichtung weiterer abgesicherter OGC Web

Modified: trunk/server/doc/source/index.rst
===================================================================
--- trunk/server/doc/source/index.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/index.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -10,20 +10,20 @@
    :maxdepth: 2
 
    einfuehrung.rst
+   vorraussetzungen.rst
    gettingStarted.rst
    installApache.rst
    download.rst
+   konfiguration.rst
    konfigurationsdateiVirtualHost.rst
    proxyRemote.rst
    ersterTest.rst
    konfigurationsdateiInteProxy.rst
+   linkliste.rst
    anforderungen.rst
+   versionsgeschichte.rst
 .. URLrewriting.rst
-   linkliste.rst
-.. versionsgeschichte.rst
 
-   
-
 .. Stichwortverzeichnis und Tabellen 
    =================================
    

Modified: trunk/server/doc/source/installApache.rst
===================================================================
--- trunk/server/doc/source/installApache.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/installApache.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -7,7 +7,7 @@
 Für den Einsatz des InteProxy Servers wird **mindestens** die Version 2.2.15
 des Apache HTTP Servers vorausgesetzt. Für die einzelnen Distributionen wie
 Debian, SuSE oder Windows erhalten Sie in den nachfolgenden Abschnitten
-detailierte Hinweise zur Installation des Apache HTTP Servers.
+detailierter Hinweise zur Installation des Apache HTTP Servers.
 
 Debian
 ======

Added: trunk/server/doc/source/konfiguration.rst
===================================================================
--- trunk/server/doc/source/konfiguration.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/konfiguration.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -0,0 +1,192 @@
+.. _konfiguration:
+
+===================================
+Konfiguration des InteProxy Servers
+===================================
+
+
+.. _konfigurationLinux:
+
+Konfiguration des InteProxy Servers unter Linux
+===============================================
+
+Einrichten des VirtualHosts
+---------------------------
+Der InterProxy Server wird als separater `VirtualHost
+<http://httpd.apache.org/docs/2.2/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.3/server/conf/inteproxy.conf` in dem
+entsprechenden Apache Verzeichnis.
+
+.. note::
+
+   Das Setzen des symbolischen Links ist abhängig von der eingesetzten Distribution.
+
+   - **Debian**: ``ln -s /opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf /etc/apache2/sites-available/inteproxy.conf``
+   - **SuSE**: ``ln -s /opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf /etc/apache2/vhosts.d/inteproxy.conf``
+
+|more| Eine detallierte Erläuterung der VirtualHost Konfigurationsdatei finden
+Sie im Kapitel :ref:`VirtualHost Konfigurationsdatei <vhost>`.
+
+Konfigurieren der InteProxy Server Portnummer
+---------------------------------------------
+
+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 hinzufügen:
+
+.. code-block:: apache
+
+   Listen 64609
+
+.. note::
+
+   Die Konfigurationsdatei für das Setzen der Portnummer ist abhängig von der
+   eingesetzten Distribution.
+
+   - **Debian**: :file:`/etc/apache2/ports.conf`
+   - **SuSE**:   :file:`/etc/apache2/listen.conf`
+
+
+Einbinden der benötigten Apache Module
+--------------------------------------
+
+.. warning::
+
+   Dieser Schritt ist zwingend erforderlich.
+
+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:`/opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf` den Kommentar
+vor der ``Include``-Zeile, welche Ihrer Distribution entspricht. Im folgenden Beispiel
+sehen Sie das Einbinden der benötigten Apache Module unter Debian.
+
+.. code-block:: apache
+
+   ## Apache Module for SuSE
+   #Include /opt/InteProxy-SERVER-1.0.0/server/conf/platform-suse.conf
+
+   # Apache Module for Debian
+   Include /opt/InteProxy-SERVER-1.0.0/server/conf/platform-debian.conf
+
+|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:`/opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf`
+eingetragen werden.
+
+.. code-block:: apache
+
+   ProxyRemote * http://intranet.proxy:8080
+
+
+.. note::
+
+   Müssen Anfragen nicht über einen Proxy nach außen geleitet werden,
+   kommentieren Sie die Zeile mit der ``ProxyRemote`` Direktive bitte aus.
+
+|more| Weitere Informationen zur Proxy Konfiguration erhalten Sie im Kapitel
+:ref:`Nutzung eines Intranet-Proxies <proxy>`.
+
+Testen der Konfiguration
+------------------------
+
+Testen Sie die Konfiguration auf syntaktische Korrektheit, bevor Sie die
+Konfigurationsdateien neu laden mit dem Befehl:
+
+.. code-block::
+
+   apache2ctl -S
+
+.. _konfigurationWindows:
+
+Konfiguration des InteProxy Servers unter Windows Server 
+=========================================================
+
+Einrichten des VirtualHosts
+---------------------------
+
+Um den InterProxy 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:\Programme\Apache
+Group\Apache2\conf\httpd.conf` die folgende Zeile: ::
+ 
+  Include conf/InteProxy-SERVER-1.0.3/server/conf/inteproxy-WindowsServer2003.conf
+
+|more| Eine detallierte Erläuterung der VirtualHost Konfigurationsdatei finden
+Sie im Kapitel :ref:`VirtualHost Konfigurationsdatei <vhost>`.
+
+Konfigurieren der InteProxy Server Portnummer
+---------------------------------------------
+
+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: 
+
+.. code-block:: apache
+
+   Listen 64609
+
+Einbinden der benötigten Apache Module
+--------------------------------------
+
+.. warning::
+
+   Dieser Schritt ist zwingend erforderlich.
+
+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, welche Ihrer Distribution entspricht. Im folgenden Beispiel
+sehen Sie das Einbinden der benötigten Apache Module unter Windows.
+
+.. code-block:: apache
+
+   # Apache Module für Windows
+   Include "conf/InteProxy-SERVER-1.0.3/server/conf/platform-WindowsServer2003.conf"
+
+|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.
+
+.. code-block:: apache
+
+   ProxyRemote * http://intranet.proxy:8080
+
+
+.. note::
+
+   Müssen Anfragen nicht über einen Proxy nach außen geleitet werden,
+   kommentieren Sie die Zeile mit der ``ProxyRemote`` Direktive bitte aus.
+
+|more| Weitere Informationen zur Proxy Konfiguration erhalten Sie im Kapitel
+:ref:`Nutzung eines Intranet-Proxies <proxy>`.
+
+Testen der Konfiguration
+------------------------
+
+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``.
+
+.. |more| image:: images/more.png
+          :align: middle
+          :alt: mehr Infos

Modified: trunk/server/doc/source/konfigurationsdateiInteProxy.rst
===================================================================
--- trunk/server/doc/source/konfigurationsdateiInteProxy.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/konfigurationsdateiInteProxy.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -5,17 +5,22 @@
 ===================================================
 
 Die Einrichtung weiterer abgesicherter OGC Web Services kann auf zwei
-unterschiedlichen Wege durchgeführt werden. Automatisiert durch das
+unterschiedlichen Wege durchgeführt werden. **Entweder** automatisiert durch das
 Python-Skript ``create-rewrite-rules.py`` und die Verwendung der InteProxy
-Server Konfigurationsdatei :file:`inteproxy.cfg` oder durch die manuelle
+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:
 
-Verwendung von inteproxy.cfg
-============================
+Automatisches Einrichtung
+=========================
 
-Die automatisierte Einrichtung weitere abgesicherter OGC  Web Services erfolgt
+Die automatisierte Einrichtung weiterer abgesicherter OGC  Web Services erfolgt
 über die Konfigurationsdatei :file:`/opt/InteProxy-SERVER-1.0.3/inteproxy.cfg`.
 Werden darin keine OWS-Dienste angegeben, verhält sich der InteProxy Server wie
 ein normaler transparenter HTTP-Proxy.
@@ -123,7 +128,7 @@
 :file:`inteproxy-rewrite.conf`. 
 
 |more| Informationen zu der Datei :file:`inteproxy-rewrite.conf` finden Sie im
-Abschnitt :ref:`inteproxy-rewrite.conf <inteproxy-rewrite>`.
+Abschnitt :ref:`Manuelle Einrichtung <inteproxy-rewrite>`.
 
 Der folgende Beispielaufruf zeigt die
 Erstellung der Datei :file:`inteproxy-rewrite.conf`:
@@ -155,15 +160,15 @@
 
 .. _inteproxy-rewrite:
 
-inteproxy-rewrite.conf
-======================
+Manuelle Einrichtung
+====================
 
 Die Datei :file:`inteproxy-rewrite.conf` kann manuell oder wie im
-Kapitel :ref:`Verwendung von inteproxy.cfg <inteproxy.cfg>` beschrieben
+Kapitel :ref:`Automatische Einrichtung <inteproxy.cfg>` beschrieben
 automatisch erstellt werden.
 
 Im folgenden Block wird die beispielhafte Datei
-*/opt/InteProxy-1.0.3/server/conf/inteproxy-rewrite.conf* erläutert und
+:file:`inteproxy-rewrite.conf` erläutert und
 Hinweise zur Benutzung der verwendeten Apache Direktiven gegeben.
 
 .. code-block:: apacheconf

Modified: trunk/server/doc/source/linkliste.rst
===================================================================
--- trunk/server/doc/source/linkliste.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/linkliste.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -1,6 +1,6 @@
-==========
+=========
 Linkliste
-==========
+=========
 
  * http://archive.apache.org/dist/httpd/binaries/win32/ (Apache HTTP Server Archive für historische win32 Versionen)
  * http://codespeak.net/lxml/

Modified: trunk/server/doc/source/proxyRemote.rst
===================================================================
--- trunk/server/doc/source/proxyRemote.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/proxyRemote.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -1,8 +1,10 @@
-===========
-ProxyRemote
-===========
+.. _proxy:
 
-Sollen Anfragen über einen Proxy Server, welcher sich im Intranet
+==============================
+Nutzung eines Intranet-Proxies
+==============================
+
+Müssen Anfragen über einen Proxy Server, welcher sich im Intranet
 befindet, nach außen durch eine Firewall geleitet werden, kann hier zu die
 Konfigurationsdirektive `ProxyRemote
 <http://httpd.apache.org/docs/2.2/mod/mod_proxy.html#proxyremote>`_ verwendet
@@ -14,12 +16,11 @@
 
 .. code-block:: bash
 
+   |---------|    |------------|     |----------------|    |---------------|
+   | Klient  |    | InteProxy  |     | intranet.proxy |    | abgesicherter |
+   |         | -> |  Server    | ->  |     :8080      | -> |     Dienst    |
+   |---------|    |------------|     |----------------|    |---------------|
 
-     |------------|     |---------------|   
-     | InteProxy  |     | intranet.proxy|   
-  -> |  Server    | ->  |     :8080     | ->
-     |------------|     |---------------|   
-
 Im nachfolgenden Beispiel werden
 alle Proxy-Anfragen an ``intranet.proxy:8080`` weitergeleitet::
 
@@ -29,8 +30,13 @@
   oder ein * für beliebige URLs. 
 - Der zweite Parameter ist die vollständige URL des Remote-Servers.
 
-Die `ProxyRemote` Konfigurationsdirektive muss in der Datei */opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf* eingetragen werden.
+Die Direktive `ProxyRemote` muss in der Datei */opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy.conf* eingetragen werden.
 
+.. note::
+
+   Wird kein Proxy benötigt, müssen Sie die `ProxyRemote` Direktive auskommentieren.
+
+
 Nach erfolgter Anpassung müssen die Apache HTTP Server Konfigurationen neu
 geladen werden:
 

Added: trunk/server/doc/source/vorraussetzungen.rst
===================================================================
--- trunk/server/doc/source/vorraussetzungen.rst	2011-05-26 07:29:13 UTC (rev 303)
+++ trunk/server/doc/source/vorraussetzungen.rst	2011-05-26 15:04:51 UTC (rev 304)
@@ -0,0 +1,9 @@
+================
+Vorraussetzungen
+================
+
+Für den Betrieb des InteProxy Servers benötigen Sie:
+
+* einen aktuellen Apache HTTP Server (mindestens Version 2.2.15),
+* eine Python-Umgebung (optional),
+  * das *lxml XML toolkit* für Python.

