README zur Installation der Schnittstelle xGewerbeanzeigen /OSCI-Transport ========================================================================== # Die Spezifikation 1.3 ist zum Stichtag 01.05.2018 in Kraft getreten, # # daher sollte die Version B2 schon bei allen Kunden installiert worden # # sein. Dieses Update B3 ist ein technisches Hotfix-Release. # ========================================================================== Autor: Frank Holler Gültig für: alle Kunden - öffentliche Auslieferung Version xGewerbe1.3 b3 für Test und anschließenden Produktivsetzung gem. Spezifikation 1.3 xGewerbeanzeigen - Das Paket enthält nur das Update der Jobs im BSS. Zur erneuten Erstinstallation warten Sie bitte auf die Version B4 für BALVI iP 1.24.14 oder höher. - Bugfixes im Paket Schnittstelle xGewerbe gemäß Spezifikation 1.3 (B3) für den BSS 3.5.x und BALVI iP 1.24.13 oder höher. Letzte Änderung: 03.05.2018 Für BALVI iP: 1.24.13 - 1.24.14 (Testumgebung u. Produktion) Für Webserver: BALVI Schnittstellenserver (BSS) 3.2.x oder höher Java-Umgebung: mindestens Oracle Java JDK8 (min. 8u92 oder höher) ** mit Unlimited Strength Jurisdication Policy Tomcat: mindestens Tomcat 7.0.37 bzw. Tomcat 8.0.30 Die Versionen B1/B2 dürfen ab BALVI iP 1.24.13 nicht mehr verwendet werden. Das Update BALVI 3 ist ein technischer Fix für BALVI iP 1.24.13/1.24.14, der keine fachlichen Änderungen enthält. In Kürze wird der Patch "B4" veröffentlicht, der BALVI iP 1.24.14 voraussetzt und auch fachliche Erweiterungen beinhaltet. Update vom 06.12.2018 (xGewerbe1.3 b3): ======================================= Es wurden ausschließlich die Inhalte der Datenbank (Verarbeitungslogik) für den BSS (JOB's) auf Version "B3" angehoben. Alle anderen Inhalte bleiben unverändert. Damit ist das Paket B3 nun Kompatibel mit BSS 3.5 und BALVI iP 1.24.13 und 1.24.14. - Zum Update von Paket B1/B2 auf B3 muss nur die beiligende UPDATE.exe ausgeführt werden. Für eine komplette Neuinstallation warten Sie auf B4. - Anpassungen am laufenden BSS selbst sind nicht erforderlich, jedoch muss dieses Paket eingespielt sein, BEVOR der BSS auf Version3.5.x aktualisiert wird. - technische Anpassungen 1.) Anpassung für den BSS 3.5.x oder höher Mit der Aktualisierung der Systembibliotheken für die XML-Verarbeitung im BSS 3.5 auf "STAX2" ist ein Fehler bei der Verarbeitung von Gewerbemeldungen aufgetreten, der zu einem Loop-Of-Death bei der Verarbeitung führt. Daher MUSS das Paket "B3" oder höher eingespielt sein, BEVOR der BSS 3.5.x oder höher verwendet werden kann. 2.) Views entfernt Im Paket "B1/B2" waren zwei Views aus Release 1.24.12 enthalten, die mit dem Release 1.24.13 geändert wurden. Daher gab es einen Reihenfolge-Fehler, wenn das Paket nach dem Einspielen von Release 1.24.13 genutzt wurde. Die im Release 1.24.13 geänderten Views werden dabei Invalid und dadurch bedingt gab es einen Fehler bei der Ausführung des GRANT-Skriptes. 3.) LOG-Ausgabe korrigiert In den vorherigen Versionen wurden Fehlermeldungen vom TYP ERROR im Protokoll immer mit zwei Zeilen ausgegeben: LOG-Eintrag: ERROR Die Meldung wird Übersprungen, da keine LM Tätigkeit vorliegt. (UUID : " + getdatmlrawItem("UUID")) LOG-Eintrag: ERROR Die Meldung enthält ungültige WZG2008 Tätigkeitsschlüssel : [] Der zweite ERROR sollte jedoch nur auftreten, wenn in der Meldung ein WZG2008-Code verwendet wurde, der nicht in der Liste von DeStatis enthalten ist. [] ist daher eine "falsche Fehlermeldung", steht jedoch zwischen den Klammern ein Text, so liegt ein echter Fehler vor. Das ist durch die Flut an Meldungen jedoch nur schwer erkennbar. Daher wurde die Logik folgendermaßen angepasst: Die Meldung "keine LM-Relevante Tätigkeit" ist nun nur noch eine Warnung, da diese Meldung für die Anwender nicht bereitgestellt wird. Der Inhalt der Sendung ist jedoch trotzdem fachlich korrekt. LOG-Eintrag: WARN Die Meldung wird Übersprungen, da keine LM Tätigkeit vorliegt. (UUID : " + getdatmlrawItem("UUID")) Die zweite Meldung kommt nur noch, wenn der im DATML/RAW angegebene Schlüssel falsch ist. Zeilen mit [] sollten nicht mehr auftreten. LOG-Eintrag: ERROR Die Meldung enthält ungültige WZG2008 Tätigkeitsschlüssel : [52297] Auftretende LOG-Meldungen vom Typ ERROR sind daher nun im Sinne der Spezifikation xGewerbeanzeige echte Fehler, die geprüft werden müssen. 4.) Windows-Bugfix für "Dateiimport" Gemeldet aus Hamburg wurde folgendes Problem: "Bei der Verarbeitung bleibt immer die letzte Gewerbemeldung im Dateiimport-Ordner liegen und wird nicht gelöscht. Beim nächsten Start wird diese Meldung doppelt verarbeitet." Das Verhalten trifft ausschließlich bei Windows in Verbindung mit dem Dateiimport (nicht OSCI) zu, da das Handle für die letzte importierte Datei zu spät freigegeben wurde. Daher schlägt die Löschung der Datei unter Windows fehlt. Das Verhalten ist jedoch unter Linux anders, daher ist Linux von diesem Fehler nicht betroffen. Linux lässt die Löschung von "geöffneten Dateien" zu. Diese sind dann mit dem Befehl lsof -nP +L1 | grep -e '(deleted)' noch einige Zeit zu finden, aber im Verzeichnis nicht mehr sichtbar. Daher werden sie auch nicht doppelt eingelesen. Linux stellt nach einiger Zeit von selbst fest, dass das Handle geschlossen wurde und gibt die Datei dann auch frei. Der Bugfix sorgt nun dafür, dass das Handle auf die XML-Datei geschlossen ist, bevor der Löschauftrag angestoßen wird. Damit sollte das Problem unter Windows nicht mehr auftreten. - BALVI iP Datenbank-Patch ausführen - Im IP-Patch sind diverse Anpassungen für die Verarbeitung der xGewerbeanmeldungen enthalten. Führen Sie die UPDATE.exe auf jeden Fall nur dann aus, wenn der BSS heruntergefahren wurde, damit es keine Verarbeitungsfehler gibt. Bei Fragen kontaktieren Sie bitte die technische Kundenbetreuung Ansprechpartner: Frau Prautzsch, Herr Holler Tel. 0451 - 702 80 80 E-Mail: support@balvi.de