15.01.2015 Aufrufe

Betriebsinformationen SWE BASt-Band - NERZ eV

Betriebsinformationen SWE BASt-Band - NERZ eV

Betriebsinformationen SWE BASt-Band - NERZ eV

MEHR ANZEIGEN
WENIGER ANZEIGEN

Erfolgreiche ePaper selbst erstellen

Machen Sie aus Ihren PDF Publikationen ein blätterbares Flipbook mit unserer einzigartigen Google optimierten e-Paper Software.

Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 1 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Betriebshandbuch<br />

Anwendungshandbuch<br />

Diagnosehandbuch<br />

Version 5.0<br />

Stand 11.02.2013<br />

Produktzustand<br />

Datei<br />

akzeptiert<br />

BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-<br />

11.doc<br />

Projektkoordinator<br />

Projektleiter<br />

Projektträger<br />

Herr Issleb<br />

Herr Franz<br />

Niedersächsische Landesbehörde für Straßenbau und<br />

Verkehr<br />

Göttinger Chaussee 76 A<br />

30453 Hannover<br />

Ansprechpartner<br />

Herr Franz<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 2 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

0 Allgemeines<br />

0.1 Verteiler<br />

Organisationseinheit Name Anzahl<br />

Kopien<br />

Vermerk<br />

PG NI-DAUZ<br />

Herr Franz<br />

Herr Issleb<br />

Herr Schmädecke<br />

inovat<br />

Herr Kniß<br />

0.2 Änderungsübersicht<br />

Version Datum Kapitel Bemerkungen Bearbeiter<br />

1.0 01.09.2010 alle Erstellung erster Entwurf D. Rostek (inovat)<br />

06.10.2010 alle Überarbeitung D. Rostek (inovat)<br />

14.10.2011 alle Überarbeitung H. C. Kniß (inovat)<br />

2.0 05.11.2011 alle Schlussredaktion C. Franz, (NLStBV)<br />

H. C. Kniß (inovat)<br />

3.1 07.08.2012 alle Umstellung auf eine <strong>SWE</strong> ohne<br />

Abhängigkeiten zu Logos-<br />

Bibliotheken<br />

L. Givorgizova (inovat)<br />

4.0 22.10.2012 alle Schlussredaktion H. C. Kniß (inovat)<br />

5.0 11.02.2013<br />

Anpassung Namenskonvention<br />

<strong>NERZ</strong><br />

H. C. Kniß (inovat)<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 3 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

0.3 Inhaltsverzeichnis<br />

0 Allgemeines ................................................................................................................................... 2<br />

0.1 Verteiler .............................................................................................................................. 2<br />

0.2 Änderungsübersicht ........................................................................................................... 2<br />

0.3 Inhaltsverzeichnis............................................................................................................... 3<br />

0.4 Abkürzungsverzeichnis ...................................................................................................... 5<br />

0.5 Definitionen ........................................................................................................................ 5<br />

0.6 Referenzierte Dokumente .................................................................................................. 5<br />

0.7 Abbildungsverzeichnis ....................................................................................................... 5<br />

0.8 Tabellenverzeichnis ........................................................................................................... 5<br />

1 Zweck des Dokuments .................................................................................................................. 6<br />

2 Betriebshandbuch ......................................................................................................................... 7<br />

2.1 Installation der Software .................................................................................................... 7<br />

2.1.1 Erstinstallation ...................................................................................................... 7<br />

2.1.1.1 Voraussetzungen ................................................................................... 7<br />

2.1.1.2 Durchführung ......................................................................................... 7<br />

2.1.1.3 Kontrolle der Installation ........................................................................ 8<br />

2.1.2 Deinstallation ........................................................................................................ 8<br />

2.1.2.1 Voraussetzung ....................................................................................... 8<br />

2.1.2.2 Durchführung ......................................................................................... 8<br />

2.1.2.3 Kontrolle der Deinstallation .................................................................... 8<br />

2.1.3 Aktualisierung ....................................................................................................... 8<br />

2.1.3.1 Voraussetzung. ...................................................................................... 8<br />

2.2 Konfiguration und Aufnahme des Betriebs ........................................................................ 8<br />

2.2.1 Voraussetzungen für den Betrieb ......................................................................... 8<br />

2.2.1.1 Benötigte zusätzliche Softwarekomponenten ....................................... 8<br />

2.2.1.2 Benötigte Konfigurationsbereiche ......................................................... 9<br />

2.2.1.3 Externe FTP-Server Anwendung........................................................... 9<br />

2.2.2 Konfiguration ......................................................................................................... 9<br />

2.2.2.1 Startparameter ....................................................................................... 9<br />

2.2.2.2 Parametrierung .................................................................................... 10<br />

2.2.3 Aufnahme des Betriebs ...................................................................................... 10<br />

2.3 Überwachung des Betriebs .............................................................................................. 11<br />

2.4 Unterbrechung oder Beendigung des Betriebs ................................................................ 11<br />

2.4.1 Voraussetzungen ................................................................................................ 11<br />

2.4.2 Unterbrechung des Betriebs ............................................................................... 11<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 4 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

