comparison flys-backend/doc/documentation/de/overview.tex @ 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 16498764fca5
children 0454c7dddb37
comparison
equal deleted inserted replaced
5064:fb7c4ad94bd8 5065:a56efdfcab17
46 \end{itemize} 46 \end{itemize}
47 47
48 Bitte beachten Sie, dass diese Werkzeuge nicht zur Installtion und zum Betrieb 48 Bitte beachten Sie, dass diese Werkzeuge nicht zur Installtion und zum Betrieb
49 der Software selbst notwendig sind! 49 der Software selbst notwendig sind!
50 50
51 51 \subsection{Systemanforderungen}
52 \subsubsection{Vorbereiten der Datenbank} 52 \label{Systemanforderungen}
53 \begin{itemize}
54 \item Oracle oder PosgreSQL Datenbank inkl. Schema für FLYS
55 \item SUSE Enterprise Linux 11.2 SP 1
56 \end{itemize}
57
58 \subsection{Installationsanleitung}
59 \label{Installationsanleitung}
53 60
54 Nachdem Sie das Paket nun in das Heimatverzeichnis des Nutzers auf das 61 Nachdem Sie das Paket nun in das Heimatverzeichnis des Nutzers auf das
55 Zielsystem kopiert haben, entpacken Sie es mit folgenden Befehlen: 62 Zielsystem kopiert haben, entpacken Sie es mit folgenden Befehlen:
56 63
57 \begin{lstlisting} 64 \begin{lstlisting}
58 cd ~ 65 cd ~
59 tar xvfz flys-importer.tar.gz 66 tar xvfz flys-importer.tar.gz
60 cd flys-importer 67 cd flys-importer
61 \end{lstlisting} 68 \end{lstlisting}
62 69
70 \subsubsection Java
71 Der flys-importer benötigt Java Version 6 um diese zu installieren laden Sie
72 bitte von \url{http://www.oracle.com/technetwork/java/javase/downloads/jdk6downloads-1902814.html}
73 eine aktulle Java Version als -rpm.bin herunter. Zum Beispiel: jdk-6u41-linux-x64-rpm.bin
74
75 Nach dem Herunterladen, öffnen Sie eine konsole und wechseln in das Downloadverzeichnis.
76 Führen Sie nun folgende Befehle aus:
77
78 \begin{lstlisting}
79 su - # login als root
80 sh jdk-6u41-linux-x64-rpm.bin
81 <bestaetigen mit enter>
82 update-alternatives --install /usr/bin/java java /usr/java/jdk1.6.0_41/bin/java 5
83 update-alternatives --install /etc/alternatives/jre jre /usr/java/jdk1.6.0_41/jre 5
84 update-alternatives --config java
85 \end{lstlisting}
86
87 \subsubsection Python und GDAL\\
88 Installieren Sie nun die restlichen benötigten Pakete.
89 Dazu installieren Sie zuerst einige Abhängigkeiten und anschließend die
90 von der Intevation GmbH bereitgestellten speziellen Versionen von proj und libgeos
91
92 Um die Abhängigkeiten zu installieren führen Sie bitte folgende Befehle aus:
93
94 \begin{lstlisting}
95 zypper ar http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/ "intevation:bfg"
96 rpm --import http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/repodata/repomd.xml.key
97 zypper ref # Paketlist neu laden
98 zypper in python libgeos0 libproj0 proj netcdf libnetcdf4 \
99 xerces-c libxerces-c-3_0 unixODBC postgresql-libs
100 zypper mr -d "intevation:bfg"
101 zypper ref # Paketliste neu laden
102 \end{lstlisting}
103
104 %\subsubsection Oracle Instantclient\\
105 %Der Oracle Instantclient 11.2.0.2.0 wird benötigt, damit der Importer mittels Python
106 %und GDAL in die bestehende Oracle Datenbqlnk schreiben kann. Wenn Sie
107 %eine PosgreSQL Datenbank verwenden, können Sie diesen Schritt überspringen.
108 %
109 %Zur Anbindung von Oracle ist es erforderlich, folgende Archive von
110 %Oracle herunterzuladen (Sie benötigen dafür ein Oracle Benutzerkonto):
111 %
112 %Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python
113 %und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es
114 %erforderlich, folgende Archive von Oracle herunterzuladen.
115 %
116 % \begin{itemize}
117 % \item instantclient-basic-linux-x86-64-11.2.0.2.0.zip
118 % \item instantclient-sdk-linux-x86-64-11.2.0.2.0.zip
119 % \item instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip
120 % \end{itemize}
121 %
122 %Zu finden sind die
123 % Pakete unter:\\
124 %\href{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
125 %{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
126 %
127 %
128 %Um diese Pakete zu installieren, öffnen Sie eine Konsole und wechseln
129 %in das Verzeichnis in welches Sie die heruntergeladenen Pakete
130 %gespeichert haben. (z.B.: cd /home/benutzername/Downloads )
131 % Anschließend führen Sie folgende Befehle auf der Kommandozeile aus:
132 %
133 % \begin{lstlisting}
134 % unzip instantclient-basic-linux-x86-64-11.2.0.2.0.zip -d /opt
135 % unzip instantclient-sdk-linux-x86-64-11.2.0.2.0.zip -d /opt
136 % unzip instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip -d /opt
137 %
138 % mkdir /opt/instantclient_11_2/lib
139 % cd /opt/instantclient_11_2/lib
140 % ln -s ../libclntsh.so.11.1 .
141 % ln -s ../libclntsh.so.11.1 libclntsh.so
142 % ln -s ../libnnz11.so .
143 % ln -s ../libocci.so.11.1 .
144 % ln -s ../libocci.so.11.1 libocci.so
145 % ln -s ../libociei.so .
146 % ln -s ../libocijdbc11.so .
147 % ln -s ../libsqlplusic.so .
148 % ln -s ../libsqlplus.so .
149 %
150 % echo "/opt/instantclient_11_2/lib/" > /etc/ld.so.conf.d/oci.conf
151 % ldconfig
152 % \end{lstlisting}
153 %
154 %Sollten keine Fehler aufgetreten sein, haben Sie den \textit{Oracle
155 % Instantclient 11.2} erfolgreich entpackt und im Dateisystem unter
156 % \textit{/opt/instantclient\_11\_2} abgelegt.
157 %
158 \subsubsection{Vorbereiten der Datenbank}
63 Bevor die Importer verwendet werden können, ist es notwendig, dass eine leere 159 Bevor die Importer verwendet werden können, ist es notwendig, dass eine leere
64 Oracle Datenbank vorhanden ist. Anschließend müssen folgende SQL Skripte in 160 Oracle Datenbank vorhanden ist. Anschließend müssen folgende SQL Skripte in
65 diese Datenbank eingespielt werden: 161 diese Datenbank eingespielt werden:
66 162
67 \begin{enumerate} 163 \begin{enumerate}
79 175
80 \item oracle-spatial\_idx.sql \\ 176 \item oracle-spatial\_idx.sql \\
81 Mittels diesem SQL Skript werden die Indizes zum geodätischen Datenbankschema\\ 177 Mittels diesem SQL Skript werden die Indizes zum geodätischen Datenbankschema\\
82 hinzugefügt. 178 hinzugefügt.
83 179
84 \item import-dems.sql \\
85 In diesem Skript sind Befehle zum Einfügen der digitalen Geländemodelle
86 enthalten. Die Dateipfade in diesem Skript sind so anzupassen, dass sie auf die
87 entsprechenden Geländemodelle im Dateisystem verweisen. Es ist notwendig die
88 Pfade absolut anzugeben.
89
90 \end{enumerate} 180 \end{enumerate}
91 181
92 Zum Einspielen dieser Schemata setzen Sie folgende Befehle auf der Kommandozeile 182 Zum Einspielen dieser Schemata setzen Sie folgende Befehle auf der Kommandozeile
93 ab. Beachten Sie, dass $sqlplus$ im Pfad liegen muss, und der Linux-Nutzer 183 ab. Beachten Sie, dass $sqlplus$ im Pfad liegen muss, und der Linux-Nutzer
94 dies Kommando ausführen können muss. Außerdem sind $benutzername$ und $passwort$ 184 dies Kommando ausführen können muss. Außerdem sind $benutzername$ und $passwort$
95 entsprechend Ihres Datenbank-Zugangs anzupassen. 185 entsprechend Ihres Datenbank-Zugangs anzupassen.
186 SQLPlus befindet sich in /opt/instantclient\_11\_2 um es verfügbar zu machen
187 führen Sie im Importer Verzeichnis folgende Befehle aus:
188
189 \begin{lstlisting}
190 export LD_LIBRARY_PATH=opt/instantclient\_11\_2/lib:$LD_LIBRARY_PATH
191 export PATH=opt/instantclient\_11\_2:$PATH
192 \end{lstlisting}
193
194 Nun erstellen Sie das Schema:
96 195
97 \begin{lstlisting} 196 \begin{lstlisting}
98 sqlplus benutzername/passwort @schema/oracle.sql 197 sqlplus benutzername/passwort @schema/oracle.sql
99 sqlplus benutzername/passwort @schema/oracle-minfo.sql 198 sqlplus benutzername/passwort @schema/oracle-minfo.sql
100 sqlplus benutzername/passwort @schema/oracle-spatial.sql 199 sqlplus benutzername/passwort @schema/oracle-spatial.sql
101 sqlplus benutzername/passwort @schema/oracle-spatial_idx.sql 200 sqlplus benutzername/passwort @schema/oracle-spatial_idx.sql
102 sqlplus benutzername/passwort @schema/import-dems.sql
103 \end{lstlisting} 201 \end{lstlisting}
104 202
203

http://dive4elements.wald.intevation.org