Kbase P162619: How to manually add a new WebSpeed broker
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
11/04/2011 |
|
Status: Unverified
GOAL:
How to manually add a new WebSpeed broker
GOAL:
How to add a new unified broker on the ubroker.properties manually?
FACT(s) (Environment):
All Supported Operating Systems
Progress 9.x
OpenEdge 10.x
FIX:
Open the default ubroker.properties file and save it as ubroker.properties.new
Copy the existing unified broker section for the broker type of your choice - WebSpeed, AppServer, Oracle DataServer broker.
In this example below a WebSpeed broker is being created for the demonstration:
You need to copy two section for the broker - Environment and broker definition itself and paste it to the ubroker.properties file. Then change the name of the broker as well as the name of the log files to a new name you have decided for your business. In the following example a new broker name wsbroker2 is created. The changes are in bold faced and italicized to show what is being changed on the new broker definition.
Default webspeed broker:
# Sample Environment for Broker: wsbroker1
#
[Environment.wsbroker1]
TESTENV=MYENV
#
# Sample WebSpeed Broker definition
#
[UBroker.WS.wsbroker1]
appserviceNameList=wsbroker1
brokerLogFile=@{WorkPath}\wsbroker1.broker.log
controllingNameServer=NS1
description=A sample WebSpeed Transaction Server
environment=wsbroker1
password=
portNumber=3055
srvrLogFile=@{WorkPath}\wsbroker1.server.log
srvrStartupParam=-p web\objects\web-disp.p -weblogerror
userName=
uuid=932.99.000.ZZZ:1ee77e:cf3bbe04fd:-8000
New webspeed broker:
# Sample Environment for Broker: wsbroker2
#
[Environment.wsbroker2]
TESTENV=MYENV
#
# Sample WebSpeed Broker definition
#
[UBroker.WS.wsbroker2]
appserviceNameList=wsbroker2
brokerLogFile=@{WorkPath}\wsbroker2.broker.log
controllingNameServer=NS1
description=A sample WebSpeed Transaction Server
environment=wsbroker2
password=
portNumber=4055
srvrLogFile=@{WorkPath}\wsbroker2.server.log
srvrStartupParam=-p web\objects\web-disp.p -weblogerror
userName=
uuid=f019968b6fe1ece2:7fcf610d:12f4553e52e:-8000
You can use your favourate text editor and copy the default broker and just replace the name using "replace all" which will make it easier to replace the name for the broker and the log file name. You also need to change the port number as well as the uuid for the unified broker. Progress supplies gennuuid.bat or gennuuid script on unix to generate uuid under the DLC/bin. You just need to run it on the on the Start > programs > Progress or OpenEdge > proenv prompt or on the unix command prompt given that you have DLC is set end exported as well $DLC/bin appended on the PATH on unix.
On Windows or unix, you can use the proenv prompt as weel. An example is shown below from Windows proend prompt:
proenv>genuuid
f019968b6fe1ece2:7fcf610d:12f4553e52e:-8000
You then need torename your default DLC/properties/ubroker.properties file to ubroker.properties.default and rename the DLC/properties/ubroker.properties.new to ubroker.properties. you now can start the adminserver and run your new broker.