2.4.3 Beenden des Betriebs ........................................................................................ 12<br />

3 Anwendungshandbuch ............................................................................................................... 13<br />

3.1 Zusatzprogramme ............................................................................................................ 13<br />

4 Diagnosehandbuch ..................................................................................................................... 14<br />

4.1 Benötigte Werkzeuge ....................................................................................................... 14<br />

4.2 Diagnosemöglichkeiten .................................................................................................... 14<br />

4.2.1 Analyse der Logdateien ...................................................................................... 14<br />

4.2.1.1 Fehler ................................................................................................... 14<br />

4.2.1.2 Warnungen .......................................................................................... 15<br />

4.2.1.3 Informationen ....................................................................................... 16<br />

5 Anhang ......................................................................................................................................... 18<br />

5.1 Verzeichnisstruktur .......................................................................................................... 18<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 5 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

0.4 Abkürzungsverzeichnis<br />

Siehe [AbkV].<br />

Darüber hinaus werden folgende Abkürzungen verwendet:<br />

BSVRZ<br />

DaV-DaV-Kopplung<br />

App-DaV-Kopplung<br />

Basis-System Verkehrsrechnerzentralen<br />

Datenverteiler-Datenverteiler-Kopplung<br />

Applikations- Datenverteiler -Kopplung<br />

0.5 Definitionen<br />

keine<br />

0.6 Referenzierte Dokumente<br />

AbkV<br />

AFoBLAK<br />

SysArcBLAK<br />

TAnfGlobalBLAK<br />

DatKat<br />

AFoNiDAUZ<br />

BetrHBVerzFTP<br />

BetrHbKSW<br />

BetrHbStartStopp<br />

Abkürzungsverzeichnis zum Projekt VIZ<br />

Anwenderforderungen zum VRZ-Basissystem gemäß BLAK-VRZ,<br />

aktueller Stand SE-02.00.00.00.00-AFo<br />

Systemarchitektur zum VRZ-Basissystem gemäß BLAK-VRZ,<br />

aktueller Stand SE-02.00.00.00.00-SysArc<br />

Technische Anforderungen zum VRZ-Basissystem gemäß BLAK-<br />

VRZ, aktueller Stand SE-02.00.00.00.00-TAnf-x.0<br />

Datenkatalog des BSVRZ, aktueller Stand, verfügbar als navigierbare<br />

HTML-Version<br />

Anwenderforderungen zur DAUZ Niedersachsen, aktueller Stand<br />

AFo_NI-DAUZ.doc<br />

Betriebshandbuch zur <strong>SWE</strong> FTP Verzeichnisüberwachung, aktueller<br />

Stand, BetrInf_<strong>SWE</strong>_FTPVerzeichnisUeberwachung.doc<br />

Betriebshandbuch zur Installation der Kernsoftware<br />

Betriebshandbuch zur <strong>SWE</strong> StartStopp, aktueller Stand<br />

BetrInf_<strong>SWE</strong>10.1_LosC3_VRZ3.doc<br />

0.7 Abbildungsverzeichnis<br />

Abbildung 2-1: Startscript Import für DOS ............................................................................................. 10<br />

Abbildung 2-2: Startscript Export für DOS ............................................................................................. 11<br />

0.8 Tabellenverzeichnis<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 6 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

1 Zweck des Dokuments<br />

In diesem Dokument sind die drei Bestandteile der Betriebsinformation aus Gründen der<br />

Übersichtlichkeit zusammengefasst:<br />

• Betriebshandbuch<br />

• Anwendungshandbuch<br />

• Diagnosehandbuch<br />

Folgende Typographie wird verwendet:<br />

Maschinenschrift kursiv<br />

Maschinenschrift<br />

Namen von Dateien, Ordnern und Benutzern<br />

Befehle und Texte die in der Kommandozeile oder einem<br />

graphischem Dialog eingeben werden<br />

Maschinenschrift im Fettdruck Teil eines Befehls oder Eingabetextes, der individuell angepasst<br />

werden muss<br />

Tabelle 1-1: Typographie<br />

Folgende Konventionen werden festgelegt:<br />

$PROJEKT_HOME<br />

$<strong>SWE</strong>_HOME<br />

Das Verzeichnis in dem das Projekt installiert ist<br />

Das Verzeichnis in dem diese <strong>SWE</strong> installiert wird<br />

Tabelle 1-2: Konventionen<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 7 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

2 Betriebshandbuch<br />

2.1 Installation der Software<br />

Dieser Abschnitt beschreibt die Neuinstallation, die Aktualisierung und die Deinstallation der <strong>SWE</strong><br />

<strong>BASt</strong>-Export/Import. Die <strong>SWE</strong> wird als ZIP-Archiv ausgeliefert, dessen Dateiname dem Muster<br />

de.inovat.kex.bast-D2012-10-11T115129.zip entspricht (Datum und Uhrzeit des Builds<br />

entsprechen dem aktuellen Stand).<br />

2.1.1 Erstinstallation<br />

2.1.1.1 Voraussetzungen<br />

Eine Java Runtime Umgebung ab Version 1.5 muss installiert und in der Pfadvariable des Systems<br />

eintragen sein. Das Java Runtime Environment (JRE) ist ausreichend, jedoch bietet das Java<br />

Development Kit (JDK) zusätzlich nützliche Tools für die Diagnose. Dies lässt sich auf der<br />

Kommandozeile mit folgendem Befehl überprüfen:<br />

java -version<br />

Erfolgt die Ausgabe der Kurzanleitung für den Befehl java ist der Pfad korrekt eingerichtet.<br />

Erfolgt eine Meldung, dass der Befehl nicht gefunden wurde, muss die Pfadvariable angepasst<br />

werden.<br />

Unter Unix-Systemen (unter anderem Linux, Mac OS X) kann dies mit folgendem Kommando<br />

erfolgen:<br />

export PATH=$PATH:/pfad_zu_java/bin<br />

Unter Windows muss der Pfad im Dialog Systemsteuerung/System/Erweitert/Umgebungsvariablen<br />

angepasst werden. Der Wert der Variablen PFAD muss um den Text ;/pfad_zu_java/bin ergänzt<br />

werden.<br />

Im Folgenden wird davon ausgegangen, dass ein JDK installiert ist.<br />

Die aktuelle Kernsoftware ist im Ordner $PROJEKT_HOME installiert. Die Installationsprozedur der<br />

Kernsoftware ist im Betriebshandbuch [BinfKSW] dokumentiert.<br />

Zusätzlich benötigte Komponenten: siehe Kapitel 2.2.1.1.<br />

2.1.1.2 Durchführung<br />

2.1.1.2.1 Installation der <strong>SWE</strong><br />

Der Inhalt des ZIP-Archivs der <strong>SWE</strong> muss in das Verzeichnis<br />

$PROJEKT_HOME/distributionspakete bzw. $PROJEKT_HOME/lib 1 kopiert werden.<br />

Unter Unix-Systemen das ZIP-Archiv mit<br />

unzip de.inovat.kex.bast-D2012-10-11T115129.zip<br />

1 Welches Verzeichnis verwendet wird, hängt von der jeweiligen Implementierung des Projektordners<br />

ab (ist also anwenderspezifisch). Im Folgenden wird bei den Beispielkommandos immer der Ordner<br />

$PROJEKT_HOME/lib verwendet.<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 8 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

entpacken und mit<br />

cp -r de.inovat.kex.bast$PROJEKT_HOME/lib<br />

den <strong>SWE</strong>-Ordner in den Ordner mit den Bibliotheken des Projekts kopieren.<br />

Unter Windows kann ab Windows XP der Windows-Explorer sowohl für das Entpacken, als auch für<br />

das Kopieren verwendet werden. Für ältere Windows-Systeme muss ein zusätzliches Tool zum<br />

Entpacken des ZIP-Archivs verwendet werden (z. B. das kostenlose 7-Zip http://7-zip.org).<br />

2.1.1.3 Kontrolle der Installation<br />

Nach erfolgreicher Installation wurde dem Ordner $PROJEKT_HOME/lib ein Unterordner<br />

de.inovat.kex.bast hinzugefügt und der Unterordner entspricht der Struktur im Anhang.<br />

2.1.2 Deinstallation<br />

2.1.2.1 Voraussetzung<br />

Eine Deinstallation darf nur erfolgen, wenn die <strong>SWE</strong> nicht läuft.<br />

Die Aktualisierung einer <strong>SWE</strong> ist ein guter Zeitpunkt, um das Backup des Projekts zu aktualisieren.<br />

Das Backup ist unbedingt erforderlich, um bei Problemen mit der neuen <strong>SWE</strong> den Zustand vor der<br />

Aktualisierung wiederherstellen zu können.<br />

2.1.2.2 Durchführung<br />

Zuerst muss kontrolliert werden, ob das Backup des Projekts erfolgreich erstellt wurde und ein<br />

Wiederherstellen möglich ist.<br />

Anschließend wird der Ordner der alten <strong>SWE</strong> gelöscht. Unter Unix-Systemen kann der folgende<br />

Befehl verwendet werden:<br />

rm –r $PROJEKT_HOME/lib/de.inovat.kex.bast<br />

Unter Windows wird der Windows-Explorer verwendet.<br />

2.1.2.3 Kontrolle der Deinstallation<br />

Der Ordner $PROJEKT_HOME/lib/de.inovat.kex.bast wurde erfolgreich entfernt.<br />

2.1.3 Aktualisierung<br />

2.1.3.1 Voraussetzung.<br />

Eine Aktualisierung darf nur erfolgen, wenn die <strong>SWE</strong> nicht läuft (siehe Abschnitt 2.4).<br />

Die Aktualisierung der <strong>SWE</strong> <strong>BASt</strong>-Export/Import entspricht der Deinstallation und anschließender<br />

Neuinstallieren der <strong>SWE</strong>).<br />

2.2 Konfiguration und Aufnahme des Betriebs<br />

2.2.1 Voraussetzungen für den Betrieb<br />

