[PATCH 1 of 3] More installation documentation

Mon Oct 28 15:46:47 CET 2013

# HG changeset patch
# User Andre Heinecke <aheinecke at intevation.de>
# Date 1382966153 -3600
# Node ID b6e954fa8b82640e9684fa57bd0db51cf4e5dd1a
# Parent  6b8d9c001329d11ea09e39af37e9fa9baa52a87f
More installation documentation

diff -r 6b8d9c001329 -r b6e954fa8b82 artifacts/doc/installation_de.rst

--- a/artifacts/doc/installation_de.rst	Mon Oct 28 12:14:46 2013 +0100
+++ b/artifacts/doc/installation_de.rst	Mon Oct 28 14:15:53 2013 +0100
@@ -20,10 +20,17 @@
 
 Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen.
 
+#. Hinzufügen des OBS repositories von Intevation::
+
+    zypper addrepo -f \
+    http://download.opensuse.org/repositories/home:/intevation:/bfg/
+    SLE_11_SP1/home:intevation:bfg.repo
+
 #. Installieren der Benötigten Pakete::
 
     zypper install python-devel python-setuptools libxslt-devel libxml2-devel \
-        mozilla-nss-devel apache2 tomcat6 mapserver
+        mozilla-nss-devel apache2 tomcat6 java-1_6_0-ibm libgeos0 netcdf \
+        proj xerces-c FastCGI php MyODBC-unixODBC posgresql-libs
 
 #. Anlegen der Logger Gruppe::
 
@@ -31,26 +38,47 @@
 
 #. Anlegen des Flys Nutzers::
 
-    useradd -g flys -G users,flys_log,www -m -c "Flys Service User" flys
+    useradd -G users,flys_log,www -m flys
 
 #. tomcat und apache zur flys_log Gruppe hinzufügen::
 
-    usermod -G flys_log,tomcat tomcat
-    usermod -G flys_log,wwwrun,www wwwrun
+    usermod -A flys_log tomcat
+    usermod -A flys_log wwwrun
 
 #. Logging Verzeichnis anlegen::
 
     mkdir /var/log/flys
     chgrp flys_log /var/log/flys
-    chmod 770 /var/log/flys
+    chmod 775 /var/log/flys
 
 #. Betriebsordner Anlegen::
 
     mkdir /opt/flys
     chown flys /opt/flys
 
-Anschließend sollte der weitere Inhalt der beiliegenden CD nach /opt/flys
-kopiert werden und dem Benutzer flys zugägnlich gemacht werden.
+#. Firewall ausschalten::
+
+    SuSEfirewall2 off
+
+Der Key Fingerprint des Intevations Repositories ist:
+``18F8 A017 6DFB 7FD1 22BC  20D6 A73E 24AF BC5A 7BAC``
+
+Nun sollte der weitere Inhalt der beiliegenden CD nach /opt/flys
+kopiert werden und dem Benutzer flys zugänglich gemacht werden.
+
+Oracle client installieren
+--------------------------
+
+#. Instantclient entpacken::
+
+    cd /opt
+    tar -xf /opt/flys/instantclient_11_2.tar.gz
+    chown -R flys /opt/instantclient_11_2
+
+#. Library loader konfigurieren::
+
+    cp /opt/flys/oci.conf /etc/ld.so.conf.d/oci.conf
+
 
 Datenbank initalisieren
 -----------------------
@@ -60,9 +88,7 @@
 
 Das erstellen der Datenbank sollte vom zuständigen DB-Admin bereits durchgeführt worden
 sein. Wichtig ist insbesondere das der Nutzer zugriff auf die Spatial tabellen besitzt.
-Im folgenden ein Beispiel:
-
-.. code:: sql
+Im folgenden ein Beispiel::
 
     --CREATE TABLESPACE for user
     CREATE TABLESPACE "flys3" DATAFILE
@@ -84,9 +110,11 @@
 
 
 ``Schema importieren``
+~~~~~~~~~~~~~~~~~~~~~~
 
 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein
-alternativer client verwendet werden. Wichtig ist das die folgenden
+alternativer client verwendet werden. Die SQL skripte liegen im unterordner
+DB-Schema. Wichtig ist das die folgenden
 SQL scripte in dieser Reihenfolge und in einer UTF-8 Umgebung
 ausgeführt werden:
 
@@ -137,12 +165,11 @@
 
 #. Symlink für die aktuelle Version anlegen::
 
-    rm -f flys-current
-    ln -s flys-3.0.16 flys-current
+    ln -s flys-3.0.16 current
 
 ``Server konfigurieren``
 ~~~~~~~~~~~~~~~~~~~~~~~~
