Server Configuration Upload/Download
When configured to use FTL stores, the EMS server will first connect to the FTL server cluster and fetch the configuration information before beginning its start-up sequence. The JSON configuration must be available in the FTL server cluster prior to starting the EMS server. If no configuration is available in the cluster, the EMS server will start-up with a default configuration.
The tibemsjson2ftl tool can be used to upload JSON configuration files to a specified FTL server cluster. It can also download JSON configuration files from a specified cluster.
Running the tibemsjson2ftl Tool
The tibemsjson2ftl tool is invoked from the command line. The tool is dependent on FTL C client libraries, so the LD_LIBRARY_PATH environment variable must be set before running it.
export LD_LIBRARY_PATH=<FTL_HOME>/lib:$LD_LIBRARY_PATH
tibemsjson2ftl parameters
tibemsjson2ftl Options
The following table shows the options that are used with the tibemsjson2ftl tool.
| Option | Description |
|---|---|
| -url url_list | The URL list of the FTL server cluster to connect to. |
| -name ftl_app_name |
The name of the application defined in FTL that will be used by the EMS server's FTL stores. |
| -key uniquevalue |
This parameter is used in conjunction with the -name parameter to uniquely identify a JSON configuration in the FTL server cluster. Uploading a JSON configuration with a non-unique combination of -key and -name values will overwrite the existing configuration corresponding to that combination. |
| -json pathname |
The absolute path to the JSON configuration file to be uploaded to the FTL server cluster. When the -download parameter is specified, the downloaded JSON configuration will be written to the value passed to this parameter. |
| -download | When specified, tibemsjson2ftl will download the JSON configuration from the FTL server cluster and write it to the file passed to
-json.
If this parameter is not specified, the tool will default to uploading the JSON configuration to the FTL server cluster. |
| -trustfile path | Path to the plaintext file that contains the FTL servers' public certificate. Required for TLS communication with a secure FTL server cluster. |
| -user user |
User name to use when connecting to an FTL server cluster that has authentication enabled. |
| -password password |
Password to use when connecting to an FTL server cluster that has authentication enabled. Refer to the Password Security section of the TIBCO FTL Administration product guide for details on the full syntax. |
Uploading configuration to an FTL server cluster:
tibemsjson2ftl -url http://hostname:8080 -name default -key uniquekeyExample 2
Downloading configuration from an FTL server cluster:
tibemsjson2ftl -url http://hostname:8080 -name default -key uniquekey -downloadExample 3
tibemsjson2ftl -url https://hostname:8080 -name default -key uniquekey -trustfile ftl-trust.pem -user user1 -password password