2.2.1.1 Benötigte zusätzliche Softwarekomponenten<br />

Folgende Pakete der Datenverteiler-Laufzeitumgebung müssen in der aktuellen Version installiert<br />

sein:<br />

• de.bsvrz.dav.daf<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 9 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

• de.bsvrz.sys.funclib.debug<br />

• de.bsvrz.sys.funclib.commandLineArgs<br />

• de.bsvrz.sys.funclib.application<br />

2.2.1.2 Benötigte Konfigurationsbereiche<br />

Folgende Konfigurationsbereiche müssen im Datenmodell aktiviert sein:<br />

• kb.tm<strong>BASt</strong><strong>Band</strong>ExportImport<br />

Dieser Konfigurationsbereich definiert das Teilmodell des Datenkataloges zur <strong>BASt</strong>-Export/Import<br />

Steuerung. Dieser Konfigurationsbereich wird unter dem Konfigurationsverantwortlichen<br />

kv.inovat bereitgestellt.<br />

2.2.1.3 Externe FTP-Server Anwendung<br />

Es muss eine externe FTP-Server-Anwendung aktiv sein, die folgende Konfiguration der<br />

Verzeichnisstruktur beinhaltet:<br />

Verzeichnis<br />

FTP-Basisverzeichnis<br />

Import<br />

Verkehr_Menge_2004<br />

Verkehr_Geschwindigkeit_2007<br />

Bearbeitet<br />

Verkehr_Menge_2004<br />

Verkehr_Geschwindigkeit_2007<br />

Export<br />

Verkehr_Menge_2004<br />

Verkehr_Geschwindigkeit_2007<br />

Achslast_2009<br />

Verwendung<br />

Basisverzeichnis des FTP-Servers<br />

Eingangsordner<br />

Verschiebe Ordner<br />

Ausgangsordner<br />

Dieser FTP-Server muss durch eine externe Software realisiert werden, die in einem eigenen Prozess<br />

läuft und unabhängig von dieser <strong>SWE</strong> gestartet und administriert wird. Diese Software muss folgende<br />

Funktionen realisieren:<br />

• Passiver Verbindungsaufbau (wenn gewünscht).<br />

• Authentifizierung des Kommunikationspartners.<br />

• Empfang, Speicherung und Löschen von Dateien im Dateisystem in allen obig angegebenen<br />

Verzeichnissen.<br />

Die benötigten Parameter für den Meldungstransfer (Server, FTP-Benutzer und Passwort) sind<br />

abzustimmen.<br />

2.2.2 Konfiguration<br />

Die <strong>SWE</strong> <strong>BASt</strong>-Export/Import benötigt ein Konfigurationsobjekt vom Typ<br />

typ.bastExportImportSteuerung<br />

Das Verhalten der <strong>SWE</strong> lässt sich wie folgt beeinflussen.<br />

2.2.2.1 Startparameter<br />

Die Applikation unterstützt alle geforderten Parameter an die Starterschnittstelle für Datenverteiler-<br />

Applikationen.<br />

Die <strong>SWE</strong> verarbeitet folgenden Aufrufparameter:<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 10 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

- pidBastExportImportSteuerung = Text PID des Verwaltungsobjekts.<br />

Angabe der PID des Verwaltungsobjekts vom Typ<br />

typ.bastExportImportSteuerung aus dem<br />

Konfigurationsbereich mit<br />

kb.tm<strong>BASt</strong><strong>Band</strong>ExportImport.<br />

Beispiel:<br />

-pidBastExportImportSteuerung=<br />

bast<strong>Band</strong>.niDauz<br />

2.2.2.2 Parametrierung<br />

Die <strong>SWE</strong> <strong>BASt</strong>-Export/Import muss bzw. kann nicht parametriert werden (im Sinne von Parameter-<br />

Attributgruppen am Datenverteiler).<br />

2.2.3 Aufnahme des Betriebs<br />

Nachfolgend ist beispielhaft ein Auszug der relevanten Einstellungen eines möglichen Startscripts für<br />

DOS dargestellt (farbliche Darstellung/Fettdruck nur zur besseren Darstellung der <strong>SWE</strong>-spezifischen<br />

Parameter):<br />

Main-Klasse (Export):<br />

Main-Klasse (Import):<br />

de.inovat.kex.bast.exporter.<strong>BASt</strong>ExportSteuerung<br />

de.inovat.kex.bast.importer.<strong>BASt</strong>ImportSteuerung<br />

Classpath:<br />

de.inovat.kex.bast-runtime.jar<br />

Nachfolgend sind die Startscripte für DOS für den Export bzw. Import dargestellt:<br />

Abbildung 2-1: Startscript Import für DOS<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 11 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

Abbildung 2-2: Startscript Export für DOS<br />

Der mehrfache Start der Anwendungen ist nur einmal für den Export und einmal den Import<br />

vorgesehen.<br />

2.3 Überwachung des Betriebs<br />

Um zu prüfen, ob die <strong>SWE</strong> <strong>BASt</strong>-Export/Import läuft, muss ein JDK anstelle der JRE installiert sein.<br />

