Release 10.1A: OpenEdge Getting Started:
Installation and Configuration

> ## Editing the properties file

> The Unified Broker properties file, `ubroker.properties`, stores the configuration definitions for all instances of the NameServer, and all instances of any AppServer, AppServer Internet Adapter, OpenEdge Adapter for SonicMQ, WebSpeed Transaction Server, and DataServer products that run on the same machine. Each configuration definition contains property settings, environment variables (to be set when the Unified Broker starts), and references to registry entries for each product instance. Because the same properties file stores configurations for several different products, some sections of the file are generic to several different product broker configurations.

> There is one copy of this file for each OpenEdge installation. Thus, if you install the controlling NameServer on a separate machine from the Unified Broker product that it controls, the NameServer and Unified Broker product each have their own `ubroker.properties` file. For more information on the Unified Broker properties file, see the "Ubroker.properties file and product configurations" section.

> ##### Editing and validating the properties file

> To edit the properties file directly, use a text editor such as `vi` or Notepad. Once you edit the properties file, use the `NSCONFIG` command to validate the NameServer configuration information in the file. If the file contains any other Unified Broker configurations, run the configuration validation utilities for those Unified Broker products to ensure that these configurations are still valid. For more information, see the "Ubroker.properties file and product configurations" section.

> The `NSCONFIG` utility displays the property settings associated with a NameServer configuration and checks that the syntax and values are valid. You must run the `NSCONFIG` utility locally on the machine on which the NameServer is running. The utility does not run across the network.

> For example, the following command validates the syntax and views the configurations of all NameServer instances defined within the `test.properties` file located in the current working directory:

>     nsconfig -propfile test.properties -validate

> Once you have configured the controlling NameServer, you can configure your Unified Broker product components. You can configure each Unified Broker product much like the NameServer. For more information, see your product documentation.

> For complete information about the syntax and the options you use to invoke the `NSCONFIG` utility, see Appendix C "Command and Utility Reference."

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095