Kbase 19870: SonicMQ: Connecting Remote Clients Using Multiple Protocols
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
13/06/2000 |
|
SUMMARY:
This solution applies to Progress SonicMQ Version 2000.x.
Certain properties must be set in the broker.ini file to use multiple
protocols simultaneously with a single broker.
EXPLANATION:
When multiple protocols are to be used, multiple acceptors must be
defined. An acceptor is defined by a port number and a socket type.
A socket type is specified by the protocol (TCP, HTTP, SSL) to be used
by that socket.
The hostname for each of the acceptors to be used must also be
specified in broker.ini. If a hostname is not specified for a given
acceptor, any client attempting to connect to the broker via that
acceptor by specifying the broker host as anything but "localhost"
will not be able to connect, and will receive the following exception:
java.net.ConnectException: Connection refused: Connection refused
This means that remote clients will not be able to connect to the broker.
SOLUTION:
To be able to connect to the broker from any SonicMQ client,
set properties in the broker.ini file as follows:
- NUM_ACCEPTORS=n, where n is the total number of acceptors to be used
- IP_OR_HOST_x=<hostname for acceptor x>, for IP_OR_HOST_1 through
IP_OR_HOST_n
- PORT=<port number for acceptor 1>
- PORT_NUMBER_x=<port number for acceptor x>, for PORT_NUMBER_2
through PORT_NUMBER_n
- DEFAULT_SOCKET_TYPE=<socket type for acceptor 1>
- SOCKET_TYPE_x=<socket type for acceptor x>, for SOCKET_TYPE_2
through SOCKET_TYPE_n
Acceptor 1 through acceptor n are therefore defined by the following
entries:
NUM_ACCEPTORS=n
IP_OR_HOST_1=host_name
DEFAULT_SOCKET_TYPE=socket_type
PORT=port_num
IP_OR_HOST_2=host_name
SOCKET_TYPE_2=socket_type
PORT_NUMBER_2=port_num
...
IP_OR_HOST_n=host_name
SOCKET_TYPE_n=socket_type
PORT_NUMBER_n=port_num
NOTE: If you are modifying an existing configuration, it is
not necessary to reinitialize the broker's database after modifying
any of the properties described above.
References To Written Documentation:
SonicMQ Installation and Administration Guide, Chapter 2
pages 55-56, Simultaneous Multi-protocol Support