Connecting a Router Network

To administer a router network, any given router of the network can be connected. After the connection setup, all routers of this network are available and are shown as a node in the navigator frame.

For the connection setup choose the entry "Connect..." in the menu "Connection" in the main frame. Now the following window is displayed:



SwiftMQ Explorer connects to a router via JMS and so, like any other JMS application, executes a JNDI-Lookup on a QueueConnectionFactory. For this, the JNDI-Provider-URL and the name of the QueueConnectionFactory needs to be given.

The indicated input fields are to be filled in as follows:

JNDI-Provider-URL:

The SMQP-URL of the respective JMS listeners by which the connection should be made. The assignment of the input field points at the JMS listener of the example configuration at router1.

The format of an SMQP-URL is the following:


 smqp://[<user>[:<password>]@](<host>:<port>)|"intravm"[/[type=<type>][;timeout=<long>]

Where


 smqp ::= Specifies the SwiftMQ Protocol
 <user> ::= Username. Default is 'anonymous'
 <password> ::= User's password. Default is null.
 <host> ::= DNS hostname of the router or the keyword "intravm" to connect intra-VM
 <port> ::= JMS inbound listener port
 type ::= Class name of the socket factory used by this JMS inbound listener.
  In this release, com.swifmq.net.PlainSocketFactory and
  com.swiftmq.net.JSSESocketFactory are available. Default is
  com.swifmq.net.PlainSocketFactory. See JMSSwiftlet configuration for details.
 timeout ::= Specifies a timeout in milliseconds for lookups. If no JNDI object is
  received within this time, the lookup returns null. Default is no timeout;
  lookups are waiting until they receive the requested JNDI objects.

Name Queue Connection Factory:

Here you can specify the name of the QueueConnectionFactory on which a JNDI-Lookup should result. The field default is "QueueConnectionFactory" which is pre-configurated in the example configuration.

Username:

The user name on which the QueueConnection is established by the demanded QueueConnectionFactory. This user needs to have a send grant on the queue "swiftmqmgmt" on all routers belonging to the router network. The grants are to be determined for the router by which the connection takes place. In the example configuration the user "admin" is pre-configurated with these grants for the queues "swiftmqmgmt@router1" and "swiftmqmgmt@router2".

Password:

The password of the user. If the pre-configurated user "admin" is used, the password is "secret".