4.1 Nicht-händische Anpassung des Repositorys
Werbung
Memo R 52.1 - Version 6.08.00 An: ASYS - Administratoren Von: Stephan Meyer, Sören Gehrke Thema: Auslieferung R52.1 / ASYS Version 6.08.00 (6.07.00) Umstellung von 6.06.01 auf 6.08.00 Datum: 15.05.2017 Inhalt 1. Allgemeines .................................................................................... 3 2. Update der Programmversion ........................................................... 5 2.1 Setup ................................................................................... 5 2.2 Dateien und Dateianpassungen ................................................ 5 2.2.1 Transformations- und Schemadateien .................................... 5 3. Änderung der Datenbank ................................................................. 6 3.1 Datenbankskript UpdateDB_ASYS6_07_00 ................................ 6 4. Anpassung des Repositorys .............................................................. 7 4.1 Nicht-händische Anpassung des Repositorys .............................. 7 4.1.1 Mergen des Repositorys........................................................ 7 4.1.2 Repository-Services ............................................................. 7 4.1.2.1 Service Nur LEA: Umstellung der Löschund Historisierungsbäume der Stammdaten auf Bäume inkl. der LEATabellen 7 4.1.2.2 Allgemeiner Service für die Version 6.07.00......................... 7 4.2 Händische Anpassung des Repositorys ...................................... 8 4.2.1 Überwachung der OSCI-Kommunikation ................................. 8 4.2.2 Regelmäßiger ‚Select‘ auf die Datenbank ................................ 8 4.2.3 Vorgangssteuerung – automatisiertes Setzen der Laufzeit bei ENP und SNP .................................................................................. 8 5. Aktualisierung des Datenbestandes .................................................. 10 5.1 Service-Routinen ..................................................................10 5.1.1 Service-Routine, die das 70-Zeichenfeld der Bezeichnung der Entsorgungsanlage der Freistellung in zwei Felder aufteilt ...................10 5.2 Katalogupdate ......................................................................10 6. Besondere Hinweise zum Update des AsysServers sofern der Patch R 50.3 vom 17.02.2017 nicht durchgeführt wurde ..................................... 12 81967539 -1- Memo R 52.1 - Version 6.08.00 7. Checkliste ..................................................................................... 13 8. Übersicht Versionsstand nach R 52.1 ................................................ 14 9. Anhang: Anpassung der Vorgangssteuerung zur automatisierten Eintrag der behördlichen Gültigkeit eines EN/SN im priv Verfahren....................... 15 81967539 -2- Memo R 52.1 - Version 6.08.00 1. Allgemeines Vorbemerkung: Wir empfehlen, dieses Dokument auszudrucken und vor dem Beginn der Aktualisierung auf die Auslieferung R52.1 / ASYS Version 6.08.00 einmal komplett durchzulesen. Dieses Dokument beschreibt die für einen Umstieg von der Auslieferung R50.1 / Version 6.06.01 auf die Auslieferung R52.1 / Version 6.08.00 notwendigen Schritte. Wenn Sie noch nicht auf die Version 6.07.00 umgestellt haben, brauchen Sie die Version 6.07.00 vor der Aktualisierung auf die Version 6.08.00 nicht zu installieren, sondern können direkt von der Version 6.06.01 auf die Version 6.08.00 aktualisieren. Falls noch nicht auf Version 6.07.00 umgestellt wurde, empfehlen wir dieses Vorgehen ausdrücklich (insbesondere zur Vermeidung des Programmfehlers ASYS-1913). Wenn Sie bereits auf die Version 6.07.00 umgestellt haben öffnen Sie bitte das Dokument „Memo_Auslieferung_R_52_1“ und befolgen Sie die dortigen Anweisungen. Die Auslieferungen R52.1 / Version 6.08.00 und R52.1 / Version 6.08.00 enthalten Fehlerbehebungen und Optimierungen in allen ASYSKomponenten. Welche Fehler behoben und welche Optimierungen umgesetzt worden sind, entnehmen Sie bitte dem JIRA-Meldungssystem. Für die Anzeige der behobenen Meldungen stehen Ihnen in JIRA unter Vorgänge – Filter – Filter verwalten – Suche die Filter „R51.1 / Version 6.07.00: geschlossene Meldungen“ und „R52.1 / Version 6.08.00: geschlossene Meldungen“ zur Verfügung. Mit der Auslieferung R52.1 / Version 6.08.00 werden auch die Optimierungen umgesetzt, die notwendig sind, um ASYS an die ab 01.07.2017 zu verwendende geänderte BMU-Schnittstelle anzupassen. Es ist daher zwingend erforderlich, dass ab dem 01.07.2016 ausschließlich diese Auslieferung bzw. Version produktiv eingesetzt wird. Dies gilt auch für alle Anwenderarbeitsplätze. Bitte teilen Sie der IKA über die E-Mail-Adresse [email protected] ggf. getrennt mit, wenn Sie den ASYS-Kommunikationsserver bzw. alle ASYSInstallationen im produktiven Betrieb auf die Auslieferung R52.1 / Version 6.08 umgestellt haben. Mit der Auslieferung R52.1 wird auch ein neuer Kommunikationsserver (Version 6.08.00) ausgeliefert, der ASYS zum Empfang von mit Hilfe der neu 81967539 -3- Memo R 52.1 - Version 6.08.00 entwickelten Webanwendung erstellten elektronischen Mengenmeldungen ertüchtigt (ASYS-1008 und ASYS-1009). Erst nach erfolgter Inbetriebnahme des neuen Kommunikationsservers (Version 6.08.00) werden wir die Nutzer der neu entwickelten Webanwendung für den Versand von Mengenmeldungen von der Webanwendung an Ihre Knotenstelle freischalten. Teil dieser Auslieferung ist eine neue Version der Signaturanwendungskomponente SecSigner. Eine Liste der von dieser Version des SecSigners unterstützten Signaturkarten und Kartenlesegeräte finden Sie unter https://seccommerce.com/unterstuetzte-signaturkarten/. Wie bei allen Auslieferungen zur Versionsreihe 6 umfasst das beigefügte Setup-Programm alle –auch die mit dieser Auslieferung nicht aktualisiertenKomponenten von ASYS. Das Setup-Programm ist aus diesem Grund sowohl für eine Erstinstallation als auch für ein Update jeder vorhandenen ASYSProgrammversion der Versionsreihe 6 unabhängig vom jeweiligen Versionsstand geeignet. 81967539 -4- Memo R 52.1 - Version 6.08.00 2. Update der Programmversion 2.1 Setup Beachten Sie folgende Hinweise zur Durchführung eines Updates: Zur Installation benötigen Sie Windows-Administratorrechte bzw. zumindest Schreibrechte auf alle von ASYS verwendeten Verzeichnissen. Sofern die Option „Administrator“ aktiviert ist, werden die Verzeichnisse „Admin“ und „AdminClient“ vor der Installation komplett gelöscht. Ansonsten werden bei einem Update immer nur die Dateien ersetzt, zu denen eine aktualisierte Version vorliegt. Bei Update des Kommunikations- und WebService-Server beachten Sie Abschnitt 6. Führen Sie die Installation entsprechend der Anleitung unter http://www.asysnet.de/asyswiki/doku.php?id=adm6:thm:installation durch. Wurde die Option „Mittelschicht“ gewählt, wird im Rahmen der Installation eine Bestätigung gefordert, dass die alte Mittelschicht gelöscht wird. Wir empfehlen dringend, die Frage mit „Ja“ zu beantworten und die alte(n) Mittelschicht(en) damit zu löschen. 2.2 2.2.1 Dateien und Dateianpassungen Transformations- und Schemadateien U.a. zur Umsetzung der Optimierungen ASYS-1009 und ASYS-1633 sowie der Fehlerbehebung ASYS-1897 sind einige aktualisierte Transformationsund Schemadateien Teil dieser Auslieferung. Diese befinden sich nach dem Update im Verzeichnis [ASYS-ROOT]\extern\.... Sofern Sie als ROOT-Pfad für die Transformationsdateien eine anderes als das Standardverzeichnis c:\Asys6\extern nutzen (vgl. Konfigurationsparameter: AsysImExport.root), kopieren Sie die Dateien in das(die) entsprechende(en) Verzeichnis(se). 81967539 -5- Memo R 52.1 - Version 6.08.00 3. Änderung der Datenbank Die erfolgreiche Ausführung von Datenbankskripten und Service-Routinen wird in der Datenbank dokumentiert. Die entsprechende Liste kann über den Menüpunkt Datenbank-> Datenbankaktualisierungen aufgerufen werden 3.1 Datenbankskript UpdateDB_ASYS6_07_00 Zur Umsetzung der Optimierung ASYS-1633 ist ein Datenbank-Update erforderlich. Führen Sie das Datenbankskript „UpdateDB_ASYS6_7_0“ aus. Bei einer Oracle- oder folgendermaßen vor: SQL-Serverdatenbank gehen Sie dabei o Entweder führen Sie das Datenbankskript mit Hilfe des SQLTools entsprechend der Anleitung http://www.asysnet.de/asyswiki/doku.php?id=adm6:thm:install ation, Abschnitt „Vorgehen beim Update“ aus o oder führen Sie das Datenbankskript über das ASYS Admin Datenbank- und Test-Tool aus http://www.asysnet.de/asyswiki/doku.php?id=adm6:chd:execut esql Bei einer MS-Access-Datenbank gehen Sie dabei folgendermaßen vor: o Sofern nicht bereits geschehen installieren Sie das Makro, wie unter http://www.asysnet.de/asyswiki/doku.php?id=adm6:thm:install ation, Abschnitt „Vorgehen beim Update“ beschrieben. o Führen Sie dieses Makro dann bitte aus: In dem Dateidialog ist das SQL-Skript „asys_root\dbscript\access\UpdateDB_ASYS6_7_0.sql“ auszuwählen. 81967539 -6- Memo R 52.1 - Version 6.08.00 4. Anpassung des Repositorys 4.1 Nicht-händische Anpassung des Repositorys 4.1.1 Mergen des Repositorys U.a. zur Umsetzung der Optimierung ASYS-1633 ist ein „Mergen“ des Repositorys vom Stand R 50.1 / Version 6.06.01 auf den Stand R 52.1 / Version 6.08.00 im Rahmen dieser Auslieferung zwingend erforderlich. Die Merge-Skripte sind so angepasst, dass in Ihrem Standort-Repository innerhalb der vorhandenen Skriptmengen, Prüfplänen und Nachrichtenprüfplänen keine Änderungen vorgenommen werden. Neben den Anpassungen der Merge-Skripte wurde hierfür auch ein spezielles Repository erstellt, welches sich bereits in der Datei "RepReceived\sendrep.zip" befindet (bei Installation mit Option „Administrator“). Mergen Sie Ihr Repository entsprechend der Anleitung unter http://www.asysnet.de/asyswiki/doku.php?id=adm6:thm:installation, Abschnitt „Besonderheiten bei einer Update-Installation“, „Mergen des Repositorys“ auf den aktuellen Stand (Repository-Stand: 6.07.00). 4.1.2 Repository-Services 4.1.2.1 Service Nur LEA: Umstellung der Löschund Historisierungsbäume der Stammdaten auf Bäume inkl. der LEATabellen Sofern das Modul LEA eingesetzt wird, muss nach dem Mergen des Repositorys der Service zur Umstellung der Lösch- und Historisierungsbäume der Stammdaten ausgeführt werden. Wenn sie das Modul LEA einsetzen, führen Sie über Extras -> Repository Services -> Kontroll- und Reparaturservices den Service „Nur LEA: Umstellung der Lösch- und Historisierungsbäume der Stammdaten auf Bäume inkl. der LEA-Tabellen“ aus. 4.1.2.2 Allgemeiner Service für die Version 6.07.00 Zur Behebung einiger Programmfehler bzw. zur Umsetzung von Optimierungen sind über einen Service einige Einstellungen im Repository zu korrigieren bzw. zu ändern. Nach Ausführen des Service können Sie über den Menüpunkt Hilfe / Info einsehen, welche Änderungen durch den Service durchgeführt wurden. 81967539 -7- Memo R 52.1 - Version 6.08.00 4.2 4.2.1 Führen Sie über Extras -> Repository Services -> Service für Version 6.07.00 den allgemeinen Service für die Version 6.07.00 aus. Händische Anpassung des Repositorys Überwachung der OSCI-Kommunikation Ab der Version 6.07.00 werden vom Kommunikationsserver JaMon-ReportDaten über die OSCI-Kommunikation gesammelt und als csv-Dateien abgelegt. Der Ablageort für diese csv-Dateien kann im Repository über den Konfigurationseintrag AsysComServerImpl.JaMonReportDir angepasst werden. Standard ist hier das Verzeichnis „user.home\Asys6\JaMonReport“. Der Kommunikationsserver muss in diesem bzw.im von ihnen festgelegten Verzeichnis ‚Schreibrechte‘ besitzen und auch neue Verzeichnisse anlegen dürfen. Die IKA wird Sie regelmäßig um die Übersendung der JaMon-ReportDaten bitten. Zu den Details hierzu erhalten Sie noch gesondert Informationen. Weitere Informationen zu den Report-Dateien finden Sie hier: http://www.asysnet.de/asyswiki/doku.php?id=adm6:thm:kom:kom_jamon_ report. 4.2.2 Falls Sie vom Standardverzeichnis für die Ablage der JaMon-ReportDaten abweichen wollen, tragen Sie unter Allgemeine Konfiguration -> Kommunikation allgemein) im Konfigurationseintrag AsysComServerImpl.JaMonReportDir das von Ihnen gewünschte Verzeichnis ein. Regelmäßiger ‚Select‘ auf die Datenbank Die Optimierung ASYS-1376 wurde umgesetzt. Zur Aktivierung bzw. Anpassung muss im Repository der Konfigurationseintrag AsysComServerImpl.CheckDBTimerIntervall vorgenommen werden. Wenn Sie die Erzeugung eines regelmäßigen ‚Select‘ auf die Datenbank durch den Kommunikationsserver aktivieren wollen, tragen Sie unter Allgemeine Konfiguration -> Kommunikation allgemein im Konfigurationseintrag AsysComServerImpl.CheckDBTimerIntervall das Intervall für die Erzeugung des Select ein. 4.2.3 Vorgangssteuerung Laufzeit bei ENP und SNP – automatisiertes Setzen der Die Optimierung ASYS-1354 wurde umgesetzt. In der mit der Standardkonfiguration bereitgestellten Vorgangsteuerung zum automatisierten Setzen der Laufzeit bei ENP und SNP Nachweisgültigkeit der 81967539 -8- Memo R 52.1 - Version 6.08.00 privilegierten Nachweise wurde diese bisher immer anhand von Angaben aus der VE und AE ermittelt. Sofern dies in Ihrem Bundesland auch weiterhin so bleiben soll, brauchen Sie nichts zu tun. Ansonsten bietet die Standardvorgangssteuerung ab der Version 6.07.00 auch drei weitere Varianten, nach der die Nachweisgültigkeit berechnet werden kann. Falls bei Ihnen der Wunsch nach einer anderen Variante besteht, gehen Sie wie im Anhang beschrieben vor. 81967539 -9- Memo R 52.1 - Version 6.08.00 5. Aktualisierung des Datenbestandes 5.1 Service-Routinen Service-Routinen, die Änderungen im Datenbestand vornehmen, können über den Menüpunkt Datenbank-> Service-Routinen ausgeführt werden. 5.1.1 Service-Routine, die das 70-Zeichenfeld der Bezeichnung der Entsorgungsanlage der Freistellung in zwei Felder aufteilt In der BMU-Schnittstelle hat die Bezeichnung der Entsorgungsanlage der Freistellung 2 Felder mit je 35 Zeichen. In ASYS wurde der Inhalt bisher in einem 70-Zeichenfeld verwaltet. Der Service teilt den Inhalt des 70Zeichenfeldes in die zwei 35-Zeichen-Felder auf. Bis alle Länder auf die ASYS-Version 6.08.00 (6.07.00) umgestellt haben, muss dieser Service regelmäßig ausgeführt werden. Zu diesem Zweck kann der Service auch über einen Batch-Job 'service -fixaefr' aufgerufen werden. Zur Umsetzung der Optimierung ASYS-1633 ist die Ausführung einer Service-Routine notwendig: Führen Sie die Service-Routine „6.07.00 – Freistellung / Teile 70Zeichen-Entsorgungsanlagenfeld der FR in zwei 35-Zeichen-Felder“ entsprechend der Anleitung, die im Feld „Info“ angezeigt wird, aus. 5.2 Katalogupdate Zur Aktualisierung der Kataloge zur Behebung folgender Fehler bzw. zur Durchführung folgender Änderungen ist die Durchführung eines Katalogupdates erforderlich: - ASYS-1723: Der Katalog der ISO-Staatencodes wurde um einen Eintrag ergänzt. - ASYS-1046 und ASYS-1492: Der Katalog zur Anlage der 4. BImSchV wurde um die offiziellen Nummer ohne führende Nullen ergänzt. (Diese Änderungen sind nicht in der Excel-Übersicht aufgeführt, da es sich nicht um fachlich-inhaltliche Änderungen handelt.) Die Ergänzungen wurden bereits mit Auslieferung ASYS R48.1 ausgeliefert, allerdings war die Tabelle in der Update-Datenbank kataloge_mbs.mdb nicht als zu aktualisieren gekennzeichnet. Eine Liste der Änderungen findet sich in der Excel-Datei „Katalogupdates R51.1.xls“ im Verzeichnis Asys6/Kataloge (bei Installation mit Option „Administrator“). 81967539 - 10 - Memo R 52.1 - Version 6.08.00 Übertragen Sie die Änderungen der Katalogdaten mit Hilfe des Repository-Administrators entsprechend der Beschreibung entsprechend der Anleitung unter http://www.asysnet.de/asyswiki/doku.php?id=adm6:chd:katakt in Ihren Datenbestand. 81967539 - 11 - Memo R 52.1 - Version 6.08.00 6. Besondere Hinweise zum Update des AsysServers sofern der Patch R 50.3 vom 17.02.2017 nicht durchgeführt wurde Zur Umsetzung der Optimierung ASYS-1796 wird durch das Setup (Option: Kommunikationsserver oder WebService-Server (vollständig mit eigenem Tomcat)) ein neuer Tomcat sowie ein neues Java-8-JDK (jdk1.8.0_131) installiert. Der bisherige Tomcat (apache-tomcat-8.0.32) sowie das bisherige Java-8-JDK (jdk1.8.0_111) werden durch das Setup automatisch gelöscht. Zum ersten Mal mit diesem Patch und zukünftig für alle Versionen werden sowohl der Tomcat als auch das JDK nur noch in Verzeichnissen installiert, die mit dem Major-Releasenamen versehen sind (statt apache-tomcat-8.0.xx also apache-tomcat-8.0, statt jdk1.8.0_111 also jdk1.8.0). Dies erleichtert die Auslieferung zukünftiger Sicherheitsupdates und bei Ihnen die Installation erheblich. Die vollständigen Versionen der Komponenten stehen in den log-Dateien. Bevor Sie das Setup durchführen sollte folgendes geprüft werden: Wurde der Tomcat als Dienst registriert? Falls Ja: Sollte dies der Fall sein, ist der Dienst über den Batch „Remove AsysServer service.bat“ (vor Ausführung des Setups) zu entfernen. Nach Ausführung des Setups kann der Dienst dann wieder registriert werden („Install AsysServer service.bat“). Eine Anleitung finden dazu finden Sie unter http://www.asysnet.de/asyswiki/doku.php?id=adm6:thm:kom:kom_in stall im Abschnitt „Einrichten des Kommunikationsservers als Dienst“. Haben Sie in der „startup.bat“ Änderungen bzgl. des für Java zur Verfügung stehenden Speichers vorgenommen (Zeile: set CATALINA_OPTS=-Xms1024m -Xmx1024m)? Falls Ja: Nehmen Sie die Änderungen in der neuen „startup.bat“ erneut vor. 81967539 - 12 - Memo R 52.1 - Version 6.08.00 7. Checkliste In der folgenden Checkliste sind alle für ein Update notwendigen durchzuführenden Aufgaben zusammengestellt. Die Angabe „ggf.“ in der Spalte Ausführung heißt, dass der Arbeitsschritt nur unter bestimmten Bedingungen auszuführen ist (dann aber zwingend). s. Abschnitt Aufgabe 6.1 Nur Kommunikationsserver: Deregistrieren des Diensts 2. Update der Programmversion 2.1 Setup 6.1 Nur Kommunikationsserver: Registrieren des Diensts 2.2 Dateien und Dateianpassungen 2.2.1 Transformations- und Schemadateien ggf. 6.2 ggf. 3. Nur Kommunikationsserver: Anpassung des „startup.bat“ bzgl. des für Java zur Verfügung stehenden Speichers Änderung der Datenbank 3.1 Datenbankskript UpdateDB_ASYS6_07_00 4. Anpassung des Repositorys 4.1 Nicht-händische Anpassung des Repositorys 4.1.1 Mergen des Repositorys 4.1.2 Repository-Services 4.1.2.1 4.1.2.2 Umstellung der Lösch- und Historisierungsbäume der Stammdaten auf Bäume inkl. der LEA-Tabellen Allgemeiner Service für die Version 6.07.00 4.2 Händische Anpassung des Repositorys 4.2.1 Auswahl des Ablageortes der JaMon-Report-Daten optional 4.2.2 Regelmäßiger ‚Select‘ auf die Datenbank optional 4.2.3 Vorgangssteuerung optional 5. Aktualisierung des Datenbestandes 5.1 Service-Routinen 5.1.1 Service-Routine zur Aufteilung des 70 Zeichenfeldes bei der Freistellung Katalogupdate 5.2 Ausführung erledigt ggf. zwingend ggf. zwingend zwingend ggf. zwingend zwingend zwingend Sonstiges 1 Information der IKA über Aufnahme des produktiven Betriebs des Kommunikationsservers 81967539 zwingend - 13 - Memo R 52.1 - Version 6.08.00 8. Übersicht Versionsstand nach R 52.1 Programmbestandteil Version / Stand aktualisiert gegenüber R50.1 Benutzeroberfläche 6.07.00 JA Repository-Administrator 6.07.00 JA Admin Datenbank- und Testtool 6.07.00 JA Mittelschicht (für ASYS-Benutzeroberfläche Administrator) 6.08.00 JA Prüfbibliothek 1.7.5 JA SecSigner 5 (Build 170210E5CF1BBF) JA Transformationsund Schemadateien (jüngste Datei aus Verzeichnis acs/extern; ohne Property-Dateien) 08.05.2017 JA Transformationsdateien für die Anzeige im internen Viewer (jüngste Datei aus Verzeichnis Viewer_intern/xslt) 18.10.2016 NEIN AsysServer / Kommunikation 6.08.00 JA AsysServer / Webservice 6.07.00 JA Repository – Mergen / Services Stand R52.1 (R51.1) / 6.07.00 JA Repository - händische Einstellungen Stand R52.1 (R51.1) JA Datenbank / Datenmodell Stand R52.1 (R51.1) JA Datenbestand Stand R52.1 (R51.1) JA Setup-Programm (setupAsys6.XX.00.exe) 6.08.00 JA und Repository- 81967539 - 14 - Memo R 52.1 - Version 6.08.00 9. Anhang: Anpassung der Vorgangssteuerung zur automatisierten Eintrag der behördlichen Gültigkeit eines EN/SN im priv Verfahren Die Nachweisgültigkeit der privilegierten Nachweise wurde bisher anhand von Angaben aus der VE und AE ermittelt. Sofern dies in Ihrem Bundesland auch weiterhin so bleiben soll, brauchen Sie nichts zu tun. Ansonsten bietet die Standardvorgangssteuerung ab der Version 6.08.00 (6.07.00) vier verschiedene Varianten, wie die Nachweisgültigkeit berechnet wird. Um eine dieser Varianten zu verwenden gehen Sie folgendermaßen vor: Downloaden Sie sich die Grundkonfigurationen „Vorgang Standard Automatisiertes Setzen der Laufzeit ENP.zip“ und „Vorgang Standard Automatisiertes Setzen der Laufzeit SNP.zip“ von der Seite http://www.asysnet.de Importieren Sie die Grundkonfigurationen in Ihr Repository. Öffnen Sie die Startskriptmenge(n): o Bei ENP: STD EN privilegiertes Verfahren Skriptgruppe: ENP Kom und keine LZ Skript: IKA STD ENPKomUndKeineLZ Wählen Sie den für Ihr Bundesland passenden Arbeitsschritt aus: „Automatisiertes Setzen der Laufzeit ENP anhand…“ o Bei SNP: STD SN privilegiertes Verfahren Skriptgruppe: SNP Kom und keine LZ Skript: IKA STD SNPKomUndKeineLZ Wählen Sie den für Ihr Bundesland passenden Arbeitsschritt aus: „Automatisiertes Setzen der Laufzeit SNP anhand…“ 81967539 - 15 -
