Configuring App Variables
On the Environment Controls tab, you can use the late-bind property values for a TIBCO BusinessWorks Container Edition on the App Details page.
For TIBCO BusinessWorks Container Edition apps, you can configure the following variables:
• | Application Variables |
• | Engine Variables |
- The Add and Delete variable options on the Application Variables tab does not display.
- The application properties must be tokenized to configure them on data plane deployment. For more information, see Tokenizing Application Properties
Application Variables
New application variables for TIBCO BusinessWorks Container Edition apps can be added in TIBCO Business Studio for BusinessWorks. Ensure you tokenize the newly created application variables. For more information, see Tokenizing Application Properties
You can perform the following task:
Modifying Application Variable Values
To view and change the Application variables:
- Procedure
- Log in to TIBCO Control Plane and navigate to the Data Plane details page.
- On the Applications tab, click a running TIBCO BusinessWorks Container Edition application from the listed apps.
-
Click the Environmental Controls tab.
-
Click Application Variables.
-
Select the application properties profile from the Profile dropdown. This dropdown populates the list of all the profiles available in the application EAR file.
-
To change a variable, click the displayed value and enter a new value.
-
After you have made changes, the No Updates to Push text in the upper right changes to two links: Discard changes and Push updates. Click Push updates to restart the app with the new values, or click Discard changes to discard the changes made.
Engine Variables
New engine variables for TIBCO BusinessWorks Container Edition apps can be added in TIBCO Business Studio for BusinessWorks. Ensure you tokenize the newly created engine variables. For more information, see Tokenizing Application Properties.
You can perform the following tasks:
Refreshing App Variables
TIBCO BusinessWorks Container Edition apps have application variables and engine variables. For running apps, use the Refresh App Properties button on the Engine Variables tab to dynamically update Application Variables configured in third-party configuration or credential management solutions without restarting the application. The refresh process retrieves properties from third-party configuration management or credential management solutions.
When using the Refresh App Properties button, you may encounter the following messages:
Message | Description |
---|---|
Application Properties updated successfully. | The app is running and the third-party configuration management or credential management solutions are configured. |
No configuration or credential management configured with the application. |
The app is stopped and third-party configuration management or credential management solutions are configured. The app is running, but third-party configuration or credential management solutions are not configured. |
Failed to update application properties. | The app is stopped, but third-party configuration or credential management solutions are configured. |
Engine Variables List
Under the App Details > Environment Controls > Engine variables pane, the values for the following variables can be changed:
Engine Variables | Description |
---|---|
BW_LOGGER_OVERRIDES |
Overrides the default values for different logger properties. If you want to set multiple logger levels, you can set them one by one, separated by whitespace. |
BW_ENGINE_THREADCOUNT |
Overrides the default value for the bw.engine.threadcount property. |
BW_ENGINE_STEPCOUNT
|
Overrides the value for the |
BW_OTEL_TRACES_ENABLED
|
Overrides the values for the |
Adding Custom Engine Variables
You can also add your own custom variables in the Engine variables pane for TIBCO BusinessWorks Container Edition apps.
To add or change a custom variable:
- Procedure
- Log in to TIBCO Control Plane and navigate to the Data Plane details page.
- On the Applications tab, click a running TIBCO BusinessWorks Container Edition application from the listed apps.
-
Click the Environmental Controls tab.
-
Click Engine Variables.
-
Click the Add Variable button.
-
New properties appear at the bottom of the list. Add the name and value of the variable. You can select the Type as String or Password.
Note: By default, the type is String. -
Click Push Updates.
Note: If you are using credential or configuration management system, you can add the environment variable specific to these solutions as custom engine variables. For more information, see Environment Variable for Docker.
Modifying Engine Variable Values
To view and change the engine variable, perform the same steps mentioned in the Modifying Application Variable Values. For Step 4, instead of Application Variables, click Engine Variables.
Deleting Custom Variables
To delete a custom property or variable:
- Procedure
- Log in to TIBCO Control Plane and navigate to the Data Plane details page.
- On the Applications tab, click a running TIBCO BusinessWorks Container Edition application from the listed apps.
-
Click the Environmental Controls tab.
-
Click Engine Variables.
-
On the right side of the variable, a trash icon opens.
-
Click the trash can, then click Push Updates.