# HG changeset patch # User Andre Heinecke # 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 /@:/ + @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:@//:/ + + Mithilfe des Eintrags:: + + ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA; + + kann man den initalen Schema Präfix der Datenbank ändern. + Wobei $SCHEMA ein Platzhalterfür das zu verwendende Schema ist. + z.B.:: + + ALTER SESSION SET CURRENT_SCHEMA=SEDDB; + +#. 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@@ 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 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 + zu konfigurieren. z.B.:: + + /home/teichmann/gewaesser-final/ + +``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 ** +