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

Wed Nov 3 10:01:36 CET 2010

Author: bjoern
Date: 2010-11-03 10:01:34 +0100 (Wed, 03 Nov 2010)
New Revision: 294

Modified:
   trunk/ChangeLog
   trunk/server/conf/inteproxy.conf
   trunk/server/conf/platform-suse.conf
   trunk/server/doc/source/installationSUSE.rst
Log:
Adjustments for OpenSUSE 11.3.


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

--- trunk/ChangeLog	2010-11-03 08:58:52 UTC (rev 293)
+++ trunk/ChangeLog	2010-11-03 09:01:34 UTC (rev 294)
@@ -1,3 +1,23 @@
+2010-11-03  Bjoern Schilberg <bjoern.schilberg at intevation.de>
+
+	* server/conf/inteproxy-WindowsServer2003.conf,
+	  server/doc/source/installationWindowsServer2003.rst,
+	  server/doc/source/konfigurationsdateiVirtualHost.rst,
+	  server/doc/source/installationSUSE.rst,
+	  server/doc/source/installationDebian.rst,
+	  server/doc/source/conf.py: Updated file paths and version numbers for
+	  release 1.0.3.
+
+2010-11-03  Bjoern Schilberg <bjoern.schilberg at intevation.de>
+
+	* server/conf/inteproxy.conf, server/conf/platform-suse.conf, 
+	  server/doc/source/installationSUSE.rst: Adapted for OpenSUSE 11.3
+
+2010-11-03  Bjoern Schilberg <bjoern.schilberg at intevation.de>
+
+	* server/conf/inteproxy-rewrite.conf: Adjustment of the substitute
+	  directive for correct rewriting of URLs in GetCapabilites responses.
+
 2010-10-13  Bjoern Schilberg <bjoern.schilberg at intevation.de>
 
 	*  test/test_create_rewrite_rules.py: Adapt test to delimiter change

Modified: trunk/server/conf/inteproxy.conf
===================================================================
--- trunk/server/conf/inteproxy.conf	2010-11-03 08:58:52 UTC (rev 293)
+++ trunk/server/conf/inteproxy.conf	2010-11-03 09:01:34 UTC (rev 294)
@@ -1,15 +1,15 @@
 <VirtualHost *:64609>
 ServerAdmin admin at server.de
 	
-DocumentRoot /opt/InteProxy-SERVER-1.0.0/server
+DocumentRoot /opt/InteProxy-SERVER-1.0.3/server
 
-TransferLog /opt/InteProxy-SERVER-1.0.0/server/logs/access_log
+TransferLog /opt/InteProxy-SERVER-1.0.3/server/logs/access_log
 
-#Include /opt/InteProxy-SERVER-1.0.0/server/conf/platform-suse.conf
-Include /opt/InteProxy-SERVER-1.0.0/server/conf/platform-debian.conf
+Include /opt/InteProxy-SERVER-1.0.3/server/conf/platform-suse.conf
+#Include /opt/InteProxy-SERVER-1.0.3/server/conf/platform-debian.conf
 RewriteEngine On
 # RewriteLogLevel 0
-RewriteLog /opt/InteProxy-SERVER-1.0.0/server/logs/rewrite.log
+RewriteLog /opt/InteProxy-SERVER-1.0.3/server/logs/rewrite.log
 
 # Define filter chain to rewrite URLs in WMS capabilities responses.
 # WMS capabilities responses have the content type
@@ -23,7 +23,7 @@
 # conf/inteproxy-rewrite.conf has to be generated if it doesn't exist
 # yet (see README.txt).  It contains the RewriteRules for the actual
 # InteProxy functionality.
-Include /opt/InteProxy-SERVER-1.0.0/server/conf/inteproxy-rewrite.conf
+Include /opt/InteProxy-SERVER-1.0.3/server/conf/inteproxy-rewrite.conf
 
 # Deny all requests that have not been rewritten to refer to another
 # host.
@@ -39,7 +39,14 @@
 # https connections to other hosts.
 SSLProxyEngine on
 
-#uncommented because already defined in mods-available/ssl.conf
+## Uncommented if not somewhere else defined
+#SSLEngine on
+#SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL
+#SSLCertificateFile /etc/apache2/ssl.crt/snakeoil-dsa.crt
+#SSLCertificateKeyFile /etc/apache2/ssl.key/snakeoil-dsa.key
+
+
+#SSLMutex commented because already defined in ssl.conf
 #SSLMutex  default 
 SSLProtocol all -SSLv2
 SSLCipherSuite HIGH:MEDIUM:!ADH

Modified: trunk/server/conf/platform-suse.conf
===================================================================
--- trunk/server/conf/platform-suse.conf	2010-11-03 08:58:52 UTC (rev 293)
+++ trunk/server/conf/platform-suse.conf	2010-11-03 09:01:34 UTC (rev 294)
@@ -1,6 +1,14 @@
 # suse specific configuration
+#
+# Depending on your apache installation, change the apache2 suffix to prefork,
+# itk or worker. 
+#
+# Comment unneeded or duplicate apache modules.
 
-LoadModule rewrite_module                 /usr/lib/apache2-prefork/mod_rewrite.so
+LoadModule rewrite_module                  /usr/lib/apache2-prefork/mod_rewrite.so
+LoadModule filter_module                   /usr/lib/apache2-prefork/mod_filter.so
+LoadModule substitute_module               /usr/lib/apache2-prefork/mod_substitute.so
+
 LoadModule authz_host_module              /usr/lib/apache2-prefork/mod_authz_host.so
 LoadModule proxy_module                   /usr/lib/apache2-prefork/mod_proxy.so
 LoadModule proxy_http_module              /usr/lib/apache2-prefork/mod_proxy_http.so

Modified: trunk/server/doc/source/installationSUSE.rst
===================================================================
--- trunk/server/doc/source/installationSUSE.rst	2010-11-03 08:58:52 UTC (rev 293)
+++ trunk/server/doc/source/installationSUSE.rst	2010-11-03 09:01:34 UTC (rev 294)
@@ -1,9 +1,9 @@
 ===================================================
-Installation des InteProxy Server für openSuSE 10.3
+Installation des InteProxy Server für openSuSE 11.3
 ===================================================
 
 Die folgende Beschreibung der Installation des InteProxy Servers bezieht sich
-auf eine `openSUSE 10.3 <http://www.opensuse.org>`_-Distribution.
+auf eine `openSUSE 11.3 <http://www.opensuse.org>`_-Distribution.
 
 
 Installieren des Apache HTTP Server 2 
@@ -23,31 +23,31 @@
 Verzeichnis ``/opt``. :: 
 
  cd /opt
- tar zxf InteProxy-SERVER-1.0.2.tar.gz
+ tar zxf InteProxy-SERVER-1.0.3.tar.gz
 
-Anpassen und Umwandeln der InteProxy Konfigurationsdatei
---------------------------------------------------------
-Passen Sie sich die InteProxy Konfigurationdatei ``inteproxy.cfg`` Ihren
-Bedürfnissen an. Nach erfolgter Anpassung wandeln Sie die Konfigurationsdatei
-mit Hilfe des Skripts ``create-rewrite-rules.py`` aus dem Verzeichnis
-``/opt/InteProxy-SERVER-1.0.2/`` in `Apache RewriteRule Direktiven
-<http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html#rewriterule>`_ um. ::
+Anpassen und Umwandeln der Rewrite-Rules Konfigurationsdatei
+------------------------------------------------------------
 
- ./create-rewrite-rules.py --config-file=inteproxy.cfg -o \
- server/conf/inteproxy-rewrite.conf
+Passen Sie sich die InteProxy Rewrite-Rules Konfigurationdatei
+``inteproxy-rewrite.conf`` aus dem Verzeichnis
+``/opt/InteProxy-SERVER-1.0.3/server/conf`` manuell Ihren Bedürfnissen an. 
 