-#. Datenbank verbindung:
+#. Datenbank Verbindung:
 
     Die externen Datenbanken von Dive4Element River werden in den Dateien
     server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert.
@@ -158,7 +185,7 @@
         <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls>
 
     kann man den initalen Schema Präfix der Datenbank ändern.
-    Wobei $SCHEMA ein Platzhalterfür das zu verwendende Schema ist.
+    Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist.
     z.B.::
 
         <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls>
@@ -168,7 +195,7 @@
     noch die entsprechenden Verweise auf den Kartendienst anpassen::
 
         cd /opt/flys/flys-3.0.16/server/conf
-        sed -i @flys3-devel.bafg.de@<neue_url>@ rivermap.xml floodmap.xml
+        sed -i s at flys3-devel.bafg.de@<neue_url>@ rivermap.xml floodmap.xml
 
 #. URL für das Wiki:
     Die URL unter welcher das flys wiki erwartet wird ist in server/conf/conf.xml
@@ -193,12 +220,13 @@
 #. Startscript hinterlegen::
 
     cp /opt/flys/d4e-river /etc/init.d
+    chmod u+x /etc/init.d/d4e-river
     cd /etc/init.d/rc3.d
-    ln -s S10d4e-river ../d4e-river
-    ln -s K10d4e-river ../d4e-river
+    ln -s ../d4e-river S10d4e-river
+    ln -s ../d4e-river K10d4e-river
     cd /etc/init.d/rc5.d
-    ln -s S10d4e-river ../d4e-river
-    ln -s K10d4e-river ../d4e-river
+    ln -s ../d4e-river S10d4e-river
+    ln -s ../d4e-river K10d4e-river
 
 #. Server starten::
 
@@ -213,20 +241,50 @@
 Kartendienste einrichten
 ------------------------
 
+In SuSE Linux Enterprise ist kein Paket für den benötigten Mapserver
+vorhanden. Dieses muss manuell installiert werden::
+
+    cd /opt/flys/mapserver-pakete
+    rpm -i --nodeps *.rpm
+
+Ob die Installation erfolgreich war kann man durch Abfrage der Mapserver
+Version testen::
+
+    /srv/www/cgi-bin/mapserv -v
+
 Nun können die Kartendienste (river-wms, user-wms) von flys eingerichtet
 werden (als root)::
 
     cp /opt/flys/*-wms /srv/www/cgi-bin/
+    chmod a+x /srv/www/cgi-bin/*-wms
 
 Apache konfigurieren
 --------------------
 
-** TODO **
+Eine Beispielkonfiguration für den Apache Webserver ist die Datei flys.conf
+auf der beigelegten CD. Diese kann in das Apache vhosts.d Verzeichnis kopiert
+werden. In dieser muss ggf. der Redirect für das Geoportal angepasst werden,
+da in diesem die URL enthalten ist.
+
+Apache Konfiguration kopieren::
+
+    cp /opt/flys/flys.conf /etc/apache2/vhosts.d
+    /etc/init.d/apache2 reload
 
 ``HTTPS einrichten``
 ~~~~~~~~~~~~~~~~~~~~
 
-** TODO **
+Um verschlüsselten Zugriff über https einzurichten kann man o.g. Konfiguration
+entsprechend anpassen. Wie dies zu geschehen hat ist der Apache Dokumentation
+zu entnehmen und soll nicht teil dieser Anleitung sein. Allerdings ist bemerkenswert
+das darauf geachtet werden sollte es weiterhin zu ermöglichen Kartendienste über
+http abzurufen. Dies kann man durch einen Bedingten redirect in der Konfiguration
+des VirtualHosts auf Port 80 erreichen::
+
+    RewriteEngine on
+    RewriteCond %{REQUEST_URI} !^/cgi-bin/
+    RewriteRule (.*) https://flys3-devel.bafg.de/$1 [R=301,L]
+
 
 Web Client Installieren
 -----------------------
@@ -239,15 +297,16 @@
     /etc/init.d/tomcat6 start
 
 Das neustarten des Tomcat Servers ist hierbei optional. Kann aber dazu dienen
-die stabilität des Tomcat Servers zu verbessern.
+die Stabilität des Tomcat Servers zu verbessern.
 
 Wiki Installieren
 -----------------
 
-** TODO **
+Das Wiki für den Fachdienst Flys ist so konfiguriert das es
+unter /home/flys/wiki erwartet wird.
 
-``SAML``
-~~~~~~~~
+Wiki entpacken::
 
-** TODO **
-
+    su - flys
+    cd /home/flys
+    tar -xf /opt/flys/flys-wiki.tar.gz
