IFAS NiSV-Service Berlin

 Zurück

Installation

Enpacken des Archivs nach c:/Kisters. Die Installation befindet sich dann im Untervezeichnis c:/Kisters/ifas-jobs-nisv.

Nach dem Entpacken ist in der Datei ndat.dft der Wert für DATABASE_CONNECT anzupassen.

Vorbereitende Arbeiten in der Datenbank

Der Eintrag für NiSV-Anzeigen in Katalog FMS_TYP [972] muss in der Spalte FMS-Typ zwingend den Wert nisv aufweisen.

Im Katalog FMS_POSTEINGANG [974] ist in der Spalte Post-MaNr die manr des Mitarbeiters einzutragen, der die Post erhalten soll.

Konfigurationsparameter für den Job setzen

Damit die NiSV-Anzeigen beim XTA-Webservice abgeholt werden können, sind diverse Konfigurationseinstellungen anzupassen. Diese können der Einfachheit halber alle in der standard.cnf im bin-Verzeichnis des NiSV-Jobs gemacht werden.

TRUSTSTORE_FILENAME

Hier ist der Schlüsselspeicher mit den Zertifikaten zur Prüfung der HTTPS Verbindung anzugeben. Der Eintrag für den Beispiel-Schlüsselspeicher lautet TRUSTSTORE_FILENAME=nisv-truststore-conf.jks

TRUSTSTORE_PASSWORD

Der Eintrag für den Beispiel-Schlüsselspeicher ist TRUSTSTORE_PASSWORD=X-+':;*04

Das Passwort wird in verschlüsselter Form erwartet. Die Verschlüsselung wird über das Programm crypt durchgeführt.

KEYSTORE_FILENAME

Für die Verbindung zum XTA-Webservice ist ein Zertifikat erforderlich. Dieses Zertifikat wird in einem Schlüsselspeicher hinterlegt und dem NiSV-Job über KEYSTORE_FILENAME zur Verfügung gestellt. KEYSTORE_FILENAME enthält den Dateinnamen der Schlüsselspeichers.

Der Eintrag für den Beispiel-Schlüsselspeicher ist KEYSTORE_FILENAME=nisv-keystore-conf.jks.

Das Passwort für den Schlüsselspeicher und das Zertifikat für die Anmeldung werden in der Datenbank hinterlegt. Die Einträge können über die Passwortverwaltung im Modul Adminstration bearbeitet werden (Verwaltung/Pflege von Passworten). Die zugehörigen Einträge sind XTA2 (Privater Schlüssel Zertifikat) und XTA2 (Schlüsselspeicher)

DBNAME

DBNAME ist in der standard.cnf zu setzen, um den Namen der zu verwendenden Sektion in der ndat.dft anzugeben. Für die Anmeldung an der Datenbank sind UID und PWD anzugeben. Alternativ kann für den Microsoft SQL-Server in DATABASE_CONNECT ;integratedSecurity=true; gesetzt werden, um die integrierte SQL-Server-Anmeldung zu verwenden. Das Programm muss dann mit dem entsprechenden Windows-Benutzer gestartet werden. Die in der Datenbank erforderliche Rechte für den Datenbankbenutzer lauten: db_datareader, db_datawriter, db_ddladmin

NISV_XTA_ACCOUNT

Für die Anmeldung beim Service muss der entsprechende Account angegeben werden. Der Eintrag für die Testumgebung lautet NISV_XTA_ACCOUNT=gcg_lagetsi_nisv_dev_xta.

NISV_MAX_ITEMS

Über den Parameter NISV_MAX_ITEMS kann die Anzahl, der in einem Durchlauf zu holenden Elemente begrenzt werden. Für erste, schnelle Tests kann z.B. NISV_MAX_ITEMS=2 verwendet werden.

Test-Betrieb

Um die Konfiguration zu testen, kann der NiSV-Job über die Batch-Datei ifas-jobs-nisv.cmd im bin Verzeichnis gestartet werden.

Der NiSV-Job wird dann als der aktuell angemeldete Benutzer ausgeführt.

Service installieren

Für den dauerhaften Betrieb sollte der Job als Windows-Dienst installiert werden. In einer Eingabeaufforderung mit erhöhten Rechten in das Verzeichnis c:/Kisters/ifas-jobs-nisv/bin wechseln. Dort das Kommando zur Installation ausführen: ifas-jobs-nisv.exe install Um den Service zu starten ifas-jobs-nisv.exe start ausführen.

Nach der Installation als Service, kann der Dienst über die Windows-Diensteverwaltung gesteuert werden. Der Name des Dienstes ist ifas-jobs-nisv.

Benutzer für den Dienst anpassen

Soll die integrierte Datenbankanmeldung verwendet werden oder ist der Zugriff auf Netzlaufwerke erforderlich, muss der Dienst unter einem entsprechenden Domänen-Benutzer ausgeführt werden. Der Benutzer kann in ifas-jobs-nisv.xml im Abschnitt serviceaccount konfiguriert werden. Der Eintrag bei password ist nur zur Installation erforderlich und kann anschließend entfernt werden. Ein Beispiel zur Konfiguration ist auskommentiert in der ifas-jobs-nisv.xml enthalten.

Ausführung des Jobs konfigurieren

Die Planung der Ausführungszeiten des NiSV-Jobs erfolgt über den Katalog IFAS_JOBS [966]. Bei Job Name ist NisvJob anzugeben. Die restlichen Einträge entsprechend der gewünschten Ausführungszeit. 0 bei Sekunden und 0/10 bei Minuten lässt den Job alle 10 Minuten ausführen. 0 bei Sekunden und Minuten und 22 bei Stunden lässt den Job einmal täglich um 22:00 ausführen.

Update des Service

Zum Update des Service die folgenden Schritte durchführen:

Zurück