changeset 5065:a56efdfcab17 dami

Simplify installation instruction and move it to overview as it applies for both importer
author Andre Heinecke <aheinecke@intevation.de>
date Wed, 20 Feb 2013 18:26:57 +0100
parents fb7c4ad94bd8
children 8208df10df79
files flys-backend/doc/documentation/de/importer-geodaesie.tex flys-backend/doc/documentation/de/importer-hydr-morph.tex flys-backend/doc/documentation/de/importer-manual.tex flys-backend/doc/documentation/de/overview.tex
diffstat 4 files changed, 111 insertions(+), 120 deletions(-) [+]
line wrap: on
line diff
--- a/flys-backend/doc/documentation/de/importer-geodaesie.tex	Wed Feb 20 17:24:49 2013 +0100
+++ b/flys-backend/doc/documentation/de/importer-geodaesie.tex	Wed Feb 20 18:26:57 2013 +0100
@@ -185,114 +185,6 @@
 Attribut    &   name, diff, count, area, perimeter \\
 \end{tabular}
 
-
-\subsection{Systemanforderungen}
-\label{Systemanforderungen}
-\begin{itemize}
-  \item Oracle Datenbank inkl. Schema für FLYS
-  \item GDAL ab Version 1.9 für Python mit Oracle Support
-  \item ogr2ogr
-  \item Python $>=$ 2.6
-\end{itemize}
-
-
-\subsection{Installationsanleitung}
-\label{Installationsanleitung}
-
- \subsubsection Oracle Instantclient\\
- % TODO: oracle_cx
- Der Oracle Instantclient 11.2.0.2.0 wird benötigt, damit der Importer mittels Python
-und GDAL in die bestehende Oracle Datenbank schreiben kann. Wenn Sie
-eine PosgreSQL Datenbank verwenden, können Sie diesen Schritt überspringen.
-
-Zur Anbindung von Oracle ist es erforderlich, folgende Archive von
-Oracle herunterzuladen (Sie benötigen dafür ein Oracle Benutzerkonto):
-
-Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python
-und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es
-erforderlich, folgende Archive von Oracle herunterzuladen. 
-
- \begin{itemize}
-    \item instantclient-basic-linux-x86-64-11.2.0.2.0.zip
-    \item instantclient-sdk-linux-x86-64-11.2.0.2.0.zip
-    \item instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip
- \end{itemize}
-
-Zu finden sind die
- Pakete unter:\\
-\href{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
-{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
-
-
-Um diese Pakete zu installieren, öffnen Sie eine Konsole und wechseln
-in das Verzeichnis in welches Sie die heruntergeladenen Pakete
-gespeichert haben. (z.B.: cd /home/benutzername/Downloads )
- Anschließend führen Sie folgende Befehle auf der Kommandozeile aus:
-
- \begin{lstlisting}
-     mkdir /opt
-
-     unzip instantclient-basic-linux-x86-64-11.2.0.2.0.zip -d /opt
-     unzip instantclient-sdk-linux-x86-64-11.2.0.2.0.zip -d /opt
-     unzip instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip -d /opt
-
-     mkdir /opt/instantclient_11_2/lib
-     cd /opt/instantclient_11_2/lib
-     ln -s ../libclntsh.so.11.1 .
-     ln -s ../libclntsh.so.11.1 libclntsh.so
-     ln -s ../libnnz11.so .
-     ln -s ../libocci.so.11.1 .
-     ln -s ../libocci.so.11.1 libocci.so
-     ln -s ../libociei.so .
-     ln -s ../libocijdbc11.so .
-     ln -s ../libsqlplusic.so .
-     ln -s ../libsqlplus.so .
-
-     echo "/opt/instantclient_11_2/lib/" > /etc/ld.so.conf.d/oci.conf 
-     ldconfig
- \end{lstlisting}
-
-Sollten keine Fehler aufgetreten sein, haben Sie den \textit{Oracle
- Instantclient 11.2} erfolgreich entpackt und im Dateisystem unter
- \textit{/opt/instantclient\_11\_2} abgelegt.
-
-\subsubsection Python, Mapserver und GDAL\\
-Installieren Sie nun die restlichen benötigten Pakete.
-Dazu installieren Sie zuerst einige Abhängigkeiten und anschließend die
-von der Intevation GmbH bereitgestellten speziellen Versionen von gdal
-und Mapserver.
-% ^ Das sollte sich in zukunft ändern und alles in einem repo sein.
-
-Um die Abhängigkeiten zu installieren führen Sie bitte folgende Befehle aus:
-
- \begin{lstlisting}
-     zypper ar http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/ "intevation:bfg"
-     rpm --import http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/repodata/repomd.xml.key
-     zypper ref # Paketlist neu laden
-     zypper in python libgeos0 libproj0 proj netcdf libnetcdf4 xerces-c libxerces-c-3_0 FastCGI
-     zypper mr -d "intevation:bfg"
-     zypper ref # Paketliste neu laden
-     ln -s /usr/lib64/libproj.so.0.6.6 /usr/lib64/libproj.so
- \end{lstlisting}
-
-Nun können Sie die unter \url{http://ftp.intevation.de/local/flys/2012-09-11/RPMS/x86\_64}
-bereitgestellten Pakete:
-\begin{itemize}
-\item libgdal1-1.9.0-intevation1.x86\_64.rpm
-\item gdal-1.9.0-intevation1.x86\_64.rpm
-\item python-gdal-1.9.0-intevation1.x86\_64.rpm
-\item mapserver-6.0.2-1.x86\_64.rpm
-\end{itemize}
-
-Installieren. Laden Sie diese dazu Herunter und wechseln Sie in das Verzeichnis in welches Sie
-die Pakete heruntergeladen haben und führen Sie dann folgende Befehle aus:
-
- \begin{lstlisting}
- rpm -i --nodeps libgdal1-1.9.0-intevation1.x86_64.rpm gdal-1.9.0-intevation1.x86_64.rpm python-gdal-1.9.0-intevation1.x86_64.rpm 
- rpm -i --nodeps mapserver-6.0.2-1.x86_64.rpm
- \end{lstlisting}
-
-
 \subsection{Konfiguration}
 \label{Konfiguration}
 Der Geodaten Importer kann über die Datei \textit{contrib/run\_geo.sh}
--- a/flys-backend/doc/documentation/de/importer-hydr-morph.tex	Wed Feb 20 17:24:49 2013 +0100
+++ b/flys-backend/doc/documentation/de/importer-hydr-morph.tex	Wed Feb 20 18:26:57 2013 +0100
@@ -747,7 +747,7 @@
 gestartet. Dazu führen folgenden Befehl aus:\\
 
 \begin{lstlisting}
-    contrib/run_hydr_morph.sh
+    ./run_hydr_morph.sh
 \end{lstlisting}
 
 Nachdem der Prompt der Konsole zurückkehrt, ist der Import abgeschlossen oder es
--- a/flys-backend/doc/documentation/de/importer-manual.tex	Wed Feb 20 17:24:49 2013 +0100
+++ b/flys-backend/doc/documentation/de/importer-manual.tex	Wed Feb 20 18:26:57 2013 +0100
@@ -24,9 +24,9 @@
 % Document DATE and VERSION
 % set these values when releasing a new version
 
-\newcommand{\documentdate}{30. August 2012}
-\newcommand{\documentversion}{1.0}
-\newcommand{\documentrevision}{rev5303}
+\newcommand{\documentdate}{19. Februar 2013}
+\newcommand{\documentversion}{1.1}
+\newcommand{\documentrevision}{rev5062}
 \newcommand{\documentID}{importer-manual.tex}
 %----------------------------------------------
 
--- a/flys-backend/doc/documentation/de/overview.tex	Wed Feb 20 17:24:49 2013 +0100
+++ b/flys-backend/doc/documentation/de/overview.tex	Wed Feb 20 18:26:57 2013 +0100
@@ -48,8 +48,15 @@
 Bitte beachten Sie, dass diese Werkzeuge nicht zur Installtion und zum Betrieb
 der Software selbst notwendig sind!
 
+\subsection{Systemanforderungen}
+\label{Systemanforderungen}
+\begin{itemize}
+  \item Oracle oder PosgreSQL Datenbank inkl. Schema für FLYS
+  \item SUSE Enterprise Linux 11.2 SP 1
+\end{itemize}
 
-\subsubsection{Vorbereiten der Datenbank}
+\subsection{Installationsanleitung}
+\label{Installationsanleitung}
 
 Nachdem Sie das Paket nun in das Heimatverzeichnis des Nutzers auf das
 Zielsystem kopiert haben, entpacken Sie es mit folgenden Befehlen:
@@ -60,6 +67,95 @@
     cd flys-importer
 \end{lstlisting}
 
+\subsubsection Java
+Der flys-importer benötigt Java Version 6 um diese zu installieren laden Sie
+bitte von \url{http://www.oracle.com/technetwork/java/javase/downloads/jdk6downloads-1902814.html}
+eine aktulle Java Version als -rpm.bin herunter. Zum Beispiel: jdk-6u41-linux-x64-rpm.bin
+
+Nach dem Herunterladen, öffnen Sie eine konsole und wechseln in das Downloadverzeichnis.
+Führen Sie nun folgende Befehle aus:
+
+ \begin{lstlisting}
+    su - # login als root
+    sh jdk-6u41-linux-x64-rpm.bin
+    <bestaetigen mit enter>
+    update-alternatives --install /usr/bin/java java /usr/java/jdk1.6.0_41/bin/java 5
+    update-alternatives --install /etc/alternatives/jre jre /usr/java/jdk1.6.0_41/jre 5
+    update-alternatives --config java
+ \end{lstlisting}
+
+\subsubsection Python und GDAL\\
+Installieren Sie nun die restlichen benötigten Pakete.
+Dazu installieren Sie zuerst einige Abhängigkeiten und anschließend die
+von der Intevation GmbH bereitgestellten speziellen Versionen von proj und libgeos
+
+Um die Abhängigkeiten zu installieren führen Sie bitte folgende Befehle aus:
+
+ \begin{lstlisting}
+     zypper ar http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/ "intevation:bfg"
+     rpm --import http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/repodata/repomd.xml.key
+     zypper ref # Paketlist neu laden
+     zypper in python libgeos0 libproj0 proj netcdf libnetcdf4 \
+        xerces-c libxerces-c-3_0 unixODBC postgresql-libs
+     zypper mr -d "intevation:bfg"
+     zypper ref # Paketliste neu laden
+ \end{lstlisting}
+
+%\subsubsection Oracle Instantclient\\
+%Der Oracle Instantclient 11.2.0.2.0 wird benötigt, damit der Importer mittels Python
+%und GDAL in die bestehende Oracle Datenbqlnk schreiben kann. Wenn Sie
+%eine PosgreSQL Datenbank verwenden, können Sie diesen Schritt überspringen.
+%
+%Zur Anbindung von Oracle ist es erforderlich, folgende Archive von
+%Oracle herunterzuladen (Sie benötigen dafür ein Oracle Benutzerkonto):
+%
+%Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python
+%und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es
+%erforderlich, folgende Archive von Oracle herunterzuladen. 
+%
+% \begin{itemize}
+%    \item instantclient-basic-linux-x86-64-11.2.0.2.0.zip
+%    \item instantclient-sdk-linux-x86-64-11.2.0.2.0.zip
+%    \item instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip
+% \end{itemize}
+%
+%Zu finden sind die
+% Pakete unter:\\
+%\href{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
+%{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
+%
+%
+%Um diese Pakete zu installieren, öffnen Sie eine Konsole und wechseln
+%in das Verzeichnis in welches Sie die heruntergeladenen Pakete
+%gespeichert haben. (z.B.: cd /home/benutzername/Downloads )
+% Anschließend führen Sie folgende Befehle auf der Kommandozeile aus:
+%
+% \begin{lstlisting}
+%     unzip instantclient-basic-linux-x86-64-11.2.0.2.0.zip -d /opt
+%     unzip instantclient-sdk-linux-x86-64-11.2.0.2.0.zip -d /opt
+%     unzip instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip -d /opt
+%
+%     mkdir /opt/instantclient_11_2/lib
+%     cd /opt/instantclient_11_2/lib
+%     ln -s ../libclntsh.so.11.1 .
+%     ln -s ../libclntsh.so.11.1 libclntsh.so
+%     ln -s ../libnnz11.so .
+%     ln -s ../libocci.so.11.1 .
+%     ln -s ../libocci.so.11.1 libocci.so
+%     ln -s ../libociei.so .
+%     ln -s ../libocijdbc11.so .
+%     ln -s ../libsqlplusic.so .
+%     ln -s ../libsqlplus.so .
+%
+%     echo "/opt/instantclient_11_2/lib/" > /etc/ld.so.conf.d/oci.conf 
+%     ldconfig
+% \end{lstlisting}
+%
+%Sollten keine Fehler aufgetreten sein, haben Sie den \textit{Oracle
+% Instantclient 11.2} erfolgreich entpackt und im Dateisystem unter
+% \textit{/opt/instantclient\_11\_2} abgelegt.
+%
+\subsubsection{Vorbereiten der Datenbank}
 Bevor die Importer verwendet werden können, ist es notwendig, dass eine leere
 Oracle Datenbank vorhanden ist. Anschließend müssen folgende SQL Skripte in
 diese Datenbank eingespielt werden:
@@ -81,24 +177,27 @@
 Mittels diesem SQL Skript werden die Indizes zum geodätischen Datenbankschema\\
 hinzugefügt.
 
-\item import-dems.sql \\
-In diesem Skript sind Befehle zum Einfügen der digitalen Geländemodelle
-enthalten. Die Dateipfade in diesem Skript sind so anzupassen, dass sie auf die
-entsprechenden Geländemodelle im Dateisystem verweisen. Es ist notwendig die
-Pfade absolut anzugeben.
-
 \end{enumerate}
 
 Zum Einspielen dieser Schemata setzen Sie folgende Befehle auf der Kommandozeile
 ab. Beachten Sie, dass $sqlplus$ im Pfad liegen muss, und der Linux-Nutzer
 dies Kommando ausführen können muss. Außerdem sind $benutzername$ und $passwort$
 entsprechend Ihres Datenbank-Zugangs anzupassen.
+SQLPlus befindet sich in /opt/instantclient\_11\_2 um es verfügbar zu machen
+führen Sie im Importer Verzeichnis folgende Befehle aus:
+
+\begin{lstlisting}
+export LD_LIBRARY_PATH=opt/instantclient\_11\_2/lib:$LD_LIBRARY_PATH
+export PATH=opt/instantclient\_11\_2:$PATH
+\end{lstlisting}
+
+Nun erstellen Sie das Schema:
 
 \begin{lstlisting}
     sqlplus benutzername/passwort @schema/oracle.sql
     sqlplus benutzername/passwort @schema/oracle-minfo.sql
     sqlplus benutzername/passwort @schema/oracle-spatial.sql
     sqlplus benutzername/passwort @schema/oracle-spatial_idx.sql
-    sqlplus benutzername/passwort @schema/import-dems.sql
 \end{lstlisting}
 
+

http://dive4elements.wald.intevation.org