[Dive4elements-commits] [PATCH 1 of 9] Simplify installation instruction and move it to overview as it
Wald Commits
scm-commit at wald.intevation.org
Wed Feb 20 18:31:14 CET 2013
# HG changeset patch
# User Andre Heinecke <aheinecke at intevation.de>
# Date 1361381217 -3600
# Branch dami
# Node ID a56efdfcab17df93acae72ece077bddf2c463670
# Parent fb7c4ad94bd801317a1e9e1a30c88e367f270ad2
Simplify installation instruction and move it to overview as it
applies for both importer
diff -r fb7c4ad94bd8 -r a56efdfcab17 flys-backend/doc/documentation/de/importer-geodaesie.tex
--- 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}
diff -r fb7c4ad94bd8 -r a56efdfcab17 flys-backend/doc/documentation/de/importer-hydr-morph.tex
--- 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
diff -r fb7c4ad94bd8 -r a56efdfcab17 flys-backend/doc/documentation/de/importer-manual.tex
--- 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}
%----------------------------------------------
diff -r fb7c4ad94bd8 -r a56efdfcab17 flys-backend/doc/documentation/de/overview.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}
+
More information about the Dive4elements-commits
mailing list