Search Results

Configuring App Properties With the TIBCO® Cloud - Command Line Interface

You can late-bind property values for an integration app using the tibcli app push and tibcli app configure commands. The current values of app properties can be displayed or overridden.

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

Viewing App Properties

To view app properties:

  1. Log in with the TIBCO Cloud CLI as shown in Logging In With the TIBCO® Cloud - Command Line Interface.
  2. List the properties for an app using the tibcli app configure -l command. For example, to view the configuration for the app myApp1:

     tibcli app configure -l myApp1
    

Configuring an App

To configure an app:

  1. Change the configuration for the app with the tibcli app configure command, specifying overridden properties in property=value pairs. For example, to override prop1 and prop2 with the values "newval" and "newval2" for myApp1:

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

Notes

  • 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 configure command 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 Sandbox is 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:

prop1="newval"
prop2="newval2"

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.

About Passwords

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.

Obfuscating Passwords

To obfuscate a BusinessWorks password:

  1. Go to <BWCLOUND_HOME>/bwcloud/1.0/bin.
  2. Run ./bwobfuscator
  3. Enter the password and press return.

    An obfuscated password string is given, which can be used in a property value.