Kbase P25693: How to set up a SonicMQ 4.02 Broker as a Service on Windows
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
16/10/2008 |
|
Status: Unverified
GOAL:
How to set up a SonicMQ 4.02 Broker as a Service on Windows
FACT(s) (Environment):
Windows
FIX:
To install a Windows service you must have Administrator rights on the
Windows broker machine. (For details on how to do this please refer to the SonicMQ Deployment Guide as per the Notes section below).
In a command prompt, enter the following:
SonicServiceSetup -install service_name [-a]
-jre=jre_path\bin\java.exe -home=homepath\broker.ini
[-b=brokerurl] [-u=brokeruser] [-ue encrypted-username]
[-p=brokerpass] [-cp=classpath] [-inipwd=passwd]
[-encpwd=encrypted-passwd] [-pe encrypted-password]
any_java_parameters
where:
-a : Starts automatically when the Windows machine is started. If this parameter is omitted, the service is installed in manual mode. You can start it using the Services tool in the Control Panel.
-b=brokerurl : Specifies the connection URL to the broker in the form
{tcp://|http://|ssl://}hostname{:2506|:port} The default is localhost:2506.
-cp=classpath : This parameter is not required if you set the system level CLASSPATH environment variable to the classpath required to run the service. Obtain the value of this parameter by copying the classpath in setenv.bat.
-encpwd=encrypted-passwd : Specifies the encrypted password needed to decrypt an encrypted broker initialization file (produced by PBETool). (See the “Security” chapter of the SonicMQ V4 Deployment Guide.)
-home=homepath\file_name : Specifies the path of the broker initialization file and the name of the file used to start the broker. The file_name is broker.ini unless you rename the file.
-inipwd=passwd : If you are using an encrypted broker initialization file (produced by PBETool), specifies the clear-text password needed to decrypt it. (See the “Security” chapter of the SonicMQ V4 Deployment Guide.)
-install service_name : Installs service_name as a Windows service, where service_name is the name you give to the service.
-jre=jre_path\bin\java.exe : Specifies the path to the Java executable used by the broker.
-p=brokerpass : Specifies the password used to connect with the broker. The default is Administrator.
-pe encrypted-password : Specifies the encrypted password generated with the PBEString script.
-u=brokeruser : Specifies the user to connect with the broker. The default is Administrator.
-ue encrypted-username : Specifies the encrypted username generated with the PBEString script.
any_java_parameters : Specifies arguments for the JVM, such as heap size.