Mit dem dann zur Verfügung stehenden Befehl jps kann der Status bestimmt werden.<br />

jps -l<br />

gibt die Liste der laufenden Java-Prozesse aus. Nur wenn in der Liste ein Eintrag<br />

19483 de.inovat.kex.bast.exporter.<strong>BASt</strong>ExportSteuerung.jar<br />

auftaucht, läuft die Applikation. Die Prozess-ID zu Beginn der Zeile kann variieren.<br />

Unter Unix-Systemen kann anstelle von jps das Kommando ps verwendet werden. Wenn der Befehl<br />

ps -fA | grep <strong>BASt</strong>ExportSteuerung<br />

eine Ausgabe liefert, die -jar de.inovat.kex.bast.exporter.<strong>BASt</strong>ExportSteuerung.jar enthält,<br />

dann läuft die Applikation.<br />

Hinweis: Abhängig vom Startscript bzw. Startverfahren (z. B. StartStopp), kann das Verfahren vom<br />

hier beschriebenen abweichen.<br />

2.4 Unterbrechung oder Beendigung des Betriebs<br />

2.4.1 Voraussetzungen<br />

Der Betrieb kann jederzeit beendet werden.<br />

2.4.2 Unterbrechung des Betriebs<br />

Eine vorübergehende Unterbrechung des Betriebs der <strong>SWE</strong> ist nicht vorgesehen.<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 12 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

2.4.3 Beenden des Betriebs<br />

Das Vorgehen unterscheidet sich zwischen Unix-System und Windows.<br />

Unter Unix-Systemen wird zunächst analog 2.4 die Prozess-ID der zu beendenden <strong>SWE</strong> ermittelt. Der<br />

Befehl<br />

jps -l<br />

liefert zum Beispiel folgende Ausgabe:<br />

19483 de.inovat.kex.bast.exporter.<strong>BASt</strong>ExportSteuerung.jar<br />

Mit dem Befehl<br />

kill 19483<br />

kann die <strong>SWE</strong> dann beendet werden. Mit einem weiteren Aufruf von<br />

jps -l<br />

kann geprüft werden, ob die <strong>SWE</strong> tatsächlich beendet wurde.<br />

Wurde unter Windows die <strong>SWE</strong> mit dem gelieferten Startskript gestartet, kann sie durch Schließen<br />

des Terminalfensters mit dem Titel „BAST-EXPORT“ bzw. „BAST-IMPORT“ beendet werden oder<br />

über den Befehl<br />

taskkill /pid 19483 /f<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 13 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

3 Anwendungshandbuch<br />

Die <strong>SWE</strong> ist ein reiner Serverprozess. Der Anwender nutzt die <strong>SWE</strong> nur indirekt über andere <strong>SWE</strong><br />

und deren Benutzerschnittstelle.<br />

3.1 Zusatzprogramme<br />

Mit dem Distributionspaket der <strong>SWE</strong> <strong>BASt</strong>-Export/Import wird ein Zusatzprogramm ausgeliefert,<br />

welches eine Verzeichnisüberwachung auf dem FTP-Server sowie ein Verschieben bearbeiteter<br />

Dateien aus den jeweiligen Importverzeichnissen durchführt.<br />

Das Programm überwacht die ihm via Parameter übergebenen Verzeichnisse. Sobald in dem zu<br />

überwachendem Verzeichnis eine Datei ohne Endung .lock oder .bearbeitet aufgefunden wird,<br />

sendet das Programm diese Informationen an den Datenverteiler. Genauere Informationen sind dem<br />

Betriebshandbuch zu entnehmen [BetrHBVerzFTP].<br />

Die <strong>SWE</strong> <strong>BASt</strong>-Export/Import meldet sich beim Datenverteiler an (Objekttyp:<br />

typ.bastExportImportSteuerung, Attributgruppe atg.bastImportVerzeichnisUeberwachung,<br />

Aspekt asp.zustand). Sobald die <strong>SWE</strong> <strong>BASt</strong>-Export/Import über den Datenverteiler von der <strong>SWE</strong><br />

Verzeichnisüberwachung FTP-Server über eine existierende Datei informiert wurde, startet die <strong>SWE</strong><br />

<strong>BASt</strong>-Export/Import den Importvorgang, der via Parameter übergebenen Datei. Die <strong>SWE</strong> <strong>BASt</strong>-<br />

Export/Import sperrt die zu importierende Datei direkt mittels der Endung .lock, so dass diese nicht<br />

durch einen weiteren Prozess bearbeitet werden kann. Sobald der Importvorgang erfolgreich<br />

abgeschlossen ist, entsperrt die <strong>SWE</strong> <strong>BASt</strong>-Export/Import die Datei und macht sie so kenntlich, dass<br />

die <strong>SWE</strong> Verzeichnisüberwachung diese Datei als zu verschiebende Datei erkennt, mittels der<br />

Endung .bearbeitet.<br />

Der Anwender der <strong>SWE</strong> <strong>BASt</strong>-Export/Import kann dieses Zusatzprogramm bei Bedarf starten, wenn<br />

