You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Unter Windows muss der Pfad im Dialog "Systemsteuerung/System/Erweitert/Umgebungsvariablen"
35
-
angepasst werden. Der Wert der Variablen **PFAD** muss um den Text `;/pfad_zu_java/bin` ergänzt
35
+
angepasst werden. Der Wert der Variablen **PATH** muss um den Text `;/pfad_zu_java/bin` ergänzt
36
36
werden.
37
37
38
38
#### Erstinstalltion
@@ -80,7 +80,14 @@ Folgende Konfigurationsbereiche müssen im Datenverteiler, mit dem sich die SWE
80
80
Die SWE benötigt zum Betrieb folgende Parameter:
81
81
* ''atg.archiv'' an einem Objekt vom Typ ''typ.archiv''
82
82
83
-
Über die Parametrierung der ''atg.archiv'' wird festgelegt, auf welche Datenidentifikationen sich die SWE anmeldet. Die Empfangenen Daten werden dann transformiert und via REST API an einen REST Server versandt (vgl. [Archivparameterierung](https://gitlab.nerz-ev.de/ERZ/SPEZ_de.bsvrz.ars/blob/master/06-BetrInf/BetrInf_ArS_FREI_V15.0_D2018-02-14.pdf)).
83
+
Über diese Parameterattributgruppe wird dem Archivsystem mitgeteilt, welche Datenidentifikationen (d.h. Tripel aus Objekt, Attributgruppe und Aspekt) zu einem REST Server übertragen werden sollen. Die Einstellungen für Sichern, Nachfordern und dem Vorhaltezeitraum haben keine Wirkung.
84
+
85
+
Über die Parametrierung der ''atg.archiv'' wird festgelegt, auf welche Datenidentifikationen sich die SWE anmeldet. Die Empfangenen Daten werden dann transformiert und via REST API an einen REST Server versandt.
Im dargestellten Beispiel werden die Daten der Attributgruppen `atg.anzeigeEigenschaftIst`, `atg.verkehrsDatenKurzZeitFs`, `atg.verkehrsDatenKurzZeitIntervall`, `atg.verkehrsDatenKurzZeitMq`, `atg.tlsUfdErgebnisMeldungHelligkeitHK`, `atg.gmaUmfelddaten` und `atg.anzeigeQuerschnittEigenschaftIst` versandt.
90
+
84
91
85
92
### Aufnahme des Betriebs
86
93
@@ -91,3 +98,189 @@ Die SWE verwendet die Datenverteiler - Applikationsfunktionen zur Kommunikation
91
98
*`-url=http://localhost` : Die URL des REST Servers, der Standardwert ist `http://localhost`.
92
99
*`-port=80` : Der Port des REST Servers, der Standardwert ist `9998`.
93
100
101
+
#### Unterstützte Datenspezifikationen
102
+
103
+
Folgende Datenspezifikationen werden durch den Client Unterstützt:
Wird die SWE so parametriert, dass nicht unterstützte Datenspezifikationen konvertiert und versendet werden sollen, dann gibt es entsprechende Fehlermeldungen im Logfile, die SWE arbeitet jedoch weiter.
137
+
138
+
139
+
## Diagnosehandbuch
140
+
### Benötigte Werkzeuge
141
+
142
+
Folgende Werkzeuge werden für eine Diagnose benötigt:
143
+
144
+
* Generischer Testmonitor (GTM) für die Überprüfung der Parametrierung
145
+
* Texteditor/Textviewer für die Analyse der Logdateien
146
+
147
+
### Allgemeine Meldungen (Startmeldungen)
148
+
149
+
Folgende Ausgaben werden im Regelfall beim Start der SWE ausgegeben (Auszug aus dem Debug-Log) und stellen einen korrekten Start und Betrieb dar (die Ausgaben der konkret eingestellten Parameter sowie insbesondere die Werte am Ende des Auszugs weichen im konkreten System ggf. hiervon ab!).
INFO : Client.de.bitctrl.dav.rest.client.Dav2RestSender
194
+
Folgende Objekt-Converter wurden via Reflection gefunden: [class de.bitctrl.dav.rest.client.converter.AnzeigeJsonConverter, class de.bitctrl.dav.rest.client.converter.GlaetteMeldeAnlageJsonConverter, class de.bitctrl.dav.rest.client.converter.AnzeigeQuerschnittJsonConverter, class de.bitctrl.dav.rest.client.converter.FahrstreifenJsonConverter, class de.bitctrl.dav.rest.client.converter.SystemObjectJsonConverter, class de.bitctrl.dav.rest.client.converter.MessQuerschnittJsonConverter]
INFO : Client.de.bitctrl.dav.rest.client.Dav2RestSender
206
+
An- und Abmeldung für Archivdatensaetze abgeschlossen - 1029 ms
207
+
208
+
```
209
+
210
+
Mit Erreichen der Meldung `Anmeldung am Datenverteiler abgeschlossen, jetzt gehts los...` ist die SWE betriebsbereit.
211
+
212
+
### Allgemeine Meldungen (Info/ Konfig)
213
+
214
+
Die Meldungen im Debug-Level INFO/KONFIG erlauben die Überprüfung der korrekten Funktion der SWE zur Laufzeit.
215
+
Einträge, die im Logfile als „INFO“ gekennzeichnet sind, dienen zur Information und können dem Anwender Aufschluss über die aktuellen Aktivitäten der SWE geben.
216
+
217
+
### Warnmeldungen (WARNING)
218
+
219
+
Log-Einträge mit dem Level WARNING behindern zwar den Betrieb, verhindern ihn jedoch nicht. Es stehen jedoch nicht alle Funktionen der SWE zur Verfügung. Die Ursache einer Warnung sollte behoben werden, damit die SWE voll funktionstüchtig ist.
220
+
221
+
222
+
<tableborder="1">
223
+
<tr>
224
+
<th scope="col">Meldung</th>
225
+
<th scope="col">Beschreibung</th>
226
+
</tr>
227
+
<tr>
228
+
<td><code>Der Heap ist zu mehr als 90% belegt, es werden X Elemente aus der Warteschlange entfernt.</code></td>
229
+
<td>Der von der SWE verwendete Speicher ist fast vollständig belegt. Damit die SWE nicht durch einen OutOfMemory Error beendet wird, werden 10% der Daten gelöscht, die bisher trotz mehrmaligem Versuch nicht versendet werden konnten.</td>
230
+
</tr>
231
+
</table>
232
+
233
+
### Fehlermeldungen (ERROR)
234
+
235
+
Log-Einträge mit dem Level ERROR verhindern den korrekten Betrieb. Die Funktionen der SWE stehen nicht oder nur eingeschränkt zur Verfügung. Die Ursache eines Fehlers muss umgehend behoben werden, damit die SWE funktionstüchtig ist und die wichtigsten Funktionen erfüllt werden.
236
+
Einträge, die im Logfile als „FEHLER“ gekennzeichnet sind, bedürfen somit einer dringenden Analyse/Beseitigung. Ein Fehler der Kategorie „FEHLER“ bedeutet jedoch nicht automatisch, dass die SWE keine Daten mehr versendet. In der Regel können solche Fehler nicht vom Operator beseitigt werden.
237
+
238
+
239
+
<tableborder="1">
240
+
<tr>
241
+
<th scope="col">Meldung</th>
242
+
<th scope="col">Beschreibung</th>
243
+
</tr>
244
+
<tr>
245
+
<td><code>Instanziierung der Klasse X fehlgeschlagen.</code></td>
246
+
<td>Ein Objekt der Konverter-Klasse X (ERZ Datenformat nach JSON) konnte nicht instanziiert werden. Es gibt eine Vielzahl möglicher Fehlerursachen. Es könnten z.B. Bibliotheken im Klassenpfad fehlen.Nachfolgend wird der Text der Excpetion mit weiteren Informationen angezeigt.</td>
247
+
</tr>
248
+
<td><code>DAV Objekte konnten nicht versendet werden.</code></td>
249
+
<td>Es liegt ein allgemeines Kommunikationsproblem zum REST Server vor.</td>
250
+
</tr>
251
+
<tr>
252
+
<td><code>Objekttyp-X konnten nicht versendet werden.</code></td>
253
+
<td>Die statischen Informationen zu Objekten konnten nicht an den REST Server versandt werden. Jedoch ist eine prinzipielle Kommunikation möglich. REST Client und/oder Server sind nicht vollständig implementiert oder verwenden verschiedene Protokollversionen (RAML Schnittstellenbeschreibung). Nachfolgend wird der Text der Excpetion mit weiteren Informationen angezeigt.</td>
254
+
</tr>
255
+
<tr>
256
+
<td><code>OnlineDaten konnten nicht für den Versand vorbereitet werden, es erfolgt kein Nachversand.</code></td>
257
+
<td>Die Konvertierung der ERZ Daten in JSON Objekte ist fehlgeschlagen. Nachfolgend wird der Text der Excpetion mit weiteren Informationen angezeigt.</td>
258
+
</tr>
259
+
<tr>
260
+
<td><code>Instanziierung und Konvertierung der Klasse X fehlgeschlagen (ResultData: resultData ).</code></td>
261
+
<td>Ein Objekt der Konverter-Klasse X (ERZ Datenformat nach JSON) konnte nicht instanziiert werden. Es gibt eine Vielzahl möglicher Fehlerursachen. Es könnten z.B. Bibliotheken im Klassenpfad fehlen. Nachfolgend wird der Text der Excpetion mit weiteren Informationen angezeigt.</td>
262
+
</tr>
263
+
<tr>
264
+
<td><code>Ermittlung des freien Heaps und das Verkürzen der Warteschlage ist fehlgeschlagen.</code></td>
265
+
<td>Die Überwachung des freien Heap Speichers wurde mit einem Fehler abgebrochen.</td>
266
+
</tr>
267
+
<tr>
268
+
<td><code>OnlineDaten konnten nicht (nach)versendet werden.</code></td>
269
+
<td>Allgemeines Problem beim Nachversandt der Onlinedaten. Es besteht ein allgemeines Kommunikationsproblem zum REST Server.</td>
270
+
</tr>
271
+
<tr>
272
+
<td><code>Archiv kann Datensatz nicht der Warteschlange hinzufügen.</code></td>
273
+
<td>Vom ERZ Datenverteiler empfange Daten können nicht für eine Weiterverarbeitung zwischengespeichert werden. Nachfolgend wird der Text der Excpetion mit weiteren Informationen angezeigt.</td>
274
+
</tr>
275
+
<tr>
276
+
<td><code>Der Versand von Datenart-X ist fehlgeschlagen und wird per Nachversand erneut versucht.</code></td>
277
+
<td>Für ein bestimmtes Onlinedatum (dynamische Daten) ist der Versand zum REST Server fehlgeschlagen. Es wird versucht die Informationen später erneut zu versenden. Nachfolgend wird die HTTP Response des REST Servers angezeigt.</td>
278
+
</tr>
279
+
<tr>
280
+
<td><code>Fehler beim Versand von Datenart-X es wird per Nachversand erneut versucht.</code></td>
281
+
<td>Für ein bestimmtes Onlinedatum (dynamische Daten) ist der Versand zum REST Server fehlgeschlagen. Es wird versucht die Informationen später erneut zu versenden. Nachfolgend wird der Text der Excpetion mit weiteren Informationen angezeigt.</td>
0 commit comments