You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
Configuration
In order to enable this component, the following profile has to be enabled: external-flow. The below example illustrates how the bootstrap.properties file should look like:
bootstrap.properties
spring.profiles.active=native,...,external-flow
The file application-external-flow.properties must be available and should be configured as follows:
| Subject | Property | Default | Explanation | Property file | Additional information |
|---|---|---|---|---|---|
| External Flow Component | blueriq.external-flow.store-type | memory | The data store type, having two possible values: memory and redis. memory is the default one. |
| |
| blueriq.external-flow.redis-store.database | 0 | The Database index used by the connection factory. |
| ||
| blueriq.external-flow.redis-store.host | localhost | The REQUIRED DNS name or IP address of the Redis server. |
| ||
| blueriq.external-flow.redis-store.port | 6379 | The REQUIRED port on which to connect to Redis. |
| ||
| blueriq.external-flow.redis-store.ssl.enabled | false | Whether to enable SSL support |
| ||
| blueriq.external-flow.redis-store.password | The password used to connect to Redis, can be left empty if no password is required. |
| |||
| blueriq.external-flow.redis-store.timeout | 2000 | Timeoud (ms) for connect and read operations |
| ||
| blueriq.external-flow.redis-store.client-name | Client name to be set on connections. Can be left empty. |
| |||
| Redis connection pool configuration | blueriq.external-flow.redis-store.jedis.pool.maxIdle | 8 | Maximum number of "idle" connections in the pool. Use a negative value to indicate an unlimited number of idle connections. |
| Since 15.10 |
| blueriq.external-flow.redis-store.jedis.pool.minIdle | 0 | Target for the minimum number of idle connections to maintain in the pool. This setting only has an effect if it is positive. |
| Since 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.maxActive | 8 | Maximum number of connections that can be allocated by the pool at a given time. Use a negative value for no limit. |
| Since 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.maxWait | -1 | Maximum amount of time a connection allocation should block before throwing an exception when the pool is exhausted. Use a negative value to block indefinitely. |
| Since 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.timeBetweenEvictionRuns | Time between runs of the idle object evictor thread. When positive, the idle object evictor thread starts, otherwise no idle object eviction is performed. Can be left empty. |
| Since 15.10 | ||
| blueriq.external-flow.redis-store.pool-test-on-create | false | Whether to test the connection after creation. |
| Since 15.10 | |
| blueriq.external-flow.redis-store.pool-test-on-borrow | false | Whether to test the connection before it is borrowed from the pool. |
| Since 15.10 | |
| blueriq.external-flow.redis-store.pool-test-on-return | false | Whether to test the connection when it is returned to the pool after use. |
| Since 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.maxIdle | 8 | Maximum number of "idle" connections in the pool. Use a negative value to indicate an unlimited number of idle connections. |
| Removed in 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.minIdle | 0 | Target for the minimum number of idle connections to maintain in the pool. This setting only has an effect if it is positive. |
| Removed in 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.maxActive | 8 | Maximum number of connections that can be allocated by the pool at a given time. Use a negative value for no limit. |
| Removed in 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.maxWait | -1 | Maximum amount of time a connection allocation should block before throwing an exception when the pool is exhausted. Use a negative value to block indefinitely. |
| Removed in 15.10 | |
| blueriq.external-flow.redis-store.jedis.pool.timeBetweenEvictionRuns | Time between runs of the idle object evictor thread. When positive, the idle object evictor thread starts, otherwise no idle object eviction is performed. Can be left empty. |
| Removed in 15.10 |
Example configuration file :
application-external-flow.properties
# The data store type, having two possible values: memory and redis. memory is the default one. blueriq.external-flow.store-type=redis # The Database index used by the connection factory. blueriq.external-flow.redis-store.database=0 # The REQUIRED DNS name or IP address of the Redis server. blueriq.external-flow.redis-store.host= # The password used to connect to Redis, can be left empty if no password is required. blueriq.external-flow.redis-store.password= # The REQUIRED port on which to connect to Redis. blueriq.external-flow.redis-store.port= ### Pool configuration ### # Maximum number of "idle" connections in the pool. # Use a negative value to indicate an unlimited number of idle connections. blueriq.external-flow.redis-store.jedis.pool.maxIdle=8 # Target for the minimum number of idle connections to maintain in the pool. # This setting only has an effect if it is positive. blueriq.external-flow.redis-store.jedis.pool.minIdle=0 # Maximum number of connections that can be allocated by the pool at a given time. # Use a negative value for no limit. blueriq.external-flow.redis-store.jedis.pool.maxActive=8 # Maximum amount of time a connection allocation should block before throwing an exception when the pool is exhausted. # Use a negative value to block indefinitely. blueriq.external-flow.redis-store.jedis.pool.maxWait=-1
If the data store type is not specified, the memory store will be used.
Please note that using a memory store type will make it impossible for you to start an external flow that resides on a different Runtime.
The other
Please note that using a memory store type will make it impossible for you to start an external flow that resides on a different Runtime.
The other
blueriq.external-flow.redis-store* properties will be ignored in this case.If redis data store is used and the properties for configuring the host and/or the port are missing, the Runtime will not start.
Overview
Content Tools
2 Comments
Rik Schepens
For the classroom environment Frank van der Vaart and I tried to set the store-type on memory. Doing this explicitely gave us an error because a bean externalFlowConfig could not be found. By commenting out that line (line 2 in the example) we did get the default setting working. Anybody any idea how this could happen?
Deny Raatgever
Are you sure the configuration was right? If I try the setting "blueriq.external-flow.store-type=memory" it works in the latest Blueriq version (15.11). If I change it with a type-o (for example a trailing space I get the error you're describing.