The ubroker.properties file

The ubroker.properties file consists of a hierarchical structure of configuration entities, in which parent entities provide configuration information that you can override or extend in each child entity. Each configuration entity has a name that begins the entity definition, and the definition contains configuration settings for one or more product instances.

For example, property settings for an instance of an AppServer are determined hierarchically, as shown in the following table.

Table 1. Ubroker.properties file structure
Configuration entity name Configuration entity function
[UBroker] Defines default property settings for various OpenEdge brokers, including all AppServer brokers.
[UBroker.AS] Defines default property settings for all instances of an AppServer.
[UBroker.AS.product-instance-name] Defines property settings for a particular instance of an AppServer. The ubroker.properties file can contain several of these entities, each with a unique product-instance-name.
Note: The product-instance-nameis unique and case-sensitive. It can contain alphanumeric and special characters, except period (“.”), colon (":"), or square brackets (“[ ]”). The name must not contain blank spaces.

Parent entities provide default values for all of their child entities. However, at any child level a redefinition of any value supersedes the default value of its parent. All children, from their definition level down, inherit this new value.

Like the ubroker.properties file, a similar file, conmgr.properties, stores all the properties for each instance of an OpenEdge database. For more information about OpenEdge Management and OpenEdge Explorer and the database configuration properties, see Configure OpenEdge Databases.

The ubroker.properties file resides in the properties subdirectory of the OpenEdge install directory. The file is editable and any changes that you make to it are automatically reflected in the management console.

Note: Although making manual edits to the ubroker.properties file is possible, Progress Software recommends that you use the Mergeprop utility or the management console to make property changes. For more information about the Mergeprop utility, see OpenEdge Getting Started: Installation and Configuration.