Using Consul as a Configuration Management Service from TIBCO Business Studio for BusinessWorks

You can use configurations from the configuration management services such as Consul, by defining the token as #<property name># in the application properties, where <property name> is the name of the configuration parameter.

For example, #EMS_URL#.

Follow these steps to use configurations from the Consul:

  1. In TIBCO Business Studio for BusinessWorks, on the Menu bar select Run > Run Configurations > Environment and set the environment variables to CONSUL_SERVER_URL and APP_CONFIG_PROFILE. For more information, see Environment Variables for TIBCO Business Studio for BusinessWorks.
    Note:

    The X_CONSUL_TOKEN environment variable should be used when authentication is enabled on the Consul Server.

  2. Select the desired profile as the default profile inside TIBCO Business Studio for BusinessWorks in order to fetch the values from the Consul Server.
  3. In your Consul Service, Service, define the keys using the format <BWCE_APP_NAME>/<PROFILE_NAME>/<KEY_NAME>.

    For example, tibco.bwce.sample.palette.jms.Consul.application/docker/EMS_URL

Adding the YAML or Properties file for Configuration Management using Consul

Follow the steps to add the properties or YAML file for configuration management using Consul:

For YAML file:

  1. By default, the YAML file is stored at <APPLICATION_NAME>/<APP_PROFILE_NAME> on Consul. Set the environment variable CONSUL_SERVER_URL, APP_CONFIG_PROFILE, and CONSUL_FORMAT=YAML. For more information, see Environment Variables for TIBCO Business Studio for BusinessWorks.
  2. This YAML file can also be stored at another key location on Consul by passing an additional environment variable CONSUL_DATA_KEY=<KEY_NAME>, where <KEY_NAME> is the custom location of the YAML file stored on Consul.
  3. In TIBCO Business Studio for BusinessWorks, configure the property by defining the token as <#KEY_IN_YAML_FILE#>. If a nested key is used, tokenize the key with the entire nested path and separate the key name by "//".

For properties file:

  1. By default, the properties file is stored at <APPLICATION_NAME>/<APP_PROFILE_NAME> on the Consul. Set the environment variable CONSUL_SERVER_URL, APP_CONFIG_PROFILE, and CONSUL_FORMAT=PROP. For more information, see Environment Variables for TIBCO Business Studio for BusinessWorks.
  2. This properties file can also be stored at another key location on the Consul by passing an additional environment variable CONSUL_DATA_KEY=<KEY_NAME>, where <KEY_NAME> is the custom location of the properties file stored on the Consul.
  3. In TIBCO Business Studio for BusinessWorks, configure the property by defining the token as <#KEY_TIBCO Business Studio™ for BusinessWorks™ N_PROP_FILE#>.

Support for using HTTPS enabled Consul Server as a configuration management Service.

To connect Consul via HTTPS (SSL) for TIBCO Business Studio for BusinessWorks, the SSL certificate needs to be added to the Java CA keystore at BW_HOME/tibcojre64/1.8.0/lib/security/cacerts.

To connect Consul via HTTPS (SSL) for Docker, copy the SSL certificate to the resources/addons/certs/ folder. Also copy the libsunec.so library found in jre-8u<no>-linux-x64.rpm/tar.gz, which is available in the Oracle resource library to the /resources/addons/lib folder before you create the base image.