./as2

Enthält MDN-Dateien der gesendeten und empfangenen AS2-Nachrichten.

./asm

Enthält Dateien für das Asynchrone-Sende-Modul (ASM).

./backup

In diesem Verzeichnis werden bei einem Versionsupdate oder Patch die in dem Vorgang angefassten Dateien vorab in einer .zip-Datei gesichert.

./bin

Hier befinden sich alle Startprogramme für das Ausführen des Integration Servers und damit verbundenen Rahmenapplikationen, die zum Teil bereits im Abschnitt Allgemeines zur Konfiguration beschrieben wurden. Prinzipiell kann hier zwischen zwei Arten von Skripten unterschieden werden.

• Skripte für den Betrieb unter Windows. Diese erkennt man anhand der Dateiendung .bat.

• Skripte für den Betrieb unter Unix-artigen Systemen. Diese erkennt man an der Dateiendung .sh.

Damit diese Skripte ausgeführt werden können, ist das Vorhandensein der Standardshell /bin/sh notwendig. Das Unterverzeichnis shared mit allen darin befindlichen Dateien und die Dateien starter.jar, wrapper.jar und wrapper.exe werden für den Betrieb als Windows Service benötigt und sollten nicht ohne explizite Aufforderung vonseiten Lobster verändert oder entfernt werden.

./conf

Konfigurationsdateien, die nicht zum Standardumfang des Integration Servers gehören, sollten in diesem Verzeichnis abgelegt werden, damit das Gesamtsystem releasefähig bleibt und keine Probleme entstehen, wenn in dem Standardkonfigurationsverzeichnis neue Dateien entstehen, deren Namen mit einer projektspezifischen Datei kollidiert.

Direkt nach Installation des Integration Servers befinden sich bereits eine Reihe von Dateien in dem Verzeichnis, die an eigene Bedürfnisse angepasst, bzw. als Beispiel für neue Konfigurationsdateien heranziehbar sind.

./datawizard

Unterhalb dieses Verzeichnisses befinden sich Template- und andere Dateien, die zur Laufzeit von Lobster Integration verwendet werden.

./dmz

Enthält Event-Dateien, wenn auch ein Lobster-DMZ-Server installiert ist.

./etc

Angelehnt an das etc-Verzeichnis von Unix-Systemen, befindet sich in diesem Verzeichnis alles zur Konfiguration notwendige. Direkt im Verzeichnis sind dies vor allem die XML-basierten Konfigurationsdateien der einzelnen Services des Integration Servers, bzw. Zusatzdateien, wie die Benutzerdefinitionen der Kommunikationsdienste. Üblicherweise gibt es vier Unterverzeichnisse von ./etc.

./ext

Dieses Verzeichnis ist vorgesehen für das Ablegen eigener Klassen, die für den Integration Server erreichbar, d. h. auffindbar sein sollen. Verwendung findet dies beispielsweise bei der Ausführung von Klassen über die Tools der Admin-Konsole.

Der Vorteil des ext-Verzeichnisses ist, dass neue Klassen auch dann gefunden werden, wenn der Server nicht neu gestartet wurde. Der Austausch einmal geladener Klassen erfordert aber weiterhin einen Neustart des Servers, damit die Änderung auch ihren Weg in die Virtual Machine findet.

Achtung: .jar-Dateien werden in diesem Verzeichnis ignoriert, hierfür existiert das Verzeichnis ./extlib.

./extlib

Dieses Verzeichnis ist vorgesehen für das Ablegen eigener Bibliotheken, die für den Integration Server erreichbar, d. h. auffindbar sein sollen.

Achtung: Das extlib-Verzeichnis hat beim Ermitteln von Klassen eine höhere Priorität als das Standard-lib-Verzeichnis. Werden Bibliotheken eingespielt, die ebenfalls vom Integration Server selbst verwendet werden, sind bei einer Verwendung von anderen Versionen Probleme möglich, die nicht sofort auf diese Tatsache zurückgeführt werden können. Vor dem Einspielen eigener Bibliotheken sollte daher zuvor immer überprüft werden, ob eine gleichartige Bibliothek nicht schon vorhanden ist, die mitverwendet werden kann. Beachten Sie bitte, dass Sie selbst für die Pflege dieses Verzeichnisses verantwortlich sind.

./index