der <strong>BASt</strong>-Export/Import Importprozess automatisch vollzogen, und auch die schon bearbeiteten<br />

Dateien verschoben werden sollen. Voraussetzung für die <strong>SWE</strong> <strong>BASt</strong>-Export/Import sind die<br />

Zusatzprogramme Verzeichnisüberwachung FTP-Server nicht.<br />

Das Plug-in de.inovat.buv.plugin.gtm.bast erlaubt die Steuerung des Import- und Exportvorganges<br />

mittels einer Benutzeroberfläche. Diese Benutzeroberfläche erlaubt die Zugangsdaten (URL, Benutzer<br />

und Passwort) für den FTP-Server anzugeben. Mittels Dateiauswahldialog ist es dem Benutzer<br />

möglich die zu importierenden Dateien auf dem FTP-Server auszuwählen. Der Importvorgang durch<br />

das Plug-in de.inovat.buv.plugin.gtm.bast ist nur dann zu starten, wenn der Prozess <strong>SWE</strong> <strong>BASt</strong>-<br />

Export/Import (Import) läuft. Beim Exportvorgang ist es dem Benutzer möglich, neben den<br />

Zugangsdaten für den FTP-Server den Zeitbereich und die Zählstellen anzugeben, für die ein Export<br />

durchgeführt werden soll. Die Exportfunktionalität kann nur dann gestartet werden, wenn der Prozess<br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import (Export) läuft, des Weiteren benötigt der Exportvorgang das Archiv, da die<br />

zu exportierenden Daten aus dem Archiv gelesen werden.<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 14 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

4 Diagnosehandbuch<br />

4.1 Benötigte Werkzeuge<br />

• Ein beliebiger Viewer für Textdateien<br />

• GTM<br />

• jps aus dem JDK<br />

4.2 Diagnosemöglichkeiten<br />

Auftretende ungewöhnliche Situationen und Fehler werden über Warnungen und Fehler ausgegeben.<br />

Die Steuerung der Ausgabe kann über die entsprechenden Standardparameter für<br />

Datenverteileranwendungen kontrolliert werden.<br />

In besonderen Fällen werden Betriebsmeldungen erzeugt.<br />

4.2.1 Analyse der Logdateien<br />

Je nach eingestelltem Log-Level enthalten die Logdateien mehr oder weniger Informationen. Für den<br />

Normalbetrieb ist der Log-Level CONFIG (Standard im mitgelieferten Startskript) oder INFO<br />

empfehlenswert. Für die Diagnose muss mindestens Log-Level WARNING gesetzt sein. Zur Lösung<br />

von speziellen Problemen werden auf den Log-Leveln FINE, FINER und FINEST umfangreiche<br />

Ausgaben gemacht. Für den Normalbetrieb sollten diese drei Level jedoch aus diesem Grund nicht<br />

verwendet werden.<br />

4.2.1.1 Fehler<br />

Log-Einträge mit dem Level ERROR können den Betrieb verhindern. Die Funktionen der <strong>SWE</strong> stehen<br />

nicht oder nur sehr eingeschränkt zur Verfügung. Die Ursache eines Fehlers muss umgehend<br />

behoben werden, damit die <strong>SWE</strong> funktionstüchtig ist.<br />

Folgende Fehlermeldungen werden bei Bedarf generiert<br />

Meldungstext<br />

Es sind Probleme bei der<br />

Konvertierung der Daten<br />

aufgetreten.<br />

Es sind Probleme beim<br />

Senden der<br />

Statusinformationsdaten<br />

aufgetreten.<br />

Es sind Probleme bei der<br />

Erzeugung der <strong>BASt</strong>-Instanz<br />

aufgetreten.<br />

Es sind Probleme bei der<br />

Anmeldung beim<br />

Datenverteiler aufgetreten.<br />

Die Anwendung wird<br />

geschlossen.<br />

Ursache<br />

Die <strong>SWE</strong> <strong>BASt</strong>-Export/Import verarbeitet die ResultData die<br />

über den Datenverteiler versendet werden, wenn bei der<br />

Konvertierung der ResultData in das interne Format Probleme<br />

auftreten wird dieser Meldungstext ausgegeben.<br />

Die <strong>SWE</strong> <strong>BASt</strong>-Export/Import versendet Statusinformationen<br />

über den Datenverteiler. Die Meldung gibt Auskunft darüber,<br />

dass ein Versenden der Statusinformationen nicht möglich<br />

war.<br />

Es konnte keine Instanz für den <strong>BASt</strong>-Export/Import erzeugt<br />

werden.<br />

Die <strong>SWE</strong> <strong>BASt</strong> konnte sich nicht beim Datenverteiler<br />

anmelden. Die <strong>SWE</strong> wird sofort beendet.<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 15 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

Es konnte keine Verbindung<br />

zum FTP-Server hergestellt<br />

werden.<br />

Die Verbindung zum FTP-<br />

Server konnte nicht<br />

aktualisiert werden.<br />

Es sind Probleme beim<br />

Einlesen der Daten<br />

aufgetreten.<br />

