Progress
Installation and Configuration Guide
Version 9
for Windows
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, registry entries, and property settings for each product instance. Progress Explorer and the associated command-line configuration utilities use this 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 supersedes 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: for example,%DLC%\properties\ubroker.properties
on Windows.A similar file,
conmgr.properties,
stores all the properties for each instance of a Progress database.Theconmgr.properties
file is installed in theproperties
subdirectory of the Progress installation directory: for example,%DLC%\properties\conmgr.properties
on Windows.Working With the 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 the Building Distributed Applications Using the Progress AppServer manual.- 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 .- Maintaining
ubroker.properties
for NameServer installations, see "The Progress Unified Broker Administration Framework" section in "Configuring Progress Unified Broker Products," and the configuration manual for each product that includes the NameServer in its configuration.- 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
If you do not have access to Progress Explorer and must configure these products within a Windows environment, you must edit the
ubroker.properties
file using a text editor such as Notepad.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 (and name it, 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 6–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
andasbman
).- 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 6–2 lists the commands to run the validation utility for each supported product.For more information on editing and validating the
ubroker.properties
file to configure a NameServer, see the "Editing the Properties File" section in Configuring Progress Unified Broker Products." For more information on editing and validating the file for each Unified Broker product, see your product documentation.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |