Mercurial > dive4elements > river

comparison backend/doc/documentation/de/overview.tex @ 8825:3e212106455c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Remove obsolete details from importer docs.
author Tom Gottfried <tom@intevation.de>
date Tue, 16 May 2017 15:59:00 +0200
parents 73946c0007ff
children 4a13535ed949
comparison
equal deleted inserted replaced
8824:b5a868b50500 8825:3e212106455c
49 der Software selbst notwendig sind! 49 der Software selbst notwendig sind!
50 50
51 \subsection{Systemanforderungen} 51 \subsection{Systemanforderungen}
52 \label{Systemanforderungen} 52 \label{Systemanforderungen}
53 \begin{itemize} 53 \begin{itemize}
54 \item Oracle oder PosgreSQL Datenbank inkl. Schema für FLYS 54 \item Oracle- oder PosgreSQL-Datenbank bzw. entsprechende Client-Bibliotheken
55 \item SUSE Enterprise Linux 11.2 SP 1 55 inkl. Schema für FLYS
56 \item Java, Python, GDAL (mit GDAL-Python-API)
56 \end{itemize} 57 \end{itemize}
57 58
58 \subsection{Installationsanleitung} 59 \subsection{Installationsanleitung}
59 \label{Installationsanleitung} 60 \label{Installationsanleitung}
60 61
65 cd ~ 66 cd ~
66 tar xvfz flys-importer.tar.gz 67 tar xvfz flys-importer.tar.gz
67 cd flys-importer 68 cd flys-importer
68 \end{lstlisting} 69 \end{lstlisting}
69 70
70 \subsubsection{Java}
71 Der flys-importer benötigt Java Version 6. Um diese zu installieren laden Sie
72 bitte von
73 \url{http://www.oracle.com/technetwork/java/javase/downloads/index.html}
74 eine aktulle Java Version als -rpm.bin herunter. Zum Beispiel: jdk-6u41-linux-x64-rpm.bin
75 71
76 Nach dem Herunterladen, öffnen Sie eine konsole und wechseln in das Downloadverzeichnis. 72 \subsubsection{Vorbereiten einer Oracle-Datenbank}
77 Führen Sie nun folgende Befehle aus:
78
79 \begin{lstlisting}
80 su - # login als root
81 sh jdk-6u41-linux-x64-rpm.bin
82 <bestaetigen mit enter>
83 update-alternatives --install /usr/bin/java java /usr/java/jdk1.6.0_41/bin/java 5
84 update-alternatives --install /etc/alternatives/jre jre /usr/java/jdk1.6.0_41/jre 5
85 update-alternatives --config java
86 \end{lstlisting}
87
88 \subsubsection{Python und GDAL}
89 Installieren Sie nun die restlichen benötigten Pakete.
90 Installieren Sie zuerst einige Abhängigkeiten und anschließend die
91 von der Intevation GmbH bereitgestellten speziellen Versionen von proj und libgeos
92
93 Um die Abhängigkeiten zu installieren führen Sie bitte folgende Befehle aus:
94
95 \begin{lstlisting}
96 zypper ar http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/ "intevation:bfg"
97 rpm --import http://download.opensuse.org/repositories/home:/intevation:/bfg/SLE_11/repodata/repomd.xml.key
98 zypper ref # Paketliste neu laden
99 zypper in python libgeos0 libproj0 proj netcdf \
100 libnetcdf4 xerces-c libxerces-c-3_0 unixODBC \
101 postgresql-libs
102 zypper mr -d "intevation:bfg"
103 zypper ref # Paketliste neu laden
104 \end{lstlisting}
105
106 %\subsubsection Oracle Instantclient\\
107 %Der Oracle Instantclient 11.2.0.2.0 wird benötigt, damit der Importer mittels Python
108 %und GDAL in die bestehende Oracle Datenbqlnk schreiben kann. Wenn Sie
109 %eine PosgreSQL Datenbank verwenden, können Sie diesen Schritt überspringen.
110 %
111 %Zur Anbindung von Oracle ist es erforderlich, folgende Archive von
112 %Oracle herunterzuladen (Sie benötigen dafür ein Oracle Benutzerkonto):
113 %
114 %Der Oracle Instantclient 11.2 wird benötigt, damit der Importer mittels Python
115 %und GDAL in die bestehende Oracle Datenbank schreiben kann. Dazu ist es
116 %erforderlich, folgende Archive von Oracle herunterzuladen.
117 %
118 % \begin{itemize}
119 % \item instantclient-basic-linux-x86-64-11.2.0.2.0.zip
120 % \item instantclient-sdk-linux-x86-64-11.2.0.2.0.zip
121 % \item instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip
122 % \end{itemize}
123 %
124 %Zu finden sind die
125 % Pakete unter:\\
126 %\href{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
127 %{http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html}
128 %
129 %
130 %Um diese Pakete zu installieren, öffnen Sie eine Konsole und wechseln
131 %in das Verzeichnis in welches Sie die heruntergeladenen Pakete
132 %gespeichert haben. (z.B.: cd /home/benutzername/Downloads )
133 % Anschließend führen Sie folgende Befehle auf der Kommandozeile aus:
134 %
135 % \begin{lstlisting}
136 % unzip instantclient-basic-linux-x86-64-11.2.0.2.0.zip -d /opt
137 % unzip instantclient-sdk-linux-x86-64-11.2.0.2.0.zip -d /opt
138 % unzip instantclient-sqlplus-linux-x86-64-11.2.0.2.0.zip -d /opt
139 %
140 % mkdir /opt/instantclient_11_2/lib
141 % cd /opt/instantclient_11_2/lib
142 % ln -s ../libclntsh.so.11.1 .
143 % ln -s ../libclntsh.so.11.1 libclntsh.so
144 % ln -s ../libnnz11.so .
145 % ln -s ../libocci.so.11.1 .
146 % ln -s ../libocci.so.11.1 libocci.so
147 % ln -s ../libociei.so .
148 % ln -s ../libocijdbc11.so .
149 % ln -s ../libsqlplusic.so .
150 % ln -s ../libsqlplus.so .
151 %
152 % echo "/opt/instantclient_11_2/lib/" > /etc/ld.so.conf.d/oci.conf
153 % ldconfig
154 % \end{lstlisting}
155 %
156 %Sollten keine Fehler aufgetreten sein, haben Sie den \textit{Oracle
157 % Instantclient 11.2} erfolgreich entpackt und im Dateisystem unter
158 % \textit{/opt/instantclient\_11\_2} abgelegt.
159 %
160 \subsubsection{Vorbereiten der Datenbank}
161 Bevor die Importer verwendet werden können, ist es notwendig, dass eine leere 73 Bevor die Importer verwendet werden können, ist es notwendig, dass eine leere
162 Oracle Datenbank vorhanden ist. Anschließend müssen folgende SQL-Skripte in 74 Oracle Datenbank vorhanden ist. Anschließend müssen folgende SQL-Skripte in
163 diese Datenbank eingespielt werden: 75 diese Datenbank eingespielt werden:
164 76
165 \begin{enumerate} 77 \begin{enumerate}
183 95
184 Zum Einspielen dieser Schemata setzen Sie folgende Befehle auf der Kommandozeile 96 Zum Einspielen dieser Schemata setzen Sie folgende Befehle auf der Kommandozeile
185 ab. Beachten Sie, dass $sqlplus$ im Pfad liegen muss, und der Linux-Nutzer 97 ab. Beachten Sie, dass $sqlplus$ im Pfad liegen muss, und der Linux-Nutzer
186 dieses Kommando ausführen können muss. Außerdem sind $benutzername$ und $passwort$ 98 dieses Kommando ausführen können muss. Außerdem sind $benutzername$ und $passwort$
187 entsprechend Ihres Datenbank-Zugangs anzupassen. 99 entsprechend Ihres Datenbank-Zugangs anzupassen.
188 SQLPlus befindet sich in /opt/instantclient\_11\_2 um es verfügbar zu machen
189 führen Sie im Importer Verzeichnis folgende Befehle aus:
190 100
191 \begin{lstlisting} 101 Damit alle in den UTF8-codierten SQL-Skripten vorhandenen Zeichen (also z.B.\
192 export LD_LIBRARY_PATH=opt/instantclient_11_2/lib:$LD_LIBRARY_PATH
193 export PATH=opt/instantclient_11_2:$PATH
194 \end{lstlisting}
195
196 Damit alle in den UTF8-codierten SQL-Skripten vorhandenen Zeichen (also z.B.\
197 auch Umlaute) korrekt in die Datenbank eingelesen werden können, führen 102 auch Umlaute) korrekt in die Datenbank eingelesen werden können, führen
198 Sie folgenden Befehl aus: 103 Sie folgenden Befehl aus:
199 104
200 \begin{lstlisting} 105 \begin{lstlisting}
201 export NLS_LANG=.AL32UTF8 106 export NLS_LANG=.AL32UTF8
213 @schema/oracle-minfo.sql 118 @schema/oracle-minfo.sql
214 @schema/oracle-spatial.sql 119 @schema/oracle-spatial.sql
215 @schema/oracle-spatial_idx.sql 120 @schema/oracle-spatial_idx.sql
216 \end{lstlisting} 121 \end{lstlisting}
217 122
218 Hierbei ist 123 Hierbei ist
219 \begin{lstlisting} 124 \begin{lstlisting}
220 user/password@connect_identifier 125 user/password@connect_identifier
221 \end{lstlisting} 126 \end{lstlisting}
222 so etwas wie 127 so etwas wie
223 \begin{lstlisting} 128 \begin{lstlisting}
224 ICH/geheim@127.0.0.1:1234/DB.TEST.FIRMA.DE 129 ICH/geheim@127.0.0.1:1234/DB.TEST.FIRMA.DE
225 \end{lstlisting} 130 \end{lstlisting}
226 131
227 Um sqlplus zu verlassen verwenden Sie 132 Um sqlplus zu verlassen verwenden Sie
http://dive4elements.wald.intevation.org