Ein login auf dem FTP-<br />

Server war nicht möglich.<br />

Die Daten konnten nicht<br />

versendet werden.<br />

Es ist nicht möglich in das<br />

korrekte Verzeichnis auf<br />

dem FTP-Server zu wechseln.<br />

Bitte kontrollieren Sie die<br />

Angaben.<br />

Die Datei konnte nicht auf<br />

den FTP-Server geschrieben<br />

werden.<br />

Es sind Probleme beim<br />

Export aufgetreten. Der<br />

aktuelle Exportvorgang wird<br />

abgebrochen.<br />

"Es sind Probleme beim<br />

Bestimmen der<br />

Langzeitzählstellen bzgl.<br />

Achslasterfassung<br />

aufgetreten. Der aktuelle<br />

Exportvorgang wird<br />

abgebrochen!"<br />

Es kann keine Verbindung zum FTP-Server hergestellt<br />

werden.<br />

Sollte eine FTP-Verbindung unterbrochen worden sein (z.B.<br />

durch ein Time-Out) versucht sich die <strong>SWE</strong> <strong>BASt</strong>-<br />

Export/Import wieder neu mit dem FTP-Server zu verbinden.<br />

Ist dies nicht möglich wird diese Fehlermeldung ausgegeben.<br />

Der aktuelle Import/Exportvorgang wird abgebrochen.<br />

Es konnten nicht die Daten vom FTP-Server eingelesen<br />

werden.<br />

Es kann keine Verbindung zum FTP-Server hergestellt<br />

werden, da der Benutzername oder das Passwort nicht<br />

korrekt ist. Der aktuelle Import/Exportvorgang wird<br />

abgebrochen.<br />

Die Importierten Daten können nach Konvertierung in das<br />

Datenverteilerformat nicht versendet werden.<br />

Auf dem FTP-Server kann nicht in das via Parameter<br />

angegebene Verzeichnis gewechselt werden.<br />

Die <strong>SWE</strong> konnte den Export nicht abschließen. Die Dateien<br />

sind kenntlich durch die Endung .lock, da nur die Dateien in<br />

.bearbeitet umbenannt werden, bei denen der Exportvorgang<br />

vollständig durchgeführt werden konnte.<br />

Es sind Probleme beim Export aufgetreten. Der aktuelle<br />

Exportvorgang wird abgebrochen.<br />

"Es sind Probleme beim Bestimmen der Langzeitzählstellen<br />

bzgl. Achslasterfassung aufgetreten. Der aktuelle<br />

Exportvorgang wird abgebrochen!"<br />

Tabelle 4-1: Fehlermeldungen<br />

4.2.1.2 Warnungen<br />

Log-Einträge mit dem Level WARNING behindern zwar den Betrieb, verhindern ihn jedoch nicht. Es<br />

stehen jedoch nicht alle Funktionen der <strong>SWE</strong> zur Verfügung. Die Ursache einer Warnung sollte<br />

behoben werden, damit die <strong>SWE</strong> voll funktionstüchtig ist. Warnungen werden immer auch als<br />

Betriebsmeldung versandt.<br />

Folgende Warnungen werden bei Bedarf generiert.<br />

Meldungstext<br />

Die Abmeldung zum Versenden<br />

der Statusinformation konnte<br />

nicht durchgeführt werden.<br />

Ursache<br />

Die Abmeldung zum Versenden der Statusinformation<br />

konnte nicht durchgeführt werden.<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 16 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

Meldungstext<br />

Ursache<br />

Die Anmeldung/Abmeldung für<br />

die Verzeichnisüberwachung<br />

konnte nicht durchgeführt<br />

werden.<br />

Die Abmeldung der<br />

[SystemObjekte] konnte nicht<br />

durchgeführt werden.<br />

Die FTP-<br />

Verzeichnisinformationsdaten<br />

können nicht angezeigt<br />

werden.<br />

Die Datei [Dateiname]<br />

konnte nicht gelöscht<br />

werden.<br />

Im Importverzeichnis<br />

V2004/V2007 befindet sich<br />

eine Datei [Dateiname] die<br />

nicht eingelesen werden<br />

kann, bitte kontrollieren<br />

Sie diese Datei.<br />

Es sind Probleme beim Parsen<br />

des Datums aufgetreten.<br />

Bitte kontrollieren Sie die<br />

Eingabedatei.<br />

Probleme beim Parsen der<br />

Richtungsangabe. Bitte<br />

kontrollieren Sie die<br />

Eingabedatei.<br />

Die Richtungsangabe ist<br />

weder in Richtung 1 noch in<br />

Richtung 2, bitte überprüfen<br />

Sie dies in dem zu<br />

importierendem Dokument. Der<br />

Import wird abgebrochen, die<br />

Sperre der Datei bleibt<br />

erhalten.<br />

Die Anwendung erhält somit keine Informationen von der<br />

<strong>SWE</strong> Verzeichnisüberwachung FTP-Server. Da diese<br />

Softwareeinheit optional eingesetzt werden kann führt dies<br />

zu keinen Einschränkungen im Ablauf der <strong>SWE</strong> <strong>BASt</strong>-<br />

