Import-API Installation

Inhaltsverzeichnis

• 1 Installation der Import-API
• 1.1 Die dataexchange.properties Datei

Die IDL Konsis Import-API ist eine ZIP-Datei (import-api-bundle.zip) mit folgender Struktur:

Verzeichnisse:

docs

Dockumentation der API im JavaDoc-Format

Optional_Libs_4_WebserviceClient

Extra Jars, die für den integrierten Webservice-Client verwendet werden.

Diese beiden Verzeichnisse werden für den Import-API Betrieb nicht benötigt.

Jar Dateien und configuartions Dateien:

Jar-Dateien

Die API Library Jars. Diese werden vom Import-(Kunden)-Programm verwendet.

dataexchange.properties

Diese Datei konfiguriert die Import-API: Die Verbindungen zum AppServer (neu/oder alt), Debug (an/oder aus) und DB-Debug (an/oder aus)

log4j.properties

Diese Datei konfiguriert die Datei in der der Logoutput landen soll oder ob es auf stdout geschrieben werden soll.

Für die Aktualisierung müssen nur die neueren JAR-Dateien über die Älteren kopiert werden.

Es ist darauf zu achten, die Services, die die Import-API verwendenen und diese im Zugriff haben vorher zu stoppen.

Die im Betrieb befindlichen Datein dataexchange.properties und log4j.properties sollten Sie sichern und Versionieren.

Die Datei dataexchange.properties und log4j.properties sind im gleichen Verzeichnis in dem auch die Import-API jars zu finden sind.

Die mitgelieferten dataexchange.properties und log4j.properties Dateien werden nur für eine Neuinstallation der Import-API verwendet.

Zum Bearbeiten unter Windows sollte WordPad verwendet werden da NotePad nicht mit den Zeilenumbrüchen umgehen kann.

Nachfolgend die mitgelieferte Datei:

# debug logging for the importing objects
debug=false
# debug logging for the database interface
dbdebug=false
# the logpath where the database interface log should be place into
# if it is empy the log is place into the "load" dir of the server
# or into the path whre the api is running
logpath=
# ACUDSS_LOG_TARGET can be either FILE or STDOUT
ACUDSS_LOG_TARGET=FILE
# ACUDSS_LOG_AUTOFLUSH yes turns AUTOFLUSH on no off
ACUDSS_LOG_AUTOFLUSH=yes
# ACUDSS_LOG_MODULE describes what should be logged
ACUDSS_LOG_MODULE=FUNCTIONS+STATEMENT+KEYS+ERROR

# this settings overrides the connection pool given to the ProxyFactory or individual settings
# if useconnectionsettings set to true
# for the client webservices testing set useconnectionsettings to "false"
# otherwise the testing client settings will be overridden by the below settings
useconnectionsettings=false
serverName=kronos
serverPort=4747
# serviceMode 1 = old; 2 = new
serviceMode=2

In älteren Versionen als 070 ist in der zweiten Zeile der Parameter "debug" auf "true" gestellt.

Es sollte auf "debug=false" gestellt werden um zu verhindern, das zu viel unnötige logging Info in die Datei dataexchange.log geschieben wird.

Der Parameter "dbdebug=false" schaltet mit dem Wert "true" das Daten-Bank-Logging ein und ist zur Fehlersuche nach Bedarf einzuschalten. Dazu muß dann auch noch für den Parameter logpath= eine Datei angegeben werden. Als PATH-Trenner werden "\" verwendet.

Der Name "kronos" vom Parameter "serverName=kronos" muß auf der verwendeten Server-Namen gestellt werden.

Der Port "4747" im Parameter "serverPort=4747" wird ab der Version 070 verwendet. Vor der Vertsion 070 ist es "4242"

Der Mode "2" im Parameter "serviceMode=2" wird ab der Version 070 verwendet. Vor der Version 070 ist es "1"

Diese Datei kann zu Laufzeit verändert werden. Die Veränderungen werden bei jeder neuen Importanfrage übernommen.