Class "CommunicationForwardManager‌"

The class "com.ebd.hub.datawizard.app.CommunicationForwardManager" is the central application that is responsible for the exchange of messages with the inner Integration Server.

The DMZ server needs to know how to notify the inner Integration Server. This setting is maintained in the configuration file ./etc/startup_dmz.xml.

The application CommunicationForwardManager needs to be activated and both arguments for the inner host and its port number need to be set.

The following listing shows the entry in configuration file ./etc/startup_dmz.xml of the DMZ server that starts the CommunicationForwardManager.


<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>

Parameters


In summary, all parameters of the CommunicationForwardManager and their meaning are described in the following table. In the default installation of the DMZ server, all of these are contained in the configuration file ./etc/startup_dmz.xml (possibly commented out). As far as possible, meaningful default values are used there.


Parameter

Function

Allowed Values [Default]

setForwardHost

Address of inner Integration Server and port number of the MessageService.

IP or host name and port. Default: 8020

handleEmptyFiles

Handling of empty files (0 bytes).

0=skip, 2=transfer,1=delete. Default: 0

isdnNumber

Only for OFTP via ISDN.

Telephone number.

keepMessages

Retention time in minutes, of how long undelivered messages are kept (see also backupDir).

Default: 120

backupDir

Directory that stores backups of sent files. An empty path or keepMessages < 1 deactivates backup.

Default: No Backup.

noForwardRulesForFtp

Path to property file that defines for which FTP/SSH/OFTP users no forwarding should take place.

Default: ./etc/admin/datawizard/ftp_user_rules.properties


traceOftp

true creates a trace file on OFTP reception.

true|false. Default: false

otherDMZ

See section DMZ cluster.


retryInterval

Number of seconds to wait before a retry. See also parameter retryNumber.

1-n. Default: 30

retryNumber

Defines the number of tries if the inner Integration Server sends data via the DMZ server.

1-n. Default: 3

keystorePassword

Empty or password for keystore. If local certificates are used, the password for the keystore is needed.

Password, possibly encrypted. No longer necessary due to the use of the AuthenticationService.

serverName

If servlets are not being installed on the standard server Main Server, the desired HTTP server needs to be set here.

Default: Main Server

servletContext

If a different path should be used, please enter the URI here. See section Forwarding HTTP requests inwards‌.

Default: /forward

servletPath

Filter, i.e. all requests to servletContext are filtered.

Default: /* (i.e. no filter)

addStandardServlets

If true, forwarding for triggers, requests and AS2 to the inner Integration Server is set up. See section "Forwarding HTTP requests inwards‌".

true|false. Default: false

streamingSize

Specification in MB from when on the payload of a message is no longer passed on in the message and the inner Integration Server fetches the payload from the DMZ server via FTP or SFTP.

0-n. Default: 10

maxSize

Specified in kB. Defines max. size of payloads after which they are not forwarded. Value 0 means no limit.

0-n. Default: 0

handleAS2

If true, the local AS2 service is used. If false forwards AS2 messages. See section AS2.

true|false. Default: false

usePersistentMessageForAS2

If true, unsuccessfully forwarded AS2 messages are acknowledged with an MDN and forwarded to the inner Integration Server later. If false, an NDN is sent.

true|false. Default: false

retainFiles

Specifies in days how long backups are kept. If 0, no backups are created.

0-n. Default: 0

checkInnerIS

If activated, a check is executed every n minutes to see if the inner Integration Server reacts. If not, an email is sent to the specified address.

true|false. Default: Not active (commented out).

forwardUnknownFiles

If no profile can be found, false will prevent the forwarding of files.

true|false. Default: true

stopServices

If true, communication services are terminated before the Integration Server is stopped. No longer necessary if the file ./etc/factory.xml has been created correctly.

true|false. Default: true

tunnelHttp

It is possible to tunnel HTTP(S) requests via the MessageService. The configuration file ./etc/forward.properties must also be adjusted in this case. Parameter "handleAS2" must be set to "true".

true|false. Default: false

virusScanner

See section "Phase 1" (→ Virus Scanner).

See section "Phase 1" (→ Virus Scanner).

forceSSL

If true, only HTTPS connections are accepted.

true|false. Default: false

ignoreNewPeerSignal

If Integration Server instances may have the same public IP address (through an IP load balancer), switch this option to true.

true|false. Default: false

recipientReplacementFile

If SMTP is used, you may replace recipient addresses by using a property file (old_address=new_address)

Example: ./etc/smtp_recipient_replace.properties

addAllowedEndpoint

Specifies the IP of an inner Integration Server that is allowed to trigger HTTP forwarding ('Via DMZ') via the DMZ server. As soon as there is such an entry, all other IPs are blocked. Multiple entries can be created by inserting another block of this type.