Progress
Installation and Configuration Guide
Version 9
for UNIX
Managing Progress Product Configurations
The
ubroker.properties
file stores all the configuration definitions for each instance of the following Progress products:Each configuration definition contains environment variables and property settings for each product instance. The command-line configuration utilities use the
ubroker.properties
file to store, validate, and manage the configurations for the products.The file consists of a hierarchical structure of configuration entities, where 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, the AppServer configurations in
ubroker.properties
can include:
Parent entities provide default values for all of their child entities. However, at any child level, a redefinition of any value supercedes the default value of its parent. All children from the redefinition level down inherit this new value.
The
ubroker.properties
file is installed in theproperties
subdirectory of the Progress installation directory.The
conmgr.properties
file stores all the properties for each instance of a Progress database.Theconmgr.properties
file is installed in theproperties
subdirectory of the Progress installation directory.Working With Supported Products
For the definitions and usage of all properties supported in the properties file, see the comments in the installed
ubroker.properties
file. For more information on:
- Each configuration management and validation utility, see the Progress Client Deployment Guide and the Progress Database Administration Guide and Reference .
- Maintaining
ubroker.properties
for AppServer installations, see Building Distributed Applications Using the Progress AppServer .- Maintaining
ubroker.properties
for DataServer installations, see the Progress DataServer Guide for your DataServer product.- Maintaining
ubroker.properties
for WebSpeed installations, see the WebSpeed Installation and Configuration Guide for your operating system.- Maintaining
ubroker.properties
for NameServer installations, see the configuration manual for each product that includes the NameServer in its configuration. Also see the "NameServers" section in "Configuring Progress Unified Broker Products," for more information on how to configure NameServers and begin configuration and operation of your Unified Broker product.- Maintaining
ubroker
.properties
for AppServer Internet Adapter installations, see Progress on the Web .- Maintaining
ubroker
.properties
for SonicMQ Adapter installations, see Progress on the Web .Editing and Validating the Content Of the ubroker.properties File
To configure products you must edit the
ubroker.properties
file using a text editor.To ensure proper run-time processing, the file must be named
ubroker.properties
and must be located in theproperties
subdirectory of the Progress installation directory. Follow these steps to edit the file and create or modify a product configuration:
- Make a backup copy from the installed
ubroker.properties
file (named, for example,test.properties
).- Make changes to
test.properties
with a text editor.- Run the appropriate validation utility on
test.properties
using the -propfile option to validate your changes. Table 7–1 lists the commands to run the validation utility for each supported product. The command you run must have local access to theubroker.properties
file whose configurations you want to validate.
- Shut down any running brokers or NameServers using the -stop option of the appropriate configuration management utilities (for example, nsman and asbman).
- Copy
test.properties
toubroker.properties
in theproperties
subdirectory of the Progress installation directory. If you might return to the previous configuration, store a backup copy of theubroker.properties
file before replacing it with your modified version.- Restart your brokers and NameServers using the -start option of the appropriate configuration management utilities. Table 7–2 lists the commands to run the validation utility for each supported product.
For more information on the ubroker.properties file see the "Unified Broker Properties File (ubroker.properties)" section in Configuring Progress Unified Broker Products."
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |