Versions Compared

Version Old Version 2 New Version Current
Changes made by

Petr Jůza

Petr Jůza

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 6

...

Tip

Common recommendations for configuration:

  • set email addresses of administrators (admin.mail) because CleverBus OpenHub sends notifications to these addresses, for example when
    • message processing failed
    • if message waits for response from external system for more then defined interval
  • set username and password to access (web) services - parameters ws.user a ws.password in application.cfg
  • path to log folder (log.folder.path in application.cfg)

applicationCore.cfg

Parameter

Default value

Description

asynch.countPartlyFailsBeforeFailed

3

Count of unsuccessful tries of message processing before message will be marked as completely FAILED

Time interval between tries is defined by asynch.partlyFailedInterval.

asynch.repairRepeatTime

300

Max. interval in seconds how long can be message being processed, in other words how long can be in PROCESSING state.

If message is still in processing then repair process (org.

cleverbus

openhubframework.openhub.core.common.asynch.repair.RepairProcessingMsgRoute) will be started and the message state will be changed to PARTLY_FAILED.

This parameter is not only for messages themselves but also for external calls and confirmations.

asynch.concurrentConsumers

30

Input asynchronous messages are waiting for processing in the priority queue. This parameter determines how many concurrent consumers (=threads) can take message from the queue and start processing. In other words this parameter detemines how many concurrent messages can be processed.

For more informacetion se http://camel.apache.org/seda.html, parameter concurrentConsumers

asynch.partlyFailedRepeatTime

60

How often to run process (org.

cleverbus

openhubframework.openhub.core.common.asynch.queue.PartlyFailedMessagesPoolRoute) for pooling PARTLY_FAILED messages (in seconds).

This parameter is relevant to asynch.partlyFailedInterval.

asynch.partlyFailedInterval

60

Interval (in seconds) between two tries of PARTLY_FAILED messages. When this interval expires then can be message be processed again.

This parameter is relevant to asynch.partlyFailedRepeatTime.

asynch.confirmation.failedLimit

3

Maximum count of confirmation fails when will finish further processing of confirmation, confirmation fails.

asynch.confirmation.repeatTime

60

How often to run process (org.

cleverbus

openhubframework.openhub.core.common.asynch.confirm.ConfirmationsPoolRoute) for pooling failed confirmations (in seconds)

This parameter is relevant to asynch.confirmation.interval.

asynch.confirmation.interval

60

Interval (in seconds) between two tries of failed confirmations.

This parameter is relevant toasynch.confirmation.repeatTime

.

asynch.waitForResponse.timeout

3600

WarningParameter was removed in version 0.4 because new similar functionality was added - Alerts

.

asynch.externalCall.skipUriPattern

 

Regular expression that defines URIs which will be ignored by extcall component. Useful when you want to skip communication with an external system.

asynch.postponedInterval

5

Interval (in seconds) after that can be postponed message processed again.

asynch.postponedIntervalWhenFailed300

Interval (in seconds) after that postponed messages will fail. See Guaranteed message processing order functionality for more details.

info

Since version 0.4


Miscellaneous configuration

Parameter

Default value

Description

mail.admin

 

Administrator email(s)

If more emails, then separated them with semicolon if empty then email won't be sent.

mail.from
CleverBus integration platform <cleverbus@cleverlance.com>
OpenHub framework <openhub@openwise.cz>Email address FROM for sending emails
mail.smtp.serverlocalhostSMTP server for sending emails
dir.temp Directory for storing temporary files, related to DefaultFileRepository
dir.fileRepository File repository directory where files will be stored, related to DefaultFileRepository
contextCall.localhostUrihttp://localhost:8080URI of this localhost application, including port number. Related to external call in Admin GUI 
disable.throttlingfalseTrue for disabling throttling at all. See throttling component.
endpoints.includePattern^(spring-ws|servlet).*$Pattern for filtering endpoints URI - only whose URIs will match specified pattern will be returned, related to endpoints overview.
requestSaving.enablefalseTrue for enabling saving requests/responses for filtered endpoints URI.
requestSaving.endpointFilter^(spring-ws|servlet).*$Pattern for filtering endpoints URI which requests/response should be saved.
alerts.repeatTime300

How often to run checking of alerts (in seconds)

InfoThis parameter is enabled from 0.4 version.


application.cfg

Parameter

Default value

Description

db.driver

org.h2.DriverDriver class name
db.urljdbc:h2:mem:
cleverBusDB
openHubDBDatabase URL
db.usernamesaDatabase username
db.password Database password
ws.userwsUserUsername for accessing web services (Spring security configuration in rootSecurity.xml).
ws.passwordwsPasswordPassword for accessing web services (Spring security configuration in rootSecurity.xml).
web.userwebUserUsername for accessing web admin GUI (Spring security configuration in rootSecurity.xml).
web.passwordwebPasswordPassword for accessing web admin GUI (Spring security configuration in rootSecurity.xml).
monitoring.usermonUserUsername for accessing JavaMelody tool (Spring security configuration in rootSecurity.xml).
monitoring.passwordmonPasswordPassword for accessing JavaMelody tool (Spring security configuration in rootSecurity.xml).
log.folder.path${log.folder}, value is from Maven profile

Path to folder with application logs, used in logs searching in admin GUI.

log.file.pattern


Code Block
(^.*\\.log$|^.*\\.log\\.2\\d{3}-(0[1-9]|1[0-9])-[0|1|2|3]\\d?_\\d*\\.gz$)


Defines format of log file names (include filter) which will be taking into logs searching in admin GUI

. WarningSince version 0

.

4


Configuration hiearchy

There is the following configuration files hierarchy that determines processing order:

...

Restrict Spring bean inicialization 

Warning

From version 0.2

If there are many Spring beans with route definitions then startup time for loading ESB application can be quite long. This functionality enables to include only those Spring beans which should be initialized or exclude those Spring beans which we don't want to initialize.

...

There are two handy classes for these purposes: org.cleverbusopenhubframework.openhub.common.spring.SystemIncludeRegexPatternTypeFilter and org.cleverbusopenhubframework.openhub.common.spring.SystemExcludeRegexPatternTypeFilter

...

Example of system property definition for exclude filter (excludes all Spring beans under org.openhubframework.cleverbusuopenhub.modules package  package and sub-packages):

Code Block
-DspringExcludePattern=org\.cleverbusopenhubframework\.openhub\.modules\..*

Example of Spring configuration with custom type filters:

Code Block
languagexml
    <context:component-scan base-package="org.cleverbusopenhubframework.openhub.core, org.cleverbusopenhubframework.openhub.admin.routes, org.openhubframework.cleverbusopenhub.modules" use-default-filters="false">
        <context:include-filter type="custom" expression="org.cleverbusopenhubframework.openhub.common.spring.SystemIncludeRegexPatternTypeFilter"/>
        <context:exclude-filter type="custom" expression="org.openhubframework.cleverbusopenhub.common.spring.SystemExcludeRegexPatternTypeFilter"/>
    </context:component-scan>

...

Info

Include filters are applied after exclude filters.

Configuration checking

...

Configuration checker (org.cleverbusopenhubframework.openhub.core.conf.ConfigurationChecker) enables to check selected configuration parameters during application start:

...

You can implement your own checking functionality by org.cleverbusopenhubframework.openhub.core.conf.ConfCheck (since version 1.1).