Progress
Installation and Configuration Guide
Version 9
for Windows
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, SonicMQ Adapter, 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 Progress 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 "Unified Broker Properties File (ubroker.properties)" 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 "Using a Text Editor and Configuration Utilities" 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.
This is the syntax to invoke the NSCONFIG utility:
-name
name-serverSpecifies which existing NameServer configuration to examine. The name must match the name of an existing NameServer configuration in the specified properties file. If you do not specify a NameServer, the NSCONFIG utility analyzes all NameServer configurations defined in the properties file specified by the
-propfile
parameter.
-propfile
path-to-properties-fileSpecifies a filename or pathname to a file that contains the property settings to be validated, for example
test.properties
. If a filename or pathname is not specified, it defaults to the installation version of theubroker.properties
file, such as:-
validate
Checks the syntax and values of property settings defined in the specified properties file.
-help
Displays command-line help.
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:
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.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |