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:

SYNTAX
nsconfig
  [
      [
         [ -name name-server ]
         [ -propfile path-to-properties-file ]
         [ -validate ]
      ]
    | -help
  ] 

-name name-server

Specifies 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-file

Specifies 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 the ubroker.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:

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.


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