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

Note:
  • 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
  1. Log in to TIBCO Control Plane and navigate to the Data Plane details page.
  2. On the Applications tab, click a running TIBCO BusinessWorks Container Edition application from the listed apps.
  3. Click the Environmental Controls tab.

  4. Click Application Variables.

  5. Select the application properties profile from the Profile dropdown. This dropdown populates the list of all the profiles available in the application EAR file.

  6. To change a variable, click the displayed value and enter a new value.

  7. 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.

Note: In TIBCO Business Studio for BusinessWorks, the Engine Variables are called System Properties.

You can perform the following tasks:

  1. Adding Custom Engine Variables

  2. Modifying Engine Variable Values
  3. Deleting Custom Variables

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.engine.stepcount property.

BW_OTEL_TRACES_ENABLED

Overrides the values for the bw.engine.opentelemetry.trace.enable property. By default, it is False.

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
  1. Log in to TIBCO Control Plane and navigate to the Data Plane details page.
  2. On the Applications tab, click a running TIBCO BusinessWorks Container Edition application from the listed apps.
  3. Click the Environmental Controls tab.

  4. Click Engine Variables.

  5. Click the Add Variable button.

  6. 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.
  7. 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
  1. Log in to TIBCO Control Plane and navigate to the Data Plane details page.
  2. On the Applications tab, click a running TIBCO BusinessWorks Container Edition application from the listed apps.
  3. Click the Environmental Controls tab.

  4. Click Engine Variables.

  5. On the right side of the variable, a trash icon opens.

  6. Click the trash can, then click Push Updates.