# HG changeset patch # User Andre Heinecke # Date 1361381217 -3600 # 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 + + 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} +