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

scm-commit@wald.intevation.org scm-commit at wald.intevation.org
Tue May 11 12:10:46 CEST 2010


Author: bjoern
Date: 2010-05-11 12:10:45 +0200 (Tue, 11 May 2010)
New Revision: 253

Added:
   trunk/server/conf/inteproxy-WindowsServer2003.conf
   trunk/server/conf/inteproxy-rewrite.conf
   trunk/server/conf/platform-WindowsServer2003.conf
   trunk/server/doc/source/installationWindowsServer2003.rst
Modified:
   trunk/ChangeLog
   trunk/server/doc/Makefile
   trunk/server/doc/README.txt
   trunk/server/doc/source/anforderungen.rst
   trunk/server/doc/source/conf.py
   trunk/server/doc/source/index.rst
   trunk/server/doc/source/linkliste.rst
   trunk/server/doc/source/versionsgeschichte.rst
Log:
Enhancement of the inteproxy server documentation, added section for
installing inteproxy server under windows server 2003 (SP2), added
configuration files for inteproxy server under apache 2.0.59 / windows
server 2003. Enhancement of the sphinx pdf build process: now rst2pdf can
be use to build pdf documents.



Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/ChangeLog	2010-05-11 10:10:45 UTC (rev 253)
@@ -1,3 +1,35 @@
+2010-05-11  Bjoern Schilberg <bjoern at intevation.de>
+
+	* server/doc/source/conf.py: Set version and release to 1.0.1.
+	Changed latex_font_size to 10pt. Added options for PDF output with
+	rst2pdf  
+	* server/doc/source/versionsgeschichte.rst: Added new version to
+	version history
+	* server/conf/inteproxy-WindowsServer2003.conf: Added inteproxy
+	configuration for Windows Server 2003
+	* server/conf/platform-WindowsServer2003.conf: Added platform
+	configuration for inteproxy configuration for Windows Server
+	2003
+	* server/conf/inteproxy-rewrite.conf: Added an example inteproxy
+	rewrite rule file. 
+	* server/doc/Makefile: add new build option, to build pdf directly
+	with rst2pdf
+
+2010-05-10  Bjoern Schilberg <bjoern at intevation.de>
+
+	* server/doc/source/installationWindowsServer2003.rst: Added
+	documentation for Windows Server 2003 (SP2) installation. 
+	* server/doc/source/index.rst: Added documentation for Windows
+	Server 2003 (SP2) to index page.
+	* server/conf/inteproxy-WindowsServer2003.conf: Added inteproxy
+	configuration for Apache 2.0.59 / Windows Server 2003 (SP2).
+	* server/conf/platform-WindowsServer2003.conf: Added platform
+	configuration for inteproxy virtual host on Apache 2.0.59 /
+	Windows Server 2003 (SP2)
+	* server/doc/source/anforderungen.rst: Note: Apache module
+	mod_authz_host only available since Apache >= 2.1
+	* server/doc/README.txt: New section for checking links added.
+
 2010-03-22  Stephan Holl  <stephan.holl at intevation.de>
 
 	* website/index.htm4, website/index-de.htm4: Included the correct

Added: trunk/server/conf/inteproxy-WindowsServer2003.conf
===================================================================
--- trunk/server/conf/inteproxy-WindowsServer2003.conf	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/conf/inteproxy-WindowsServer2003.conf	2010-05-11 10:10:45 UTC (rev 253)
@@ -0,0 +1,43 @@
+<VirtualHost *:64609>
+ServerAdmin admin at server.de
+	
+DocumentRoot "conf/InteProxy-SERVER-1.0.0/server"
+
+TransferLog "conf/InteProxy-SERVER-1.0.0/server/logs/access_log"
+
+Include "conf/InteProxy-SERVER-1.0.0/server/conf/platform-WindowsServer2003.conf"
+RewriteEngine On
+# RewriteLogLevel 0
+RewriteLog "conf/InteProxy-SERVER-1.0.0/server/logs/rewrite.log"
+
+# 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 "conf/InteProxy-SERVER-1.0.0/server/conf/inteproxy-rewrite.conf"
+
+# Deny all requests that have not been rewritten to refer to another
+# host.
+<Directory />
+ Order Deny,Allow
+ Deny from All
+</Directory>
+
+
+
+## SSL configuration.  
+## SSLProxyEngine must be on so that Apache can make
+# https connections to other hosts.
+SSLProxyEngine on
+
+## SSLMutex cannot occur within <VirtualHost> section
+## und bereits in conf/ssl.conf konfiguriert
+#SSLMutex  default 
+SSLProtocol all -SSLv2
+SSLCipherSuite HIGH:MEDIUM:!ADH
+
+## SSLRandomSeed cannot occur within <VirtualHost> section
+## und bereits in conf/ssl.conf konfiguriert
+#SSLRandomSeed startup builtin
+#SSLRandomSeed connect builtin
+
+</VirtualHost>

