To identify the various Progress Brokers on a specific system, a
Universally Unique Identifier (UUID) is needed.
The UUID for a Broker:
- Is automatically set and entered in the configuration when a Broker is added or modified through the OE Console (Progress Explorer before it was depreciated)
- Must be manually created, when Broker entries (AppServer Brokers, WebSpeed Brokers, Database Brokers) are manually added to the ubroker.properties configuration file.
A UUID is unique across time and space within a single computer network and cannot be any random unique set of ASCII characters manually entered in the properties files.
Progress supplies a utility called "
genuuid" which generates a new UUID. The value of the output once generated, can then be cut and pasted into the appropriate place in the properties file.
To run
genuuid, use the command:
$DLC/bin/genuuid (on UNIX)
%DLC%\bin\genuuid (on Windows)
After running the command, the program returns a unique identifier to the screen.
Example:
$ genuuid
172.16.9.61:60095d5:e14c27ba3e:-8000
The new UUID is added to the properties file as follows:
[UBroker.AS.asBroker1]
appserviceNameList=asBroker1
BrokerLogFile=$WRKDIR/asBroker1.Broker.log
controllingNameServer=NS1
defaultService=1
description=A sample AppServer setup for State-reset
environment=asBroker1
groupName=
portNumber=3090
srvrLogFile=$WRKDIR/asBroker1.server.log
userName=
uuid=172.16.9.61:60095d5:e14c27ba3e:-8000 << HERE!
