Klasse "CommunicationForwardManager"
Die Klasse com.ebd.hub.datawizard.app.CommunicationForwardManager ist für den Nachrichtenaustausch mit dem inneren Integration Server zuständig.
Der DMZ-Server muss wissen, wie er den inneren Integration Server benachrichtigen kann. Diese Einstellung wird in der Konfigurationsdatei ./etc/startup dmz.xml vorgenommen. Die Applikation CommunicationForwardManager muss aktiviert werden und die beiden Argumente für den Zielrechner und die Portnummer des Zielrechners müssen angepasst sein.
Das folgende Listing zeigt den Eintrag in der Konfigurationsdatei ./etc/startup_dmz.xml des DMZ Servers, mit dem der CommunicationForwardManager gestartet wird.
<
Call
name
=
"addApplication"
>
<
Arg
>
<
New
class
=
"com.ebd.hub.datawizard.app.CommunicationForwardManager"
>
...
<
Call
name
=
"setForwardHost"
>
<
Arg
>
<
New
class
=
"com.ebd.hub.services.message.Target"
>
<
Arg
>innerhost</
Arg
>
<
Arg
type
=
"int"
>8020</
Arg
>
</
New
>
</
Arg
>
</
Call
>
...
</
New
>
</
Arg
>
</
Call
>
Parameter
Zusammenfassend werden in der folgenden Tabelle alle Parameter des CommunicationForwardManagers und ihre Bedeutung beschrieben. Im ausgelieferten Standard des DMZ-Servers sind diese alle in der Konfigurationsdatei ./etc/startup_dmz.xml vorhanden (eventuell auskommentiert). Soweit möglich, sind dort sinnvolle Default-Werte hinterlegt.
Parameter |
Funktion |
Erlaubte Werte |
setForwardHost |
Adresse des inneren Integration Serves und Port-Nummer des MessageServices. |
IP oder Hostname und Port. Default: 8020 |
handleEmptyFiles |
Behandlung von leeren Dateien (0 Bytes). |
0=skip, 2=transfer, 1=delete. Default: 0 |
isdnNumber |
Nur für ISDN-OFTP. |
Telefonnummer. |
keepMessages |
Vorhaltezeit in Minuten, wie lange nicht zugestellte Nachrichten aufgehoben werden (siehe auch backupDir). |
Default: 120 |
backupDir |
Verzeichnis, in dem die versendeten Dateien als Backup vorgehalten werden. Ein leerer Pfad oder backupDir < 1 deaktiviert Backup. |
Default: Kein Backup. |
noForwardRulesForFtp |
Pfad zur Property-Datei, die definiert, für welche FTP-/SSH-/OFTP-User keine Weiterleitung erfolgen soll. |
Default: ./etc/admin/datawizard/ftp_user_rules.properties |
traceOftp |
true erzeugt eine Trace-Datei bei OFTP-Empfang. |
true|false. Default: false |
otherDMZ |
Siehe Abschnitt DMZ-Verbund. |
|
retryInterval |
Angabe in Sekunden, die gewartet wird, bis der nächste Versuch erfolgt. Siehe auch retryNumber. |
1-n. Default: 30 |
retryNumber |
Definiert die Anzahl der Versuche, wenn man Nachrichten vom inneren Integration Server via DMZ-Server versenden will. |
1-n. Default: 3 |
keystorePassword |
Leer oder Passwort für Keystore. Falls eigene Zertifikate verwendet werden, wird das Passwort für den Keystore benötigt. |
Passwort, evtl. verschlüsselt. Durch Einsatz des AuthenticationServices nicht mehr notwendig. |
serverName |
Sollen die Servlets nicht auf dem Standard-Server Main Server installiert werden, muss hier der gewünschte innere HTTP-Server eingetragen werden. |
Default: Main Server |
servletContext |
Falls ein anderer Pfad verwendet werden soll, bitte hier die URI einstellen. Siehe Abschnitt Weiterleitung von HTTP(S)-Anfragen nach innen. |
Default: /forward |
servletPath |
Filter, d. h. alle Anfragen an servletContext werden ggf. gefiltert. |
Default: /* (d. h. kein Filtern) |
addStandardServlets |
Bei true werden Weiterleitungen für Trigger, Request und AS2 an den inneren Integration Server eingerichtet. Siehe Abschnitt Weiterleitung von HTTP(S)-Anfragen nach innen. |
true|false. Default: false |
streamingSize |
Angabe in MB, ab wann der Payload einer Nachricht nicht mehr in der Nachricht weitergereicht wird und der innere Integration Server den Payload über FTP oder SFTP vom DMZ-Server abholt. |
0-n. Default: 10 |
maxSize |
Angabe in kB. Bestimmt die maximale Größe des Payloads, der nicht mehr weiter gereicht wird. Wert 0 bedeutet kein Limit. |
0-n. Default: 0 |
handleAS2 |
Bei true wird der lokale AS2-Service verwendet. Bei false werden AS2-Mitteilungen weitergereicht. Siehe Abschnitt AS2. |
true|false. Default: false |
usePersistentMessageForAS2 |
Bei true werden nicht erfolgreich weitergeleitete AS2-Mitteilungen mit einer MDN quittiert und zu einem späteren Zeitpunkt an den inneren Integration Server weitergereicht. Bei false wird eine NDN gesendet. |
true|false. Default: false |
retainFiles |
Angabe in Tagen, wie lange Backups vorhalten werden. Bei 0 wird kein Backup erzeugt. |
0-n. Default: 0 |
checkInnerIS |
Wenn aktiviert, wird alle n Minuten geprüft, ob der innere Integration Server reagiert. Falls nicht, wird eine E-Mail an die angegebene Adresse gesendet. |
true|false. Default: Nicht aktiv (auskommentiert). |
forwardUnknownFiles |
Kann kein Profil ermittelt werden, kann mit false die Weiterleitung von Dateien unterbunden werden. |
true|false. Default: true |
stopServices |
Bei true werden die Kommunikations-Services vorher beendet, wenn der Integration Server stoppt. Nicht mehr notwendig, wenn die Datei ./etc/factory.xml korrekt angelegt ist. |
true|false. Default: true |
tunnelHttp |
Es ist möglich HTTP(S)-Anfragen über den MessageService zu tunneln . Die Konfigurationsdatei ./etc/forward.properties muss auch in diesem Fall angepasst werden. Parameter handleAS2 muss auf true gesetzt sein. |
true|false. Default: false |
virusScanner |
Siehe Abschnitt Phase 1 (→ Virenscanner). |
Siehe Abschnitt "Phase 1" (→ Virenscanner) . |
forceSSL |
Bei true werden nur HTTPS-Verbindungen akzeptiert. |
true|false. Default: false |
ignoreNewPeerSignal |
Wenn Integration-Server-Instanzen dieselbe öffentliche IP-Adresse haben können (durch einen IP-Loadbalancer), setzen Sie diese Option auf true. |
true|false. Default: false |
recipientReplacementFile |
Wenn SMTP verwendet wird, können Sie die Empfängeradressen durch eine Property-Datei ersetzen (Alte_Adresse=Neue_Adresse) |
Beispiel: ./etc/smtp_recipient_replace.properties |
addAllowedEndpoint |
Gibt die IP eines inneren Integration Servers an, der HTTP-Forwarding ("Via DMZ") über den DMZ-Server auslösen darf. Sobald es einen solchen Eintrag gibt, sind alle anderen IPs gesperrt. Mehrere Einträge können erzeugt werden, indem ein weitere Blöcke dieser Art eingefügt werden. |
|