Setting Custom Engine Properties in Deployed Projects

TIBCO Administrator is responsible for deploying process engines in a production environment. 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 ActiveMatrix BusinessWorks installation directory. For example, on Microsoft 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:

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

<property>
   <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 are displayed in the Advanced tab of the deployment configuration in TIBCO Administrator. Make 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 is used in the deployed project.

For more information about creating and managing deployment configurations, see Creating and Deploying Applications.