[PATCH] Dokumention zur Installation erweitert

Wald Commits scm-commit at wald.intevation.org
Wed Oct 30 15:51:48 CET 2013


# HG changeset patch
# User Andre Heinecke <aheinecke at intevation.de>
# Date 1383144693 -3600
# Node ID 9cf5fd49837a3f5d860fba389c9b68218d89a36e
# Parent  fff862f4ef7654609e495a1f710b9552dab58d5b
Dokumention zur Installation erweitert

diff -r fff862f4ef76 -r 9cf5fd49837a artifacts/doc/installation_de.rst
--- a/artifacts/doc/installation_de.rst	Wed Oct 30 15:26:21 2013 +0100
+++ b/artifacts/doc/installation_de.rst	Wed Oct 30 15:51:33 2013 +0100
@@ -1,3 +1,11 @@
+.. header::
+
+    ###Title### - ###Section###
+
+.. footer::
+
+    Seite ###Page### / ###Total###
+
 =================
 FLYS Installation
 =================
@@ -24,26 +32,47 @@
 
 Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen.
 
+Je nach OpenSUSE Version müssen noch weitere Repositories hinzugefügt werden.
+Unter ``10.140.90.89/wiki`` können durch eine Suche nach ``repos`` weitere
+repositories hinzugefügt werden.
+
+#. Einloggen als root nutzer::
+
+    su
+
 #. Hinzufügen des OBS Repositorys von Intevation::
 
     zypper addrepo -f \
     http://download.opensuse.org/repositories/home:/intevation:/bfg/
     SLE_11_SP1/home:intevation:bfg.repo
 
+#. Zusätzlich muss noch das SLES 11 SDK repo hinzgefügt werden::
+
+    zypper ar -t YUM http://voss-update/repo/\$RCE/
+    SLE11-SDK-Pool/sle-11-x86_64 SLE11-SDK-POOL
+
 #. Installieren der benötigten Pakete::
 
     zypper install python-devel python-setuptools libxslt-devel libxml2-devel \
         mozilla-nss-devel apache2 tomcat6 java-1_6_0-ibm libgeos0 netcdf \
-        proj xerces-c FastCGI php MyODBC-unixODBC posgresql-libs
+        proj xerces-c FastCGI php MyODBC-unixODBC postgresql-libs gd
+
+Sollte es Probleme mit der Abhängikeitsauflösung von xerces-c geben kann
+darauf verzichtet werden xerces-c 2.x zu installieren. Dies sollte
+als Optionsfrage zur Auswahl stehen.
 
 #. Anlegen der Logger Gruppe::
 
     gropadd flys_log
 
-#. Anlegen des Flys Nutzers::
+#. Anlegen des Flys Nutzers (sofern noch nicht vorhanden)::
 
     useradd -G users,flys_log,www -m flys
 
+#. Flys Nutzer der Gruppe flys_log hinzufügen (wenn nutzer bereits vorhanden)::
+
+    usermod -A flys_log flys
+
 #. Tomcat und Apache zur flys_log Gruppe hinzufügen::
 
     usermod -A flys_log tomcat
@@ -69,6 +98,7 @@
 
 Nun sollte der weitere Inhalt der beiliegenden CD nach /opt/flys
 kopiert und dem Benutzer flys zugänglich gemacht werden.
