Try OpenEdge Now
skip to main content
Installation and Configuration
Configuration : Configuration : Ubroker.properties file and product configurations : Ubroker.properties file structure : Guidelines for editing the properties file
 
Guidelines for editing the properties file
In general, you should update all configurations (local or remote) using either OpenEdge Management or OpenEdge Explorer or the mergeprop utility. If you must update a configuration locally using a text editor:
*Do not directly change the values in the ubroker.properties file unless you have a complete understanding of how the changes affect Unified Broker components.
*Make a copy of this file, edit the copy, and verify the result before replacing the original with your edited copy.
*For complete definitions of all the properties and detailed information on how to set them, see the comments included in the properties file.
*Verify the result using the appropriate configuration validation utilities.
To edit the properties file and create or modify a product configuration:
1. Make a backup copy from the installed ubroker.properties file and name it, for example, test.properties.
2. Make changes to test.properties with a text editor.
3. Run the appropriate validation utility on test.properties using the -propfile option to validate your changes. For a complete list of the command-line utilities you can use to validate property file changes, see the table.
Note: Shut down any running brokers or NameServers using the -stop option of the appropriate configuration management utilities (for example, nsman and asbman).
4. Copy test.properties to ubroker.properties in the properties subdirectory of the OpenEdge installation directory. If you might return to the previous configuration, store a backup copy of the ubroker.properties file before replacing it with your modified version.
5. Restart your brokers and NameServers using the -start option of the appropriate configuration management utilities. For a complete list of the command-line utilities you can use to configure property files, see the table.
For more information on editing and validating the ubroker.properties file to configure a NameServer, see Editing and validating the content of the ubroker.properties file. For more information on editing and validating the file for each Unified Broker product, see your product documentation.