[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