Added: trunk/server/conf/inteproxy-rewrite.conf
===================================================================
--- trunk/server/conf/inteproxy-rewrite.conf	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/conf/inteproxy-rewrite.conf	2010-05-11 10:10:45 UTC (rev 253)
@@ -0,0 +1,2 @@
+RewriteRule ^/inteproxy\-demo\.intevation\.org\/cgi\-bin\/frida\-wms$ https:/$0?user=meier&password=meier [QSA,P]
+RewriteRule ^/www\.geobasisdaten\.niedersachsen\.de\/mapgate\/.*$ https:/$0?user=USERNAME&password=PASSWORT [QSA,P]

Added: trunk/server/conf/platform-WindowsServer2003.conf
===================================================================
--- trunk/server/conf/platform-WindowsServer2003.conf	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/conf/platform-WindowsServer2003.conf	2010-05-11 10:10:45 UTC (rev 253)
@@ -0,0 +1,8 @@
+## windows 2003 specific configuration
+## apache 2.0.59
+LoadModule rewrite_module modules/mod_rewrite.so
+## authz_host-Modul erst ab version 2.1 verfuegbar
+#LoadModule authz_host_module modules/mod_authz_host.so
+LoadModule proxy_module modules/mod_proxy.so
+LoadModule proxy_http_module modules/mod_proxy_http.so
+LoadModule ssl_module modules/mod_ssl.so

Modified: trunk/server/doc/Makefile
===================================================================
--- trunk/server/doc/Makefile	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/Makefile	2010-05-11 10:10:45 UTC (rev 253)
@@ -23,6 +23,7 @@
 	@echo "  htmlhelp  to make HTML files and a HTML help project"
 	@echo "  qthelp    to make HTML files and a qthelp project"
 	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  pdf       to make pdf files, with rst2pdf"
 	@echo "  changes   to make an overview of all changed/added/deprecated items"
 	@echo "  linkcheck to check all external links for integrity"
 	@echo "  doctest   to run all doctests embedded in the documentation (if enabled)"
@@ -71,7 +72,12 @@
 	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
 	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
 	      "run these through (pdf)latex."
+pdf:
+	$(SPHINXBUILD) -b pdf $(ALLSPHINXOPTS) $(BUILDDIR)/pdf
+	@echo
+	@echo "Build finished. The PDF files are in $(BUILDDIR)/pdf."
 
+
 changes:
 	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
 	@echo

Modified: trunk/server/doc/README.txt
===================================================================
--- trunk/server/doc/README.txt	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/README.txt	2010-05-11 10:10:45 UTC (rev 253)
@@ -33,6 +33,13 @@
 will find the pdf document in ``build/latex`` directory.
 
 
+Check links in the docs
+=======================
+
+Don't forget to check links in the document before handed out.
+
+  make linkcheck
+
 Links
 =====
 

Modified: trunk/server/doc/source/anforderungen.rst
===================================================================
--- trunk/server/doc/source/anforderungen.rst	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/source/anforderungen.rst	2010-05-11 10:10:45 UTC (rev 253)
@@ -6,7 +6,8 @@
 <http://httpd.apache.org>`_ und die folgenden Apache-Module:
 
  - `mod_rewrite <http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html>`_
- - `mod_authz_host <http://httpd.apache.org/docs/2.2/mod/mod_authz_host.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>`_
  - `mod_proxy_http
    <http://httpd.apache.org/docs/2.2/mod/mod_proxy_http.html>`_

