Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Appendix A Converting Server Configuration Files to JSON

Appendix A
The tibemsconf2json utility is provided to convert a set of text-based EMS server configuration files into a single JSON configuration file. This tool is available on platforms that support Central Administration. For a list of supported platforms, see the supported platforms list for Central Administration in the TIBCO Enterprise Message Service Installation guide.
When using the utility, keep in mind that:
If there are any unsupported parameters in the source configuration file, the tibemsconf2json utility issues a warning but continues converting.
Review the TIBCO Enterprise Message Service Release Notes for details about any obsolete parameters that were removed from the current release.
tibemsconf2json does not automatically merge the two tibemsd.conf files of a fault tolerant pair of servers. To convert a fault tolerant pair:
1.
Convert the primary tibemsd.conf file first. The tibemsconf2json utility translates the ft_active URL property of tibemsd.conf file into an entry in the Secondary Listens list of the .json file, with the FT Active radio button set. If there is only one listen URL, it also sets the FT Active radio button of that URL in the Primary Listens list of the .json file.
2.
Using the Central Administration web interface, manually add the information from the secondary tibemsd.conf:
If more than one listen URL was configured in the primary tibemsd.conf file, you must mark one of the URLs as "FT Active" in the Primary Listens list. This lets the secondary EMS server know how to contact the primary server. This setting is configured on the Server Properties page.
If the secondary server has additional listen URLs, add these to the Secondary Listens list. These URLs are configured on the Fault Tolerance page.
For more information, see Configuring Fault Tolerance in Central Administration in the TIBCO Enterprise Message Service User’s Guide..
Syntax
To convert a EMS server configuration to JSON, use the command:
tibemsconf2json -conf source-file -json output-file | -console
where
source-file is the path to the tibemsd.conf to be converted. Sub-file names and locations are derived from the content of the tibemsd.conf file.
output-file is the name and location of the new JSON file. This file must have the .json extension. For example, tibemsd.json. If no path is specified, the file is created in the current working directory.
Alternately, specify -console to display the JSON output to the screen rather than saving to file.
The tibemsconf2json utility converts the .conf file to a JSON-based configuration. If -json output-file is specified, the file is created and saved in the location specified, or the current working directory if no path is given.
You can then start the EMS server using the JSON configuration, and access the server through the Central Administration web interface.
 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved