Setting Custom Engine Properties in Deployed Projects

TIBCO Administrator is responsible for deploying process engines in a production environment. TIBCO ActiveMatrix BusinessWorks provides a file for specifying any custom properties you wish to set in deployed engines. The bwengine.xml file is located in the lib\com\tibco\deployment subdirectory of the TIBCO ActiveMatrix BusinessWorks installation directory. For example, on MS Windows machines, this file would by default be located in c:\tibco\bw\<release_number>\lib\com\tibco\deployment\bwengine.xml where <release_number> is the release number of the currently installed TIBCO Designer.

The bwengine.xml file has a <properties> element that defines all of the properties you would like to have available in deployed process engine. Each property is contained in a <property> element with the following structure:

<name>Name to display in TIBCO Administrator</name>

<option>name of property</option>

<default>default value</default>

<description>short description of property</description>

</property>

For example, to include the Trace.Role.* property in deployment configurations, you would add the following to the bwengine.xml file:

<name>Trace All Roles</name>

<option>Trace.Role.*</option>

<default>false</default>

<description>Controls tracing of all roles.</description>

</property>

Once the property is defined in the bwengine.xml file, it is available in Enterprise Archive Files that are created by TIBCO Designer and will be displayed in the Advanced tab of the deployment configuration in TIBCO Administrator. Be sure to re-save EAR files in TIBCO Designer and re-load them into any deployment configurations created in TIBCO Administrator after changing the bwengine.xml file. You can alter the value of any property on the Advanced tab of the deployment configuration and that value will be used in the deployed project.

See Chapter 4, Creating and Deploying Applications for more information about creating and managing deployment configurations.

Enabling Built-in Resource Provider

TIBCO BusinessWorks provides parameters to enable or disable the Built-in Resource Provider feature. This feature performs tasks similar to that of the Retrieve Resource activity, but eliminates the need to create the Retrieve Resource process.

The properties to enable, disable and control the Built-in Resource Provider feature can be set in the bwengine.xml. See TIBCO ActiveMatrix BusinessWorks Palette Reference Built-in Resource Provider for more information on the Built-in Resource Provider feature and the available properties.