Modified: trunk/server/doc/source/conf.py
===================================================================
--- trunk/server/doc/source/conf.py	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/source/conf.py	2010-05-11 10:10:45 UTC (rev 253)
@@ -22,7 +22,7 @@
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.todo']
+extensions = ['sphinx.ext.todo','sphinx.ext.autodoc','rst2pdf.pdfbuilder']
 
 #locale_dirs='./locale'
 
@@ -47,9 +47,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '1.0.0'
+version = '1.0.1'
 # The full version, including alpha/beta/rc tags.
-release = '1.0.0'
+release = '1.0.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -169,8 +169,8 @@
 latex_paper_size = 'a4'
 
 # The font size ('10pt', '11pt' or '12pt').
-#latex_font_size = '10pt'
-latex_font_size = '12pt'
+latex_font_size = '10pt'
+#latex_font_size = '12pt'
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
@@ -214,3 +214,86 @@
 }
 ''',
 } 
+
+# -- Options for PDF output --------------------------------------------------
+# Grouping the document tree into PDF files. List of tuples
+# (source start file, target name, title, author, options).
+#
+# If there is more than one author, separate them with \\.
+# For example: r'Guido van Rossum\\Fred L. Drake, Jr., editor'
+#
+# The options element is a dictionary that lets you override
+# this config per-document.
+# For example,
+# ('index', u'MyProject', u'My Project', u'Author Name',
+#  dict(pdf_compressed = True))
+# would mean that specific document would be compressed
+# regardless of the global pdf_compressed setting.
+pdf_documents = [
+  ('index', 'InteProxyServer', u'InteProxy Server Dokumentation',
+   u'Bjoern Schilberg'),
+]
+# A comma-separated list of custom stylesheets. Example:
+pdf_stylesheets = ['sphinx','kerning','a4']
+
+# Create a compressed PDF
+# Use True/False or 1/0
+# Example: compressed=True
+#pdf_compressed = False
+
+# A colon-separated list of folders to search for fonts. Example:
+# pdf_font_path = ['/usr/share/fonts', '/usr/share/texmf-dist/fonts/']
+
+# Language to be used for hyphenation support
+#pdf_language = "en_US"
+
+# Mode for literal blocks wider than the frame. Can be
+# overflow, shrink or truncate
+pdf_fit_mode = "shrink"
+
+# Section level that forces a break page.
+# For example: 1 means top-level sections start in a new page
+# 0 means disabled
+#pdf_break_level = 0
+
+# When a section starts in a new page, force it to be 'even', 'odd',
+# or just use 'any'
+pdf_breakside = 'even'
+
+# Insert footnotes where they are defined instead of
+# at the end.
+#pdf_inline_footnotes = True
+
+# verbosity level. 0 1 or 2
+#pdf_verbosity = 0
+
+# If false, no index is generated.
+#pdf_use_index = True
+
+# If false, no modindex is generated.
+#pdf_use_modindex = True
+
+# If false, no coverpage is generated.
+pdf_use_coverpage = True
+
+# Name of the cover page template to use
+pdf_cover_template = 'sphinxcover.tmpl'
+
+# Documents to append as an appendix to all manuals.
+#pdf_appendices = []
+
+# Enable experimental feature to split table cells. Use it
+# if you get "DelayedTable too big" errors
+#pdf_splittables = False
+
+# Set the default DPI for images
+#pdf_default_dpi = 72
+
+# Enable rst2pdf extension modules (default is empty list)
+# you need vectorpdf for better sphinx's graphviz support
+#pdf_extensions = ['vectorpdf']
+
+# Page template name for "regular" pages
+#pdf_page_template = 'cutePage'
+
+

Modified: trunk/server/doc/source/index.rst
===================================================================
--- trunk/server/doc/source/index.rst	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/source/index.rst	2010-05-11 10:10:45 UTC (rev 253)
@@ -16,6 +16,7 @@
    anforderungen.rst
    installationDebian.rst
    installationSUSE.rst
+   installationWindowsServer2003.rst
    konfigurationsdateiVirtualHost.rst
    konfigurationsdateiInteProxy.rst
    ersterTest.rst

Added: trunk/server/doc/source/installationWindowsServer2003.rst
===================================================================
--- trunk/server/doc/source/installationWindowsServer2003.rst	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/source/installationWindowsServer2003.rst	2010-05-11 10:10:45 UTC (rev 253)
@@ -0,0 +1,112 @@
+===============================================================
+Installation des InteProxy Server für Windows Server 2003 (SP2) 
+===============================================================
+
+Die folgende Beschreibung der Installation des InteProxy Servers bezieht sich
+auf `Windows Server 2003 (SP2)`.
+
+Installieren des Apache HTTP Server 2 
+-------------------------------------
+
+Laden Sie den `Apache HTTP Server 2.0.59 mit SSL-Unterstützung für Windows
+<http://archive.apache.org/dist/httpd/binaries/win32/apache_2.0.59-win32-x86-openssl-0.9.7j.msi>`_
+von http://archive.apache.org/dist/httpd/binaries/win32/ herunter.
+
+Installieren Sie den Apache HTTP Server 2.0.59 mit Hilfe des Windows
+Installers. Weitere Informationen zur Installation des Apache HTTP Server
+2.0.59 finden Sie in der Apache Dokumentation `Using Apache with Microsoft
+Windows <http://httpd.apache.org/docs/2.0/platform/windows.html>`_.
+
+Die benötigen Apache-Module werden hierbei bereits mit installiert. 
+
+Herunterladen des InteProxy Servers
+-----------------------------------
+Ab Apache 2.2 wird von der Apache Software Foundation empfohlen, nicht
+mehr eine einzelne Konfigurationsdatei einzusetzen, sondern sie in mehrere
+kleinere Teile aufzutrennen. Eine Praxis, die bei Linux-Distributionen
+schon seit Apache 2.0.50 auf unterschiedliche Weise verfolgt wurde. Auf
+einem Windows-System finden Sie bei einer Standardinstallation jetzt
+ebenfalls mehrere Unterverzeichnisse im /conf-Verzeichnis. 
+
+Die Einrichtung des InteProxy Server erfolgt nach den Empfehlungen der
+Apache Software Foundation.  Laden Sie das InteProxy Server Archive
+herunter (siehe :ref:`download`) und entpacken Sie dieses in das
+Verzeichnis ``C:\Programme\Apache Group\Apache2\conf``.
+
+
+RewriteRule-Konfigurationsdatei
+-------------------------------
+Passen Sie sich die InteProxy-RewriteRule-Datei ``inteproxy-rewrite.conf``
+Ihren Bedürfnissen an. Tauschen Sie in der Zeile ``mapgate`` den
+``USERNAME`` und das ``PASSWORT`` durch das vom LGN übermittelte Passwort
+und Nutzername aus. 
+
+Nach erfolgter Anpassung kopieren Sie die Datei nach 
+``C:\Programme\Apache Group\Apache2\conf\conf\InteProxy-SERVER-1.0.0\server\conf\inteproxy-rewrite.conf``
+
+**inteproxy-rewrite.conf:**
+
+.. code-block:: apacheconf
+
+ RewriteRule ^/inteproxy\-demo\.intevation\.org\/cgi\-bin\/frida\-wms$ \
+ https:/$0?user=meier&password=meier [QSA,P]
+ RewriteRule ^/www\.geobasisdaten\.niedersachsen\.de\/mapgate\/.*$ \
+ https:/$0?user=USERNAME&password=PASSWORT [QSA,P]
+
+**Bitte beachten Sie**: Die Datei ``inteproxy-rewrite.conf`` darf in der
+Zeile RewriteRule **keine** Zeilenbrüche aufweisen. Die Zeilenbrüche
+dienen nur zur besseren Lesbarkeit.
+
+RewriteRule definiert die eigentliche Umleitung. Sie kann mehrmals
+vorkommen, dabei ergibt jedes Vorkommnis eine eigene Umleitung. Die
+Reihenfolge der Umleitungen ist wichtig, da diese in der Reihenfolge ihres
+Vorkommens angewendet werden.
+
+Erwartet als Parameter:
+
+  1. Ausdruck - beschreibt die URLs, die umgeleitet werden sollen
+  2. Umleitung - gibt die Umleitung an
+
+**Ausdruck** beschreibt die URLs, die umgeleitet werden. Es ist ein
+Perl-kompatibler Regulärer Ausdruck (ohne Begrenzerzeichen, '/').
+Vor dem Ausdruck kann zusätzlich ein Ausrufezeichen ('!') stehen, um den
+Regulären Ausdruck zu negieren.
+
+**Umleitung** ist die URL, auf die umgeleitet wird, wenn der Ausdruck
+zutrifft.  
+
+Am Ende der RewriteRule können Sie noch optional einige weitere Optionen
+angeben, welche das Verhalten von mod_rewrite steuern, falls die
+RewriteRule zutrifft. Diese werden in spitzen Klammern ([ bzw. ]) notiert.
+Wenn Sie mehrere angeben, trennen Sie diese durch Kommata. Folgende
+Optionen werden in der InteProxy-RewriteRule-Datei verwendet:
+
+ * **QSA** Diese Option müssen Sie angeben, wenn Sie an die Umleitung manuell einen neuen Query-String hängen und den alten dabei nicht komplett ersetzen wollen.
+ * **P**  Diese Option sorgt dafür, dass ein Zugriff von dem Apache-Modul mod_proxy aus auf die URL erfolgt. Dazu muss mod_proxy aktiviert und die URL muss valide sein (sie muss unter anderem auf jeden Fall mit http://hostname beginnen).
+
+Weitere Informationen finden Sie in der Apache Dokumentation `URL
+Rewriting Guide
+<http://httpd.apache.org/docs/2.0/misc/rewriteguide.html>`_ und in der
+Dokumentation SELFHTML `Umleitungen mit mod_rewrite
+<http://de.selfhtml.org/servercgi/server/rewrite.htm>`_.
+
+Einrichten des InteProxy Servers als seperaten VirtualHost
+----------------------------------------------------------
+Der Standard-Port des Inteproxy Servers ist ``64609`` . Ergänzen Sie daher in
+der Datei ``C:\Programme\Apache Group\Apache2\conf\httpd.conf`` noch die folgende Zeile: ::
+
+ Listen 64609
+
+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 ``C:\Programme\Apache Group\Apache2\conf\httpd.conf`` noch die folgende Zeile: ::
+ 
+  Include conf/InteProxy-SERVER-1.0.0/server/conf/inteproxy-WindowsServer2003.conf
+
+Wenn Sie sich unsicher sind, wie Apache ihre vhost-Konfiguration
+interpretiert, nutzen Sie das Programm ``Test Configuration`` aus
+``Programme -> Apache HTTP Server 2.0.59 -> Configure Apache Server``.
+
+Nach erfolgreichem Test des neu eingerichteten VirtualHost
+``inteproxy-WindowsServer2003`` starten Sie den
+Apache HTTP Server zum Beispiel im ``Apache Service Monitor`` neu.

Modified: trunk/server/doc/source/linkliste.rst
===================================================================
--- trunk/server/doc/source/linkliste.rst	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/source/linkliste.rst	2010-05-11 10:10:45 UTC (rev 253)
@@ -1,8 +1,9 @@
 ==========
-Link Liste
+Linkliste
 ==========
 
  * http://httpd.apache.org (Apache HTTP Server)
+ * http://archive.apache.org/dist/httpd/binaries/win32/ (Apache HTTP Server Archive für historische win32 Versionen)
  * http://httpd.apache.org/docs/2.2/mod/core.html (Apache Core Features)
  * http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html (Apache Module mod_rewrite)
  * http://httpd.apache.org/docs/2.2/mod/mod_authz_host.html (Apache Module mod_authz_host)

Modified: trunk/server/doc/source/versionsgeschichte.rst
===================================================================
--- trunk/server/doc/source/versionsgeschichte.rst	2010-03-22 09:45:44 UTC (rev 252)
+++ trunk/server/doc/source/versionsgeschichte.rst	2010-05-11 10:10:45 UTC (rev 253)
@@ -2,8 +2,12 @@
 Versionsgeschichte
 ==================
 
-Aktuell ist Version 1.0.0 vom 10. Dezember 2009.
+Aktuell ist Version 1.0.1 vom 11. Mai 2010.
 
+Neu seit Version 1.0.1 vom 11. Mai 2010
+---------------------------------------
+ * Erweiterung: Dokumentation der InteProxy-Server-Variante unter Windows 2003 (SP2)
+
 Neu seit Version 1.0.0 vom 10.12.2009
 -------------------------------------
  * Erweiterung: Die Konfigurationsdatei enthält optionale Proxy-Einstellungen. Die Umgebungsvariablen werden weiterhin genutzt.



More information about the Inteproxy-commits mailing list