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:

Configuration Entity
Name
Configuration Entity
Function
[UBroker] 
Defines default property settings for all NameServer, AppServer, DataServer, and WebSpeed Transaction Server brokers.
[UBroker.AS] 
Defines default property settings for all instances of an AppServer.
[UBroker.AS.product-instance-name] 
Defines property settings for this instance of an AppServer. The ubroker.properties file can contain several of these entities each with a unique product-instance-name.

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 the properties subdirectory of the Progress installation directory.

The conmgr.properties file stores all the properties for each instance of a Progress database.The conmgr.properties file is installed in the properties 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:

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 the properties subdirectory of the Progress installation directory. Follow these steps to edit the file and create or modify a product configuration:

  1. Make a backup copy from the installed ubroker.properties file (named, for example, test.properties).
  2. Make changes to test.properties with a text editor.
  3. 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 the ubroker.properties file whose configurations you want to validate.
  4. Table 7–1: ubroker.properties File Validation Utilities 
    Product
    Utility
    AppServer
    asconfig
    AppServer Internet Adapter
    aiaconfig
    DataServer for Microsoft SQL Server
    mssconfig
    DataServer for ODBC
    odbconfig
    DataServer for Oracle
    oraconfig
    NameServer
    nsconfig
    SonicMQ Adapter
    adaptconfig
    WebSpeed
    wsconfig

  5. Shut down any running brokers or NameServers using the -stop option of the appropriate configuration management utilities (for example, nsman and asbman).
  6. Copy test.properties to ubroker.properties in the properties subdirectory of the Progress installation directory. If you might return to the previous configuration, store a backup copy of the ubroker.properties file before replacing it with your modified version.
  7. 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.
  8. Table 7–2: ubroker.properties File Management Utilities 
    Product
    Utility
    AppServer
    asbman
    DataServer for Microsoft SQL Server
    mssman
    DataServer for ODBC
    odbman
    DataServer for Oracle
    oraman
    NameServer
    nsman
    SonicMQ Adapter
    adaptman
    WebSpeed
    wtbman

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