4.1 Nicht-händische Anpassung des Repositorys

Memo R 51.1 - Version 6.07.00
An:
ASYS - Administratoren
Von:
Stephan Meyer, Sören Gehrke
Thema:
Auslieferung R51.1 / ASYS Version 6.07.00
Datum:
13.04.2017
Inhalt
1. Allgemeines .................................................................................... 3
2. Update der Programmversion ........................................................... 4
2.1
Setup ................................................................................... 4
2.2
Dateien und Dateianpassungen ................................................ 4
2.2.1
Transformations- und Schemadateien .................................... 4
3. Änderung der Datenbank ................................................................. 5
3.1
Datenbankskript UpdateDB_ASYS6_07_00 ................................ 5
4. Anpassung des Repositorys .............................................................. 6
4.1
Nicht-händische Anpassung des Repositorys .............................. 6
4.1.1
Mergen des Repositorys........................................................ 6
4.1.2
Repository-Services ............................................................. 6
4.1.2.1 Service
Nur
LEA:
Umstellung
der
Löschund
Historisierungsbäume der Stammdaten auf Bäume inkl. der LEATabellen 6
4.1.2.2 Allgemeiner Service für die Version 6.07.00......................... 6
4.2
Händische Anpassung des Repositorys ...................................... 7
4.2.1
Auswahl des Ablageortes der JaMon-Report-Daten ................... 7
4.2.2
Regelmäßiger ‚Select‘ auf die Datenbank ................................ 7
4.2.3
Vorgangssteuerung – automatisiertes Setzen der Laufzeit bei
ENP und SNP .................................................................................. 7
5. Aktualisierung des Datenbestandes ................................................... 9
5.1
Service-Routinen ................................................................... 9
5.1.1
Service-Routine, die das 70-Zeichenfeld der Bezeichnung der
Entsorgungsanlage der Freistellung in zwei Felder aufteilt .................... 9
5.2
Katalogupdate ....................................................................... 9
6. Besondere Hinweise zum Update des AsysServers .............................. 10
6.1
Neuregistrierung als Dienst ....................................................10
6.2
Anpassung der „startup.bat“ ..................................................10
81936300
-1-
Memo R 51.1 - Version 6.07.00
7. Checkliste ..................................................................................... 11
8. Übersicht Versionsstand nach R 51.1 ................................................ 12
9. Anhang: Anpassung der Vorgangssteuerung zur automatisierten Eintrag
der behördlichen Gültigkeit eines EN/SN im priv Verfahren....................... 13
81936300
-2-
Memo R 51.1 - Version 6.07.00
1. Allgemeines
Vorbemerkung: Wir empfehlen, dieses Dokument auszudrucken und vor
dem Beginn der Aktualisierung auf die Auslieferung R51.1 / ASYS Version
6.07.00 einmal komplett durchzulesen.
Dieses Dokument beschreibt die für einen Umstieg von der Auslieferung
R50.1 / Version 6.06.01 auf die Auslieferung R51.1 / Version 6.07.00
notwendigen Schritte.
Die Auslieferung R51.1 / Version 6.07.00 enthält Fehlerbehebungen und
Optimierungen in allen ASYS-Komponenten. Welche Fehler behoben und
welche Optimierungen umgesetzt worden sind, entnehmen Sie bitte dem
JIRA-Meldungssystem. Für die Anzeige der behobenen Meldungen steht
Ihnen in JIRA unter Vorgänge – Filter – Filter verwalten – Suche der Filter
„R51.1 / Version 6.07.00 – geschlossene Meldungen“ zur Verfügung.
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.
Mit der Auslieferung R51.1 wird ein neuer Kommunikationsserver (Version
6.07.00) ausgeliefert, der ASYS zum Empfang von mit Hilfe der neu
entwickelten Webanwendung erstellten elektronischen Mengenmeldungen
ertüchtigt (ASYS-1008 und ASYS-1009).
Bitte teilen Sie der IKA über die E-Mail-Adresse [email protected]
mit, wenn Sie den ASYS-Kommunikationsserver im produktiven
Betrieb auf die Auslieferung R51.1 / Version 6.07 umgestellt haben.
Erst nach erfolgter Inbetriebnahme des neuen Kommunikationsservers
(Version 6.07.00) werden wir die Nutzer der neu entwickelten
Webanwendung für den Versand von Mengenmeldungen von der
Webanwendung an Ihre Knotenstelle freischalten. Dies Freischaltungen
werden voraussichtlich sukzessive im 2. Quartal 2017 erfolgen.
81936300
-3-
Memo R 51.1 - Version 6.07.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.
Ist die die Option „Mittelschicht“ aktiv, 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 sind
einige aktualisierte Transformations- und Schemadateien Teil dieser
Auslieferung. Diese befinden sich nach dem Update im Verzeichnis [ASYSROOT]\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).
81936300
-4-
Memo R 51.1 - Version 6.07.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 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 Führen Sie die das Update-Makro aus
http://www.asysnet.de/asyswiki/doku.php?id=adm6:thm:install
ation, Abschnitt „Vorgehen beim Update“, „Access“
In
dem
Dateidialog
ist
das
SQL-Skript
„asys_root\dbscript\access\UpdateDB_ASYS6_7_0.sql“
auszuwählen.
81936300
-5-
Memo R 51.1 - Version 6.07.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 51.1 /
Version 6.07.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.
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.
81936300
-6-
Memo R 51.1 - Version 6.07.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
Auswahl des Ablageortes der JaMon-Report-Daten
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
81936300
-7-
Memo R 51.1 - Version 6.07.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.
81936300
-8-
Memo R 51.1 - Version 6.07.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. Im Rahmen der Umsetzung der
Optimierung ASYS-1633 wurden auch zwei getrennte Felder vorgesehen, der
Service teilt den Inhalt des 70-Zeichenfeldes in die zwei 35-Zeichen-Felder
auf. Bis alle Länder auf die ASYS-Version 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.
 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-1855: Der Katalog zur Anlage der 4. BImSchV wurde
