[PATCH] Start installation documentation for specific client installation
Wald Commits
scm-commit at wald.intevation.org
Sun Oct 27 17:30:43 CET 2013
# HG changeset patch
# User Andre Heinecke <andre.heinecke at intevation.de>
# Date 1382891438 -3600
# Node ID 5363047c827436405467d9109f28e34d79b4e2ad
# Parent e5e25586189cfe931e21967b50c0ae773766e46f
Start installation documentation for specific client installation
diff -r e5e25586189c -r 5363047c8274 artifacts/doc/installation_de.rst
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/artifacts/doc/installation_de.rst Sun Oct 27 17:30:38 2013 +0100
@@ -0,0 +1,253 @@
+=================
+FLYS Installation
+=================
+
+.. contents:: Inhalt
+
+Übersicht
+---------
+
+Dieses Dokument beschreibt die Installation des Fachdienstes FLYS.
+
+Abgehandelt werden die Installation der Server Anwendung (D4E-River),
+der Webanwendung, die Einrichtung der Datenbanken sowie die Einrichtung
+des Moin Wikis.
+
+Als Basis dient ein SUSE Linux Enterprise Server in Version 11.2.
+
+Vorbereitung des Systems
+---------------------------
+
+Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen.
+
+#. Installieren der Benötigten Pakete::
+
+ zypper install python-devel python-setuptools libxslt-devel libxml2-devel \
+ mozilla-nss-devel apache2 tomcat6 mapserver
+
+#. Anlegen der Logger Gruppe::
+
+ gropadd flys_log
+
+#. Anlegen des Flys Nutzers::
+
+ useradd -g flys -G users,flys_log,www -m -c "Flys Service User" flys
+
+#. tomcat und apache zur flys_log Gruppe hinzufügen::
+
+ usermod -G flys_log,tomcat tomcat
+ usermod -G flys_log,wwwrun,www wwwrun
+
+#. Logging Verzeichnis anlegen::
+
+ mkdir /var/log/flys
+ chgrp flys_log /var/log/flys
+ chmod 770 /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.
+
+Datenbank initalisieren
+-----------------------
+
+``Datenbank erstellen``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+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
+
+ --CREATE TABLESPACE for user
+ CREATE TABLESPACE "flys3" DATAFILE
+ '/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 500M AUTOEXTEND ON NEXT
+ 100M MAXSIZE 1G LOGGING ONLINE PERMANENT BLOCKSIZE 8192 EXTENT
+ MANAGEMENT LOCAL AUTOALLOCATE DEFAULT NOCOMPRESS SEGMENT SPACE
+ MANAGEMENT AUTO;
+ --CREATE USER
+ CREATE USER flys3 IDENTIFIED BY flys3;
+ -- USER SQL
+ ALTER USER flys3 DEFAULT TABLESPACE "flys3" TEMPORARY TABLESPACE "TEMP"
+ ACCOUNT UNLOCK ;
+ -- QUOTA for user on TABLESPACE
+ ALTER USER flys3 QUOTA UNLIMITED ON "flys3";
+ GRANT ALL on "MDSYS"."ALL_SDO_GEOM_METADATA" to flys3 ;
+ GRANT CREATE SESSION TO flys3 ;
+ GRANT CREATE VIEW TO flys3;
+ GRANT CONNECT, RESOURCE TO flys3;
+
+
+``Schema importieren``
+
+Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein
+alternativer client verwendet werden. Wichtig ist das die folgenden
+SQL scripte in dieser Reihenfolge und in einer UTF-8 Umgebung
+ausgeführt werden:
+
+#. oracle.sql
+#. oracle-minfo.sql
+#. oracle-spatial.sql
+#. oracle-spatial_idx.sql
+
+
+Mit einem vorhandenden sqlplus unter /opt/instantclient_11_2::
+
+ NLS_LANG=.AL32UTF8 rlwrap /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<dbname>
+ @oracle.sql
+ @oracle-minfo.sql
+ @oracle-spatial.sql
+ @oracle-spatial_idx.sql
+
+``Schema löschen``
+~~~~~~~~~~~~~~~~~~
+
+Zum löschen der im Schritt Schema importieren importierten Schemata
+liegen entsprechende drop Skripte bereit. Diese sollten bei Bedarf in
+folgender Reihenfolge ausgeführt werden::
+
+ #. oracle-drop-spatial.sql
+ #. oracle-drop-minfo.sql
+ #. oracle-drop.sql
+
+D4E-River Server Installieren
+-----------------------------
+
+Neue Versionen des gesamten FLYS Pakets werden üblicherweise als
+GZIP komprimierter Tarball mit dem Namenschema flys-VERSION.tar.gz
+zur verfügung gestellt. Als Beispiel wird hier die Version 3.0.16
+angenommen.
+
+``Server entpacken``
+~~~~~~~~~~~~~~~~~~~~
+
+#. Als Nutzer flys einloggen::
+
+ su - flys
+
+#. Tarball entpacken::
+
+ cd /opt/flys
+ tar -xf flys-3.0.16.tar.gz
+
+#. Symlink für die aktuelle Version anlegen::
+
+ rm -f flys-current
+ ln -s flys-3.0.16 flys-current
+
+``Server konfigurieren``
+~~~~~~~~~~~~~~~~~~~~~~~~
+#. Datenbank verbindung:
+
+ Die externen Datenbanken von Dive4Element River werden in den Dateien
+ server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert.
+
+ In diesen sind Nutzername, Passwort und URL entsprechend den passenden
+ Werten anzupassen.
+
+ Die URL ist dabei nach folgendem Schema aufgebaut:
+ jdbc:oracle:thin:@//<hostname>:<port>/<backend>
+
+ Mithilfe des Eintrags::
+
+ <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.
+ z.B.::
+
+ <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls>
+
+#. URL für Kartendienste
+ Sollte der Host Name des neuen Servers nicht flys3-devel.bafg.de lauten muss man
+ 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
+
+#. URL für das Wiki:
+ Die URL unter welcher das flys wiki erwartet wird ist in server/conf/conf.xml
+ im Eintrag <help-url> konfiguriert. Dies muss auch ggf. auf den neuen Host Namen
+ angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki
+
+#. Gewässerdaten:
+ Zur Berechnung von Überschwemmungsflächen werden Digitale Geländemodelle benötigt.
+
+ Der Ort an dem diese Daten liegen ist in der Datei server/conf/conf.xml als <dgm-path>
+ zu konfigurieren. z.B.::
+
+ <dgm-path>/home/teichmann/gewaesser-final/</dgm-path>
+
+``Server starten``
+~~~~~~~~~~~~~~~~~~
+
+#. Zurück auf root wechseln::
+
+ exit
+
+#. Startscript hinterlegen::
+
+ cp /opt/flys/d4e-river /etc/init.d
+ cd /etc/init.d/rc3.d
+ ln -s S10d4e-river ../d4e-river
+ ln -s K10d4e-river ../d4e-river
+ cd /etc/init.d/rc5.d
+ ln -s S10d4e-river ../d4e-river
+ ln -s K10d4e-river ../d4e-river
+
+#. Server starten::
+
+ /etc/init.d/d4e-river start
+
+Nun kann sich mit einem Blick in /var/log/server-3.0.16.log
+vergewissern das der Server korrekt gestartet wurde. In diesem
+Fall wäre die Letze Zeile des logs in der Art::
+
+ INFO Standalone - Starting org.dive4elements.artifactdatabase.rest.Standalone HTTP server on localhost:18989
+
+Kartendienste einrichten
+------------------------
+
+Nun können die Kartendienste (river-wms, user-wms) von flys eingerichtet
+werden (als root)::
+
+ cp /opt/flys/*-wms /srv/www/cgi-bin/
+
+Apache konfigurieren
+--------------------
+
+** TODO **
+
+``HTTPS einrichten``
+~~~~~~~~~~~~~~~~~~~~
+
+** TODO **
+
+Web Client Installieren
+-----------------------
+
+Der Web client läuft als Tomcat Webapp. Damit tomcat diesen startet
+muss der client nur an die Richtige stelle kopiert werden.::
+
+ /etc/init.d/tomcat6 stop
+ cp /opt/flys/flys-3.0.16/client/flys-3.0.16.war /usr/share/tomcat6/webapps
+ /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.
+
+Wiki Installieren
+-----------------
+
+** TODO **
+
+``SAML``
+~~~~~~~~
+
+** TODO **
+
More information about the Dive4elements-commits
mailing list