WebSpeed
Installation and
Configuration Guide
Editing the ubroker.properties File
You can edit
ubroker.properties
directly using any text editor to create new WebSpeed Transaction Server and NameServer configurations or edit existing configurations. The simplest way to make new configurations in theubroker.properties
file is to copy an existing Transaction Server or NameServer definition and then modify the values of the copy’s properties to suit your needs. When you do this, you must be sure to supply each definition with its own uuid setting, as described in the list of required unique parameters later in this section.From a Windows 95, Windows 98, or Windows NT 4.0 machine, you can also use the Progress Explorer remotely to create and configure instances of the WebSpeed Transaction Server or the NameServer on the UNIX platform.
If you edit the configuration by hand, without the Progress Explorer, note that:
- The
ubroker.properties
file resides in the /properties
subdirectory of the Progress installation directory.- You should not directly change the values in the
ubroker.properties
file unless you have a complete understanding of how the changes affect WebSpeed components. If you have the Progress Explorer available from a remote Windows machine, use it to make all changes to this file on your UNIX machines.- For complete definitions of all the properties and detailed information on how to set them, see the comments included in the installed file.
- If you create additional instances of the WebSpeed Transaction Server and the NameServer, you must be sure that each of the following parameters has a value unique to the entire
ubroker.properties
file:
- [Ubroker.WS.broker-name]—The Transaction Server name must be unique.
- portNumber—Each Transaction Server configuration requires a unique port number.
- defaultService—If you configure two WebSpeed Transaction Servers to use the same NameServer and specify that the Transaction Servers perform the same application service, the Transaction Servers must also support the same business function. Set only one of the Transaction Servers as the default.
- appserviceNameList—A list of aliases that can be used in the WService=<appservice-name> in the URL.
- uuid—A universally unique identifier for a Transaction Server. If you use the Progress Explorer to create the new Transaction Server, this property is automatically set. If you manually add Transaction Server definitions, generate a unique uuid for each Transaction Server definition by using the following command:
You can then cut and paste the value after “uuid=”.
- Log files—Each Transaction Server configuration and NameServer configuration generates its own log files; the names must be unique for each Transaction Server and each NameServer.
- If you create additional instances of the WebSpeed Transaction Server and the NameServer by copying an existing instance, be sure that each of the following parameters has the correct values for the new instance:
- srvrStartupParam—Identify the startup parameters for your agents. Copy the value from the
ubroker.properties
file’s [UBroker.WS] section to your new Transaction Server definition, and modify.- controllingNameServer—Make sure that each Transaction Server points to its controlling NameServer.
- userName and groupName—You can optionally specify a username and a group name that the Transaction Server runs under; if you do not specify these names, the Transaction Server runs under the username and group name of the user who starts the AdminServer.
NOTE: If you install the NameServer product on a separate host from the WebSpeed Transaction Server, the NameServer installation includes its own copy of the properties file.You must ensure that all related properties and sections of the file are properly specified for each Transaction Server or NameServer instance. If you do edit the file directly, use the appropriate configuration utility to validate the product configuration that you have edited:
For a complete overview of all the sections in the
ubroker.properties
file and more information on how to edit the file, see the comments in the file or sections on theubroker.properties
file in the “Configuring Progress Unified Broker Products” chapter in the Progress Installation and Configuration Guide Version 9 for UNIX . For more information on the configuration utilities, see "Configuration and Management Utilities."
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |