Engine Properties
ActiveMatrix BusinessWorks allows you to set engine properties at the AppNode or AppSpaceconfig.ini
file. Configure the engine by changing or assigning appropriate values to the properties. For more information, see
appspace_config.ini_template
or
appnode_config.ini_template
files at the
{TIBCO_HOME}\bw\6.x\config
directory.
BWEngine General Configuration
The properties in this section are applicable to the BWEngine.
Property | Description |
---|---|
bw.engine.threadCount |
Engine thread count. It specifies the engine thread pool size. Value of this property must always be greater than 0.
The default value is 8. |
bw.engine.stepCount |
Engine step count. It specifies the number of activities to run for a process instance, before the BWEngine yields the thread.
The default value is -1. |
bw.engine.separate.logs.by.app |
Application level logging. It enables separate log files at the application level.
The default value is false. |
bw.engine.node.weight |
Set the value between 1 to 99. The AppNode with highest weight is the primary node. |
bw.engine.name |
Specify the name of the engine.
The default value is Main. |
bw.engine.persistenceMode |
Specifies engine execution mode.
The default value is memory. |
bw.engine.shutdownOnFailure |
BWEngine Shut down Option.
The default value is true. |
bw.engine.activity.async.waitTime |
BW Asynchronous Activity Timeout. It specifies the default timeout or wait time value in milliseconds for the asynchronous activities run by the BWEngine.
The default value is 180000 (3 minutes). |
bw.engine.activity.signalin.eventTimeout.purge.interval |
Specifies the default interval for the background thread that looks for expired messages. The value must be specified in minutes.
The default value is 30 minutes. |
bw.engine.show.all.errors.while.application.startup |
Lists all errors within an application during an application startup.
The default value is false. This is a two-phase process:
|
bw.engine.checkpoint.expired.dupkey.purge.interval |
It specifies the default interval for the background thread to poll for expired duplicate keys.
The default value is "P30". |
bw.engine.inline.subprocess.multiLogging.disable |
Set the property to true if you do not want to list ERRORs generated by the inline subprocess on the console or in the AppNode's log files. |
bw.engine.enable.memory.saving.mode |
This property, when set to true, enables usage of memory saving mode, which frees activity output variables once they are no longer needed.
The default value is true. To disable the memory saving mode, unselect the Save information to support memory saving mode checkbox available at Window > Preferences > BusinessWorks > Process Diagram in the Memory Saving Mode section. Then, to remove the memory saving variable, right-click ActiveMatrix BusinessWorks™ Projects and select Refactor > Repair BusinessWorks Projects. In the dialog, select the Remove memory saving variables option. On clicking the Preview button, the variables that can be removed from different activities are displayed on the Preview page, then click OK. To update existing projects, use the repair tool. |
BWEngine Database Configuration
The properties in this section are applicable to the BWEngine database. All properties in this section are mandatory, when the BWEngine property bw.engine.persistenceMode is set to datastore or group.
Property | Description |
---|---|
bw.engine.db.jdbcDriver |
The BWEngine database driver. |
bw.engine.db.url |
The BWEngine database URL. |
bw.engine.db.userName |
The BWEngine database username. |
bw.engine.db.password |
The BWEngine database password. |
bw.engine.db.maxConnections |
The number of connections that can be made to the BWEngine database. |
BWEngine Group Configuration
The properties in this section are applicable to the BWEngine group. Some of the properties in this section are mandatory when the BWEngine property bw.engine.persistenceMode is set to group or ftgroup.
Property | Description |
---|---|
bw.engine.groupName |
It specifies the name of the BWEngine group. If this property is not specified, then the group name defaults to Group_<DomainName>_<AppSpaceName>" |
bw.engine.group.ats.timeout |
BWEngine Active to Standby Timeout property specifies the time to wait (in seconds) before force stopping an application on an AppNode that is transitioning from active to standby state.
The default value is 60 secs. If the value is set to 0, it indicates that the AppNode waits till the application is gracefully stopped. |
bw.engine.groupProvider.technology |
BWEngine Group Connection Provider Technology. This is a required property when the
bw.engine.persistenceMode property is set to
group or
ftgroup.
The supported values for the
|
BWEngine ftgroup Properties
Property | Description |
---|---|
bw.engine.ftgroup.lbmode |
When this property is false, all processes run on a single engine in the group. One of the engines in the group takes over in the event that the primary engine fails. When this property is true, all Multiple AppNodes processes run on all the engines in the group. This property only applies when the BWEngine property bw.engine.persistenceMode is set to ftgroup. The default value is false. |
bw.engine.use.weighted.node |
Indicates whether node weights should be used. The property is applied at the AppSpace level.
When the property is set to true, the node with the highest weight is chosen as the primary node in the group. Use the property bw.engine.node.weight in the node config to specify that node's weight. This property only applies when the BWEngine property bw.engine.persistenceMode is set to ftgroup. When you want to elect an AppNode as a leader AppNode, then set the bw.engine.use.weighted.node property to true at an AppSpace level. The default value is false. |
BW Event Configuration Properties
The properties in this section are applicable to the BW Event Publisher and various BW Event Subscribers that consume the generated events.
Property | Description |
---|---|
bw.engine.event.publisher.enabled |
Enable or disable the BWEngine Event Publisher property specifies whether BWEngine Event Publisher should be enabled or disabled in the BWEngine.
The default value is true. |
BWEngine Group Connection Provider EMS Configuration
Some of the properties in this section are mandatory when the BWEngine Group Connection Provider Technology property
bw.engine.groupProvider.technology
value is set to
ems
.
Property | Description |
---|---|
bw.engine.groupProvider.qin.EMSServerUrl |
Mandatory. The BWEngine Group Connection Provider EMS URL. |
bw.engine.groupProvider.qin.EMSUserName |
Mandatory. The BWEngine Group Connection Provider EMS Username. |
bw.engine.groupProvider.qin.EMSPassword |
Mandatory. The BWEngine Group Connection Provider EMS User Password. |
bw.engine.groupProvider.qin.EMSPrefix |
The BWEngine Group Connection Provider EMS Member Prefix.
The default value is EMSGMS. |
bw.engine.groupProvider.qin.EMSRecoveryTimeout |
The BWEngine Group Connection Provider EMS Recovery Timeout in milliseconds.
The default value is 5000. |
bw.engine.groupProvider.qin.EMSRecoveryAttemptDelay |
The BWEngine Group Connection Provider EMS Recovery Attempt Delay in milliseconds.
The default value is 500. |
bw.engine.groupProvider.qin.EMSRecoveryAttemptCount |
The BWEngine Group Connection Provider EMS Recovery AttemptCount. |
bw.engine.groupProvider.qin.EMSConnectAttemptCount |
The BWEngine Group Connection Provider EMS Connect Attempt Count. |
bw.engine.groupProvider.qin.EMSConnectAttemptDelay |
The BWEngine Group Connection Provider EMS Connect Attempt Delay in milliseconds. |
bw.engine.groupProvider.ems.ssl.trust.identity |
EMS SSL configuration client identity consisting of the certificate, private key, and optionally extra issuer certificates can be included into a single data block using PKCS12, Keystore, or Entrust Store encodings. |
bw.engine.groupProvider.ems.ssl.trust.certLocation |
The set of Trusted Certificates represents all trusted issuers of the server certificate. |
bw.engine.groupProvider.ems.ssl.trust.password |
EMS SSL connection trust password. |
bw.engine.groupProvider.ems.ssl.disable.verifyHostName |
Trusted certificate common name must match the EMS server hostname if set to false. |
bw.engine.groupProvider.ems.ssl.trust.disable.verifyHost |
The client and server certificates must match if set to false. |
BWEngine Group Connection Provider FTL Configuration
Some of the properties in this section are mandatory when the BWEngine Group Connection Provider Technology property
bw.engine.groupProvider.technology
value is set to
ftl
.
Property | Description |
---|---|
bw.engine.groupProvider.ftl.realmserver |
Mandatory. BWEngine Group Connection Provider FTL Realm Server.
The default value is http://localhost:8080 |
bw.engine.groupProvider.ftl.username |
Mandatory. The BWEngine Group Connection Provider FTL Realm client username. |
bw.engine.groupProvider.ftl.password |
Mandatory. The bwngine Group Connection Provider FTL Realm client password. |
bw.engine.groupProvider.ftl.appinstance.id |
Mandatory. The BWEngine Group Connection Provider FTL application identifier. |
bw.engine.groupProvider.ftl.secondaryserver |
The BWEngine Group Connection Provider FTL secondary realm server. |
bw.engine.groupProvider.ftl.groupname |
Mandatory. The BWEngine Group Connection Provider FTL group name. |
bw.engine.groupProvider.ftl.appname |
Mandatory. The BWEngine Group Connection Provider FTL application name. |
bw.engine.groupProvider.ftl.publish.endpoint |
Mandatory. The BWEngine Group Connection Provider FTL publish endpoint. |
bw.engine.groupProvider.ftl.subscribe.endpoint |
Mandatory. The BWEngine Group Connection Provider FTL application name. |
bw.engine.groupProvider.ftl.client.retries |
Use the property to set the FTL property
TIB_REALM_PROPERTY_LONG_CONNECT_RETRIES. The default value is 5.
To retry forever, set the value to 0. If the connect call cannot connect to the FTL server after the maximum number of connection attempts, an exception is displayed. |