Export/Import.<br />

Die angegebenen Systemobjekte konnten nicht vom<br />

Datenverteiler abgemeldet werden.<br />

Es ist der <strong>SWE</strong> nicht möglich die Verzeichnisinformationen<br />

auf dem FTP-Server auszulesen.<br />

Der <strong>SWE</strong> war es nicht möglich die Datei mit dem Namen<br />

Dateiname zu löschen.<br />

Die Datei mit Namen Dateiname befindet sich in dem V2004<br />

Importverzeichnis. Beim Import wurde festgestellt, dass es<br />

sich bei dieser Datei um eine Datei handelt die nicht den<br />

Konventionen des <strong>BASt</strong>-Export/Import V2004 Formates<br />

entspricht, oder beschädigt ist. Die Datei wird gesperrt, aber<br />

nicht eingelesen.<br />

Die Eingabedatei entspricht nicht den Konventionen, es sind<br />

Probleme beim Parsen des Datums aufgetreten. Der Import<br />

der Datei wird abgebrochen.<br />

Die Eingabedatei entspricht nicht den Konventionen, es sind<br />

Probleme beim Parsen der Richtungsangabe aufgetreten.<br />

Der Import der Datei wird abgebrochen.<br />

Die Richtungsangabe ist weder in Richtung 1 noch in<br />

Richtung 2, bitte überprüfen Sie dies in dem zu<br />

importierendem Dokument. Der Import wird abgebrochen,<br />

die Sperre der Datei bleibt erhalten.<br />

Tabelle 4-2: Warnungen<br />

4.2.1.3 Informationen<br />

Die <strong>SWE</strong> <strong>BASt</strong>-Export/Import gibt Meldungen über ausgeführte Aktionen oder den aktuellen Zustand<br />

auf dem Level INFO aus. Da die <strong>SWE</strong> dieselben Aktionen unabhängig voneinander mit sehr vielen<br />

Objekten ausführt, wird auf Meldungen auf diesem, dem Standardlevel, verzichtet. Es werden nur<br />

beim Start Informationen auf diesem Level ausgegeben.<br />

Folgende Informationen über den laufenden Betrieb werden ausgegeben:<br />

Meldungstext<br />

Die Anmeldung beim<br />

Datenverteiler ist erfolgt.<br />

Beschreibung<br />

Die Anmeldung beim Datenverteiler ist erfolgt.<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 17 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

Der Exportvorgang V2004 wird<br />

gestartet.<br />

Zählstelle mit der Pid [pid]<br />

wurde nicht gefunden. Pid<br />

wird ignoriert.<br />

Daten der Zählstelle [LZZS]<br />

werden ausgegeben.<br />

Der Exportvorgang V2007 wird<br />

gestartet.<br />

Die Datei [Dateiname] wurde<br />

erfolgreich importiert!<br />

Der Exportvorgang für die <strong>BASt</strong>-Export/Import Version 2004<br />

wird gestartet.<br />

Die <strong>SWE</strong> durchsucht alle existierenden Langzeitzählstellen<br />

und prüft ob eine Langzeitzählstelle mit der übergebenen<br />

Pid existiert. Existiert die Langzeitzählstelle nicht, wird die<br />

Pid ignoriert, der <strong>BASt</strong>-Export/Import Exportprozess läuft<br />

weiter.<br />

Information darüber welche Zählstellendaten exportiert<br />

werden.<br />

Der Exportvorgang für die <strong>BASt</strong>-Export/Import Version<br />

V2007 wird gestartet.<br />

Die Datei mit Namen Dateiname wurde erfolgreich<br />

importiert.<br />

Tabelle 4-3: Informationen<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc


Niedersächsische<br />

Landesbehörde für<br />

Straßenbau und Verkehr<br />

NI-DAUZ<br />

<strong>Betriebsinformationen</strong><br />

<strong>SWE</strong> <strong>BASt</strong>-Export/Import<br />

Seite: 18 von 18<br />

Version: 5.0<br />

Stand: 11.02.13<br />

5 Anhang<br />

5.1 Verzeichnisstruktur<br />

Die vollständig installierte <strong>SWE</strong> hat folgende Verzeichnisstruktur:<br />

$<strong>SWE</strong>_HOME<br />

└───de.inovat.kex.bast<br />

│ de.inovat.kex.bast-Build-Report.txt<br />

│ de.inovat.kex.bast-GPL-lizenz.txt<br />

│ de.inovat.kex.bast-runtime.jar<br />

│ de.inovat.kex.bast-src.zip<br />

│ de.inovat.kex.bast.jar<br />

│<br />

├───global.commons-net<br />

│ commons-net.jar<br />

│<br />

└───global.junit<br />

junit-4.8.1.jar<br />

Datei: BetrInf_KEx-<strong>BASt</strong>ExportImport_FREI_V5.0_D2013-02-11.doc

Hurra! Ihre Datei wurde hochgeladen und ist bereit für die Veröffentlichung.

Erfolgreich gespeichert!

Leider ist etwas schief gelaufen!