changeset 3669:25b5af0cdf89

Describe Log4J configuration in importer documentation. flys-backend/trunk@5275 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Ingo Weinzierl <ingo.weinzierl@intevation.de>
date Mon, 27 Aug 2012 13:06:44 +0000
parents 2a3bc47d1ba9
children 6c0d6d74139c
files flys-backend/ChangeLog flys-backend/doc/documentation/de/importer-hydr-morph.tex
diffstat 2 files changed, 38 insertions(+), 23 deletions(-) [+]
line wrap: on
line diff
--- a/flys-backend/ChangeLog	Mon Aug 27 12:39:57 2012 +0000
+++ b/flys-backend/ChangeLog	Mon Aug 27 13:06:44 2012 +0000
@@ -1,3 +1,8 @@
+2012-08-27  Ingo Weinzierl <ingo@intevation.de>
+
+	* doc/documentation/de/importer-hydr-morph.tex: Describe Log4J
+	  configuration; some smaller bugfixes.
+
 2012-08-27  Ingo Weinzierl <ingo@intevation.de>
 
 	* doc/documentation/de/overview.tex: Added comment to directory structure
--- a/flys-backend/doc/documentation/de/importer-hydr-morph.tex	Mon Aug 27 12:39:57 2012 +0000
+++ b/flys-backend/doc/documentation/de/importer-hydr-morph.tex	Mon Aug 27 13:06:44 2012 +0000
@@ -227,7 +227,6 @@
 
 \subsection{Konfiguration}
 \label{configuration}
-\todo LOG4J
 Zum Starten des Importers ist es notwendig, in der Datei \textit{run.sh} die
 Variablen am Anfang der Datei anzupassen. Im folgenden werden notwendige und
 optionale Einstellungen beschrieben, die beim Starten des Importers
@@ -261,10 +260,6 @@
 \\Der Name der Datenbank Instanz. Beispielsweise \textit{XE} bei einer Oracle XE
 Instanz.
 
-
-Für die Verbindung zur Datenbank ist es nötig, dem Import die Verbindungsdaten
-zu übergeben. Dies geschieht ebenfalls über System-Properties:
-
 \textbf{BACKEND\_DB\_PREFIX}
 \\Der Präfix zum Aufbau einer Datenbankverbindung. Für Oracle z.B.: \textit{jdbc:oracle:thin:@}.
 
@@ -278,7 +273,22 @@
 
 
 Weitere Details zum Verbinden zu einer Oracle Datenbank finden Sie unter
-\href{http://www.orafaq.com/wiki/JDBC}.
+\href{http://www.orafaq.com/wiki/JDBC}. Alle weiteren Einstellungen sind
+optional anpassbar:
+
+\textbf{LOG4J\_CONFIG}
+\\Der Fachdatenimport verwendet eine externe Bibliothek Apache Log4J zum Loggen
+von Informationen. Dazu ist es notwendig eine entsprechende Konfiguration beim
+Start anzugeben. \textit{LOG4J\_CONFIG} verweist in diesem Fall auf eine externe
+Datei zur Konfiguration von Log4J. Im Standardfall wird die Datei
+\textit{conf/log4j.properties} verwendet, welche eine sinnvolle Konfiguration
+enthält. Sollten Sie diese Konfiguration verwenden, wird beim Import eine
+Log-Datei namens \textit{import.log} erstellt, die maximal 100 MB groß werden
+kann. Sollte die Log-Datei größer als 100 MB anwachsen, wird die aktuelle Datei
+nach \textit{import.log.1} umbenannt und eine neue Datei \textit{import.log}
+wird begonnen. Maximal werden 10 Log-Dateien gespeichert. Für weitere Details
+zu Log4J siehe Online Dokumentation unter
+\href{http://logging.apache.org/log4j/1.2/}{http://logging.apache.org/log4j/1.2/}
 
 
 \textbf{IMPORTER\_MAINVALUE\_TYPES}
@@ -499,7 +509,7 @@
 \textbf{skip invalid gauge part: \#}
 \\Invalide Datenzeile in einer Datei Fließgeschwindigkeitsmodellen.
 
-\textbf{Error while parsing Q value: <Q>}
+\textbf{Error while parsing Q value: $<Q>$}
 \\Invalide Datenzeile in einer Datei Fließgeschwindigkeitsmodellen.
 
 \textbf{skip invalid data line: \#}
@@ -553,21 +563,21 @@
 \textbf{STA: value not parseable in line \#}
 \\Wert ist nicht als Zahl zu interpretieren.
 
-\textbf{PRF: cannot open file <FILE>}
+\textbf{PRF: cannot open file $<FILE>$}
 \\Die PRF kann nicht geöffnet werden.
 
-\textbf{PRF: file is empty}
-\textbf{PRF: First line does not look like a PRF data pattern.}
-\textbf{PRF: premature EOF. Expected integer in line 2}
-\textbf{PRF: Expected <num> in line 2}
-\textbf{PRF: invalid integer in line 2}
-\textbf{PRF: premature EOF. Expected pattern for km extraction}
-\textbf{PRF: line 4 does not look like a PRF km extraction pattern.}
-\textbf{PRF: premature EOF. Expected skip row count.}
-\textbf{PRF: line 5 is not an positive integer.}
+\textbf{PRF: file is empty}\\
+\textbf{PRF: First line does not look like a PRF data pattern.}\\
+\textbf{PRF: premature EOF. Expected integer in line 2}\\
+\textbf{PRF: Expected $<num>$ in line 2}\\
+\textbf{PRF: invalid integer in line 2}\\
+\textbf{PRF: premature EOF. Expected pattern for km extraction}\\
+\textbf{PRF: line 4 does not look like a PRF km extraction pattern.}\\
+\textbf{PRF: premature EOF. Expected skip row count.}\\
+\textbf{PRF: line 5 is not an positive integer.}\\
 \textbf{PRF: cannot extract km in line \#}
-\\Das PRF-Format ist komplex. Hier sollten weitere Information zur genaueren
-Analyse herangezogen werden.
+\\Das PRF-Format ist komplex. Bei oben genannten Fehlern sollten weitere
+Information zur genaueren Analyse herangezogen werden.
 
 \textbf{cannot access WST file <FILE>}
 \\Die WST-Datei konnte nicht gefunden werden.
@@ -659,16 +669,16 @@
 \textbf{SYP: Error while parsing numbers in \#}
 \\Ungültige Zahlenformatierung.
 
-\textbf{SYP: Unknown time interval string <XYZ>}
+\textbf{SYP: Unknown time interval string 'XYZ'}
 \\Falsches Datumformat.
 
-\textbf{SYP: Error while parsing years <XYZ>}
+\textbf{SYP: Error while parsing years 'XYZ'}
 \\Falsches Jahreszahlformat.
 
-\textbf{SYP: Error while parsing ranges of <XYZ>}
+\textbf{SYP: Error while parsing ranges of 'XYZ'}
 \\Bereichsangaben fehlerhaft.
 
-\textbf{SYP: Unknown grain fraction <XYZ>}
+\textbf{SYP: Unknown grain fraction 'XYZ'}
 \\Unbekannte Kornfraktion.
 
 \textbf{WST: invalid number.}

http://dive4elements.wald.intevation.org