Server Configuration Upload/Download

When configured to use grid stores, the EMS server will first connect to the data grid and fetch the configuration information before beginning its start-up sequence. The JSON configuration must be available in the data grid prior to starting the EMS server. If no configuration is available in the data grid, the EMS server will start-up with a default configuration.

The tibemsjson2grid tool can be used to upload JSON configuration files to a specified data grid. It can also download JSON configuration files from a specified data grid.

Running the tibemsjson2grid Tool

The tibemsjson2grid tool is invoked from the command line. The tool is dependent on FTL and ActiveSpaces C client libraries, so the LD_LIBRARY_PATH environment variable must be set before running it. 

export LD_LIBRARY_PATH=<AS_HOME>/lib:<FTL_HOME>/lib:$LD_LIBRARY_PATH 
tibemsjson2grid parameters

tibemsjson2grid Options

The following table shows the options that are used with the tibemsjson2grid tool.
Option Description
-url url The realm service URL of the data grid to connect to.
-name gridname The name of the data grid to connect to.
-key uniquevalue

The value passed to this parameter should be a unique value that identifies a specific JSON configuration.

Uploading a JSON configuration with a non-unique combination -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 data grid.

When the -download parameter is specified, the downloaded JSON configuration will be written to the value passed to this parameter.

-download

When specified, tibemsjson2grid will download the JSON configuration from the data grid 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 data grid.

-trustfile path

Path to the plaintext file that contains the FTL server’s public certificate. Required for TLS communication with a secure FTL server.

-user user

User name to use when connecting to an FTL server that has authentication enabled.

-password password

Password to use when connecting to an FTL server that has authentication enabled.

Refer to the Password Security section of the TIBCO FTL Administration product guide for details on the full syntax.

Example 1
Uploading configuration to the data grid: 
tibemsjson2grid -url http://hostname:8080 -name devgrid -key uniquekey
Example 2
Downloading configuration from a data grid: 
tibemsjson2grid -url http://hostname:8080 -name devgrid -key uniquekey -download
Example 3
Uploading configuration to a secure data grid: 
tibemsjson2grid -url https://hostname:8080 -name devgrid -key uniquekey -trustfile ftl-trust.pem -user user1 -password password