-Sie benötigen zur Ausführung des Skripts ``create-rewrite-rules.py`` noch das
-Python-Paket lxml. Gegebenenfalls müssen Sie es mit ``zypper`` oder
-``Yast`` nachinstallieren. ::
+Ändern Sie in der Datei ``inteproxy-rewrite.conf`` die Angaben zum
+Benutzernamen (``USERNAME``), Passwort (``PASSWORT``) und zum Servernamen
+(``SERVERNAME``).
 
- zypper install python-lxml
+Eine detaillierte Beschreibung der Apache Direktiven ``RewriteRule`` und
+``Substitute`` finden Sie in der Apache Webserver Dokumentation in den
+jeweiligen Modulen unter: 
 
+- `Apache Module mod_rewrite: RewriteRule Directive <http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html#rewriterule>`_ 
+- `Apache Module mod_substitute: Substitute Directive <http://httpd.apache.org/docs/2.2/mod/mod_substitute.html#subsitute>`_ 
 
 Einrichten des InteProxy Servers als seperaten VirtualHost
 ----------------------------------------------------------
 Um den InterProxy Server als seperaten `VirtualHost
 <http://httpd.apache.org/docs/2.2/mod/core.html#virtualhost>`_ zu betreiben,
-kopieren Sie hierfür aus dem Verzeichnis ``/opt/InteProxy-SERVER-1.0.2/server/conf`` die
+kopieren Sie hierfür aus dem Verzeichnis ``/opt/InteProxy-SERVER-1.0.3/server/conf`` die
 Beispiel-Konfigurationsdatei ``inteproxy.conf`` nach
 ``/etc/apache2/vhosts.d``. Sie können die Beispiel-Konfigurationsdatei auch
 als Vorlage für Ihre eigene Konfiguration verwenden.
@@ -58,10 +58,52 @@
  Listen 64609
 
 Wenn Sie sich unsicher sind, wie Apache ihre vhost-Konfiguration
-interpretiert, nutzen Sie ``httpd2 -S``. Falls SSL im Spiel ist, führen Sie
-statt dessen ``httpd2 -S -DSSL`` aus. 
+interpretiert, nutzen Sie den Befehl: :: 
 
+ httpd2 -S -DSSL 
+
 Nach erfolgreichem Test des neu eingerichteten VirtualHost ``inteproxy`` starten Sie den
 Apache HTTP Server neu. ::
  
  rcapache2 restart
+
+Hinweise
+--------
+
+Warnmeldung beim Starten von apache zu bereits geladenen Modulen
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+
+Erscheint beim Starten des Apache Webservers ein Warnhinweis das Apache Module bereits geladen worden sind::
+
+  module proxy_module is already loaded, skipping
+
+Kommentieren Sie ggf. die in der Warnmeldung vorkommenden Module in der Datei
+``/opt/InteProxy-SERVER-1.0.3/server/conf/platform-suse.conf`` aus.
+
+SSL-Fehlermeldung im Klient
+'''''''''''''''''''''''''''
+
+Erscheint beispielsweise beim Versuch InteproxyServer mit dem Firefox auf
+https://SERVERNAME:64609 anzusprechen folgende Warnmeldung::
+
+  Secure Connection Failed
+  An error occurred during a connection to SERVERNAME:64609.
+  SSL received a record that exceeded the maximum permissible length.
+  (Error code: ssl_error_rx_record_too_long)
+
+Überprüfen Sie die SSL-Konfiguration, ggf. entfernen Sie in der
+``inteproxy.conf`` den Kommentar in folgenden Zeilen:: 
+
+ SSLEngine on
+ SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL
+ SSLCertificateFile /etc/apache2/ssl.crt/snakeoil-dsa.crt
+ SSLCertificateKeyFile /etc/apache2/ssl.key/snakeoil-dsa.key
+
+Hinweis
+```````
+
+In der Beispiel Konfigurationsdatei ``inteproxy.conf`` werden
+Beispiel-Zertifikate der Distribution verwendet. Damit dies funktioniert muss
+das Paket ``apache2-example-certificates`` installiert sein. Für einen
+Produktivbetrieb wird empfohlen die Beispiel-Zertifikate durch eigene
+Zertifikate zu ersetzen. 