+(z.B.: cp -r /media/UDF\ Volume/* /opt/flys)
 
 .. raw:: pdf
 
@@ -77,7 +107,7 @@
 Oracle Client installieren
 --------------------------
 
-#. Instantclient entpacken::
+#. Instantclient entpacken (als root)::
 
     cd /opt
     tar -xf /opt/flys/instantclient_11_2.tar.gz
@@ -100,8 +130,8 @@
 
     --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
+        '/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 1G AUTOEXTEND ON NEXT
+        100M MAXSIZE 10G LOGGING ONLINE PERMANENT BLOCKSIZE 16384 EXTENT
         MANAGEMENT LOCAL AUTOALLOCATE DEFAULT NOCOMPRESS SEGMENT SPACE
         MANAGEMENT AUTO;
     --CREATE USER
@@ -114,11 +144,15 @@
     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;
+    GRANT CONNECT TO flys3;
 
+Dieses Beispiel soll nur zur groben Orientieren dienen welche Rechte FLYS
+benötigt. Speziellere Konfiguration ist mit dem zuständigen DB-Admin zu
+klären.
 
-``Schema importieren``
-~~~~~~~~~~~~~~~~~~~~~~
+
+``Tabellen anlegen``
+~~~~~~~~~~~~~~~~~~~~
 
 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein
 alternativer Client verwendet werden. Die SQL-Skripte liegen im Unterordner
@@ -131,10 +165,16 @@
 #. oracle-spatial.sql
 #. oracle-spatial_idx.sql
 
+Wechseln in den db-schema Ordner (als flys nutzer)::
 
-Mit einem vorhandenen sqlplus unter /opt/instantclient_11_2::
+    cd /opt/flys/db-schema
 
-    NLS_LANG=.AL32UTF8 /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<dbname>
+SQLPlus aufrufen (mit passendem Encoding zu den scripten)::
+
+    NLS_LANG=.AL32UTF8 /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<service>
+
+Dann im sqlplus client::
+
     @oracle.sql
     @oracle-minfo.sql
     @oracle-spatial.sql
@@ -147,9 +187,14 @@
 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
+    @oracle-drop-spatial.sql
+    @oracle-drop-minfo.sql
+    @oracle-drop.sql
+
+.. raw:: pdf
+
+    PageBreak
+
 
 D4E-River Server Installieren
 -----------------------------
@@ -159,6 +204,21 @@
 zur Verfügung gestellt. Als Beispiel wird hier die Version 3.0.16
 angenommen.
 
+``Passende Java Version installieren``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+D4E-River benötigt ein Sun oder OpenJDK Java. Dieses muss extra
+installiert werden::
+
+    cd /opt/flys
+    sh ./jdk-6u26-linux-x64-rpm.bin
+    update-alternatives --install /usr/bin/java java /usr/java/jdk1.6.0_26/bin/java 5
+    update-alternatives --install /etc/alternatives/jre jre /usr/java/jdk1.6.0_26/jre 5
+    update-alternatives --config java
+
+In dem folgenden Menü sollte als option die Java Version auswählen, welche unter
+/usr/java liegt.
+
 ``Server entpacken``
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -177,26 +237,28 @@
 
 ``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.
+Die externen Datenbanken von Dive4Element River werden in den
+folgenden Dateien konfiguriert.::
 
-    In diesen sind Nutzername, Passwort und URL entsprechend den passenden
-    Werten anzupassen.
+    /opt/flys/flys-3.0.16/server/conf/backend-db.xml
+    /opt/flys/flys-3.0.16/server/conf/seddb-db.xml
 
-    Die URL ist dabei nach folgendem Schema aufgebaut:
-        jdbc:oracle:thin:@//<hostname>:<port>/<backend>
+In diesen sind Nutzername, Passwort und URL entsprechend den passenden
+Werten anzupassen.
 
-    Mithilfe des Eintrags::
+Die URL ist dabei nach folgendem Schema aufgebaut:
+    jdbc:oracle:thin:@//<hostname>:<port>/<service>
 
-        <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls>
+Mithilfe des Eintrags::
 
-    kann man den initalen Schema Präfix der Datenbank ändern.
-    Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist.
-    z.B.::
+    <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls>
 
-        <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls>
+kann man den initalen Schema Präfix der Datenbank ändern.
+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>
 
 #. URL für Kartendienste
     Sollte der Host-Name des neuen Servers nicht flys3-devel.bafg.de lauten, muss man
@@ -210,13 +272,16 @@
     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 auf das System kopieren:
+    Die Gewässerdaten müssen auf das System übertragen werden und
+
 #. 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>
+        <dgm-path>/opt/gewaesser<dgm-path>
 
 ``Server starten``
 ~~~~~~~~~~~~~~~~~~
@@ -240,7 +305,7 @@
 
     /etc/init.d/d4e-river start
 
-Nun kann man sich mit einem Blick in /var/log/server-3.0.16.log
+Nun kann man sich mit einem Blick in /var/log/flys/server-3.0.16.log
 vergewissern, dass der Server korrekt gestartet wurde. In diesem
 Fall wäre die letze Zeile des Logs in der Art::
 
@@ -254,7 +319,7 @@
 ------------------------
 
 In SuSE Linux Enterprise ist kein Paket für den benötigten Mapserver
-vorhanden. Dieses muss manuell installiert werden::
+vorhanden. Dieses muss manuell installiert werden (root)::
 
     cd /opt/flys/mapserver-pakete
     rpm -i --nodeps *.rpm
@@ -281,7 +346,13 @@
 Apache Konfiguration kopieren::
 
     cp /opt/flys/flys.conf /etc/apache2/vhosts.d
-    /etc/init.d/apache2 reload
+
+In der Konfigurationsdatei ``/etc/apache2/vhosts.d/flys.conf`` muss ggf.
+der redirect auf einen anderen Host geändert werden.
+
+Apache neu starten::
+
+    /etc/init.d/apache2 restart
 
 ``HTTPS einrichten``
 ~~~~~~~~~~~~~~~~~~~~
@@ -297,12 +368,15 @@
     RewriteCond %{REQUEST_URI} !^/cgi-bin/
     RewriteRule (.*) https://flys3-devel.bafg.de/$1 [R=301,L]
 
+.. raw:: pdf
+
+    PageBreak
 
 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.::
+muss der Client nur an die richtige Stelle kopiert werden. (als root)::
 
     /etc/init.d/tomcat6 stop
     cp /opt/flys/flys-3.0.16/client/flys-3.0.16.war /usr/share/tomcat6/webapps
@@ -311,8 +385,17 @@
 Das Neustarten des Tomcat Servers ist hierbei optional, kann aber dazu dienen
 die Stabilität des Tomcat Servers zu verbessern.
 
-Ggf. ist noch der eintrag print-url in der web.xml anzupassen insbesondere
-wenn man zwischen https und http wechselt. Default ist https.
+Ggf. ist noch der Eintrag print-url in der Datei
+``/usr/share/tomcat/webapps/flys-3.0.16/WEB-INF/web.xml`` anzupassen
+insbesondere wenn man zwischen https und http wechselt. Default ist https.
+
+
+In der Datei ``/var/log/tomcat6/catalina.out`` kann man nachsehen ob
+der Start erfolgreich war. Gab es Probelme mit Java muss man
+ggf. die verwendete Java Version in /etc/tomcat6/tomcat6.conf
+anpassen indem man den Eintrag JAVA_HOME ändert::
+
+    JAVA_HOME="/usr/java/jdk1.6.0_26/jre"
 
 Wiki installieren
 -----------------
@@ -332,3 +415,43 @@
     cd /home/flys/wiki/moin-2013-02-01/wiki/
     chown -R wwwrun data underlay
 
+.. raw:: pdf
+
+    PageBreak
+
+
+FLYS-Importer
+-------------
+
+Um den Flys Importer nach /opt/flys zu installieren
+reicht es Diesen zu entpacken (als Nutzer flys).::
+
+    cd /opt/flys
+    tar -xf /opt/flys-importer_201310251707.tar.gz
+
+Dieser liegt anschließend unter /opt/flys-importer
+bereit. Die Konfiguration und Verwendung ist der
+Importer Dokumentation zu entnehmen. Diese liegt
+nun unter::
+
+    /opt/flys/flys-importer/importer-manual.pdf
+
+AFT-DIPS
+--------
+
+AFT Dips nach /opt/flys installieren::
+
+    cd /opt/flys/
+    tar -xf aft-dips-etl.tar.gz
+
+Ggf. muss nun noch die Konfiguration der Datenbanken angepasst werden.
+Die zugehörige Konfigurationsdatei ist::
+
+    /opt/flys/aft-dips-etl/conf/conf.xml
+
+Der Prozess kann nun ausgeführt werden::
+
+    /opt/flys/aft-dips-etl/bin/run.sh
+
+Logs des AFT/DIPS synchronisationsprozesses werden unter
+``/opt/flys/aft-dips-etl/logs`` abgelegt.


More information about the Dive4elements-commits mailing list