jmqconfig - The JMS Configuration Utility

The jmqconfig utility is a configuration tool for the JMS Server.

SYNOPSIS

jmqconfig <option> <file <name>
where options include:
    -help                print out this message
    -verbose             run in verbose mode
    -load <file name>    load JMS server state from file
    -save <file name>    save state of JMS server into file
    -user <user>         user name when connecting to server
    -password <pass>     password when connecting to server
    -host <host>         server host (default is localhost)
    -port <port>         server port (default is 53506)

DESCRIPTION

The jmqconfig program is a utility for managing the configuration for a JMS server. It allows you to load up a JMS server with the configuration described in an XML file. Alternatively, you can save the current configuration of a JMS server into an XML file. The XML configuration file describes users, groups, ACL's and destinations (including properties).

A sample JMS configuration file is shown below:

<?xml version="1.0" encoding="UTF-8"?>
<jbrokerMQ>
 <topics>
  <topic>
   <name>topic0</name>
   <property>
    <name>destination.maxUnconsumedMsgNum</name>
    <value>10000</value>
   </property>
  </topic>
 </topics>
</jbrokerMQ>

The configuration file can have any number of destination definitions and each destination may have multiple properties. For a sample XML configuration file, please look here.

OPTIONS

-help

Prints out the command syntax.

-verbose

Run the configuration utility in verbose mode.

-load fileName

Load up a JMS server with the configuration described in the specified file. If this command returns successfully, the JMS server will contain the users, groups, ACL's and destinations as desribed in the XML file.

-save fileName

Save the configuration of JMS server into the specified file. If this command returns successfully, the users, groups, ACL's and destinations of a running JMS server will be saved into the XML file. Note that passwords are not stored into the file, and if you plan to load the state into another JMS server, you must manually edit the passwords first.

-user username

Use username when creating a connection to the JMS server.

-password password

Use password when creating a connection to the JMS server.

-host hostname

Load or save configuration at the JMS server running on the host specified in hostname.

-port portNumber

Load or save configuration at the JMS server running on the port specified in portNumber.

JVM FLAGS

It is possible to pass arguments to the JVM using the -J flag. In order to set the heap size to 250 MB, the following command line may be used:

   jmqconfig -J-Xms250m -load myConfig.xml