Configuring App Properties With the TIBCO® Cloud - Command Line Interface
You can late-bind property values for a TIBCO BusinessWorks™ App or Node.js app using the
tibcli app push and
tibcli app configure commands. The current values of app properties can be displayed or overridden.
tibcli app configure command will prompt you to restart the app with new override values. This enables you to modify properties without pushing and building a new EAR file, speeding up changes for moving from test to production, or changing credentials or other variables.
New application variables for TIBCO BusinessWorks Apps must be added in TIBCO Business Studio. For Node.js apps, the
tibcli-node tool must be used to modify the manifest, as described in Using Environment Variables in Node.js Apps. Once the app is repushed, the variables will display in the Environment controls tab after refreshing the page.
Viewing App Properties
To view app properties:
- Log in with the TIBCO Cloud CLI as shown in Logging In With the TIBCO® Cloud - Command Line Interface.
List the properties for an app using the
tibcli app configure -lcommand. For example, to view the configuration for the app
tibcli app configure -l myApp1
Configuring an App
To configure an app:
Change the configuration for the app with the
tibcli app configurecommand, specifying overridden properties in property=value pairs. For example, to override
prop2with the values
tibcli app configure myApp1 prop1="newval" prop1="newval2"
After issuing the above command, you will be prompted to verify if the app will be reconfigured. If you confirm, the overrides will be applied and the app will be restarted. The verification can be skipped with the
The bash shell interprets $, ` (back tick), \, !, and # on the command line even when enclosed in double quotes. You need to use single quotes to prevent this, or use a properties file.
Overrides added with the TIBCO Cloud CLI are additive. After the
tibcli app configurecommand completes, property updates are merged into the existing set, either changing an existing override, adding a new override or reverting an override to its default value by providing an override consisting of the default value.
Configuring app properties for an app in a sandbox other than
My Default Sandboxis not supported. To configure an app, move it to the default sandbox first.
Using a Properties File
The TIBCO Cloud CLI can be used with a set of property overrides defined in a file, instead of specifying them in the command line.
For example create a
file.properties file such as the following:
Then use the following command:
tibcli app configure -p file.properties myApp1
Configuring With App Push
You can also configure or reconfigure an app using the
tibcli app push command. See the
app push command help in the TIBCO® Cloud - Command Line Interface Reference for more details.
For password properties, values are not shown when viewing app properties. Values will be displayed as
The password values are encrypted on the server using strong encryption. They can only be used by your app and can not be inspected. You can set password properties by using the BusinessWorks obfuscated format. See below for how to obfuscate passwords.
To obfuscate a BusinessWorks password:
- Go to
Enter the password and press return.
An obfuscated password string is given, which can be used in a property value.