Chapter 26 Deploytime Configuration : Understanding Methods of Configuring Engine Properties

Understanding Methods of Configuring Engine Properties
How you set engine properties depends in part on whether you are deploying to a TIBCO Administrator domain or not. See Two Approaches to Configuring and Managing BusinessEvents Applications for an introduction to this topic, then explore each option in more detail below.
Setting Engine Properties for Deployment Outside of a Domain
For deployment outside of a domain you set properties in the engine property files. The main configuration file is the be-engine.tra file. You can also define sets of properties in supplementary files.
One approach is to configure common values in the main engine property file, and override or extend them using supplementary files, as needed for a specific node’s requirements. See Configuring to Run Outside of a TIBCO Administrator Domain for more details.
Setting Engine Properties for Deployment to a Domain
When you deploy to a TIBCO Administrator domain, you can set properties using engine property files or using the TIBCO Administrator user interface, or both. Whether you use the TRA file or TIBCO Administrator to set properties depends on what is convenient in your situation.
In TIBCO Administrator the individual BARs are, in effect, merged into one, and one set of BAR dialogs is available for configuration. You cannot deploy a BAR file individually. In effect, you are setting properties at the node level. However some property names contain an agent identifier so they can apply at the agent or agent group level.
In TIBCO Administrator, you can also define global variable values. They are set in the Advanced tab for the application. You can provide agent-level identifiers as global variables and provide values at deploy-time.
To set the deploytime engine properties in TIBCO Administrator, you go to the Advanced tab for the merged BAR. Expand Application Management > application_name > Configuration > application_name.bar, and then click the Advanced tab.
The default value of application_name is provided by the name of the enterprise archive resource, defined in TIBCO Designer. You can change the value when you upload the EAR file in TIBCO Administrator.
You can customize the list of engine properties that appears on the Advanced tab of the merged BAR to suit your needs. For instructions see Customizing the List of Properties on the Advanced Tab.
Properties set in the BAR file’s Advanced tab override those set in the BE_HOME/bin/be-engine.tra file. It’s a good idea to set individual properties in one location (TRA file or BAR Advanced tab) to avoid errors.
Using AppManage for Scripted Deployment to a Domain
Instead of using the TIBCO Administrator user interface, you can perform scripted deployment to a TIBCO Administrator domain using the AppManage utility. Use of AppManage is not explained in BusinessEvents documentation. See TIBCO Runtime Agent Scripting Deployment User’s Guide for details.