aktualisiert.
- ASYS-1861: Im Katalog der ISO-Staatencodes wurde ein Eintrag
geändert.
- ASYS-1862: Der Gemeinde- und der PLZ-Katalog wurden aktualisiert.
Diese sehr umfangreiche Aktualisierung kann einige Zeit in Anspruch
nehmen.
Eine Liste der Änderungen findet sich in der Excel-Datei „Katalogupdates
R51.1.xls“ im Verzeichnis Asys6/Kataloge (bei Installation mit Option
„Administrator“).

Übertragen Sie die Änderungen der Katalogdaten mit Hilfe des
Repository-Administrators entsprechend der Beschreibung unter
http://www.asysnet.de/asyswiki/doku.php?id=adm6:chd:katakt in
Ihren Datenbestand.
81936300
-9-
Memo R 51.1 - Version 6.07.00
6. Besondere Hinweise zum Update des AsysServers
Die folgenden Hinweise sind nur zu beachten, 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_123)
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:
6.1

Neuregistrierung als Dienst
Wurde der Patch R 50.3 vom 17.02.2017 nicht durchgeführt und
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“.
6.2

Anpassung der „startup.bat“
Wurde der Patch R 50.3 vom 17.02.2017 nicht durchgeführt und
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.
81936300
- 10 -
Memo R 51.1 - Version 6.07.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 Dienst
2.
Update der Programmversion
2.1
Setup
6.1
Nur Kommunikationsserver: Registrieren des Dienst
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
zwingend
4.1.2
Repository-Service
zwingend
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
ggf.
zwingend
zwingend
zwingend
Sonstiges
6
Information der IKA über Aufnahme des produktiven
Betriebs des Kommunikationsservers
81936300
zwingend
- 11 -
Memo R 51.1 - Version 6.07.00
8. Übersicht Versionsstand nach R 51.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.07.00
JA
Prüfbibliothek
1.7.2
JA
SecSigner
5
(Build
170210E5CF1BB7)
JA
Transformationsund
Schemadateien
(jüngste
Datei
aus
Verzeichnis
acs/extern;
ohne Property-Dateien)
03.04.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.07.00
JA
AsysServer / Webservice
6.07.00
JA
Repository – Mergen / Services
Stand
6.07.00
Repository - händische Einstellungen
Stand R 51.1
JA
Datenbank / Datenmodell
Stand R 51.1
JA
Datenbestand
R51.1
JA
Setup-Programm (setupAsys6.XX.00.exe)
6.07.00
JA
und
Repository-
81936300
R51.1
/
JA
- 12 -
Memo R 51.1 - Version 6.07.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.07.00
vier verschiedene Varianten, wie die Nachweisgültigkeit berechnet wird.
Um eine dieser Varianten zu verwenden gehen Sie folgendermaßen vor:

Downloaden Sie die Datei „R51.1 Vorgang Standard Automatisiertes
Setzen der Laufzeit.zip“ mit den 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. (Die Datei ist auch in den zip-Containern
"R_51_1_ASYS-Auslieferung…" enthalten.)

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…“
81936300
- 13 -