Ist der FileSearchService aktiviert, ist dieses Verzeichnis das Basisverzeichnis für das Ablegen von Indexdateien. Bei deaktiviertem Service oder direkt nach der Installation ist das Verzeichnis normalerweise leer.

./lib

In diesem Verzeichnis befinden sich alle für den Basisbetrieb des Integration Servers notwendigen Bibliotheken. Dieses Verzeichnis sollte vom Benutzer unberührt gelassen werden, d. h. eigene Dateien sollten hier nicht abgelegt werden.

./logs

Eines der für den laufenden Betrieb wichtigsten Verzeichnisse. Direkt nach der Installation ist dieses zwar leer, einzelne Bereiche des Servers erzeugen aber im Laufe der Zeit Unterverzeichnisse, in denen eine Reihe von Logdateien angelegt werden.

Für weitere Informationen hierzu sei auf die Beschreibung des LogServices verwiesen.

Neben Logdaten werden darüber hinaus weitere Daten anderer Services in diesem Verzeichnis abgelegt. Hier sei nur eine kurze Übersicht gegeben, eine genaue Beschreibung der Funktionalität kann beim jeweiligen Service in dieser Dokumentation gefunden werden.

./patch

Wird von Lobster ein Hotfix geliefert, wird dieser üblicherweise in dieses Verzeichnis entpackt. Der Integration Server leert dieses Verzeichnis im Rahmen eines dann später stattfindenden Updates, sodass Versionsinkompatibilitäten vermieden werden. Details finden Sie auf der entsprechenden Download-Seite für Patches im Kundenbereich beschrieben.

Achtung: Werden eigene Dateien in diesem Verzeichnis abgelegt, werden auch diese im Rahmen eines Updates gelöscht, unabhängig davon, ob diese im Update enthalten sind oder nicht. Dieses Verzeichnis sollte daher auf keinen Fall für einen anderen Zweck als beschrieben verwendet werden.

./tmpIO

Auslagerungsort für Java, zum Beispiel für verschiedene Client-Jetty-Dateien.

./training

Dieses Verzeichnis enthält ein Demo-Profil mit Testdaten.

./transfer

Default Root Home der User für FTP, OFTP und SSH.

./webapps

Dieses Verzeichnis dient zur Aufnahme von Webapplikationen. Weitere Webapplikationen können hier hinzugefügt werden, wie z. B. Axis.

Direkt nach der Installation befinden sich dort die folgenden Unterverzeichnisse.

Wichtiger Hinweis: Bei Neuinstallationen (nicht Updates) ab Version 4.6.9 siehe auch ./etc/admin/webapps.

Permanentes Setzen in Dateien

Die allgemeine Syntax für System-Properties beim Start des Integration Servers und damit von Lobster Integration, ist die folgende.

System-Properties werden in den folgenden Konfigurations-Dateien gesetzt.

• ./bin/hub.bat (Integration Server wird mit Windows-Batchdatei gestartet).

• ./etc/wrapper.conf (Integration Server läuft als Windows-Service) (meistens der Fall).

• ./bin/execute.sh (unter Linux/Unix).

Vorübergehendes Setzen in der Admin-Konsole

Alternativ können System-Properties auch in der Admin-Konsole gesetzt werden.

Auch hier tragen Sie den Namen und den Wert der Property ein. Das -D am Anfang entfällt hier!

Änderungen können hier auch während der Laufzeit gesetzt werden. Achtung: Die Änderungen gehen nach einem Neustart verloren!

HTTP-Proxy

FTP-Proxy

SOCKS-Proxy

Leider erlaubt die Standard-Implementierung in der Java Virtual Machine keine Ausnahmen für SOCKS-Proxies. Wir haben deshalb, durch die Lobster-Implementierung von Authenticator und ProxySelector, eine Möglichkeit geschaffen, solche Ausnahmen für alle drei Proxy-Arten in der Konfigurationsdatei ./etc/exclude_proxy.properties zu definieren. Hier wird die IP-Adresse oder der DNS-Hostname für Computer erwartet, zu denen die Verbindung direkt erfolgen soll, also ohne Proxy. Pro Zeile wird eine Ausnahme erwartet. Der Platzhalter * ist zulässig.

Wenn die gesamte Datei nicht existiert, werden per Default die Adressen 127.0.0.1 (Loopback-Adresse) und 0.0.0.0 (alle lokalen Adressen dieser Maschine) und der Name localhost (Name für Loopback) angenommen.