Broker Administration Enhancements (Sun GlassFish Message Queue 4.4 Release Notes)

Sun GlassFish Message Queue 4.4 Release Notes

Broker Administration Enhancements

In Message Queue 4.0, a new subcommand and several command options were added to the Command utility (imqcmd) to allow administrators to quiesce a broker, to shutdown a broker after a specified interval, to destroy a connection, or to set java system properties (for example, connection related properties).

Quiescing a broker moves it into a quiet state, which allows messages to be drained before the broker is shut down or restarted. No new connections can be created to a broker that is being quiesced. To quiesce the broker, enter a command like the following.

imqcmd quiesce bkr -b Wolfgang:1756
To shut down the broker after a specified interval, enter a command like the following. (The time interval specifies the number of seconds to wait before the broker is shut down.)

imqcmd shutdown bkr -b Hastings:1066 -time 90

If you specify a time interval, the broker will log a message indicating when shutdown will occur. For example,

Shutting down the broker in 29 seconds (29996 milliseconds)

While the broker is waiting to shut down, its behavior is affected in the following ways.
- Administrative jms connections will continue to be accepted.
- No new jms connections will be accepted.
- Existing jms connections will continue to work.
- The broker will not be able to take over for any other broker in an enhanced broker cluster.
- The imqcmd utility will not block, it will send the request to shut down to the broker and return right away.
To destroy a connection, enter a command like the following.

imqcmd destroy cxn -n 2691475382197166336

Use the command imqcmd list cxn or imqcmd query cxn to obtain the connection ID.
To set a system property using imqcmd, use the new –D option. This is useful for setting or overriding JMS connection factory properties or connection-related java system properties. For example:
```
imqcmd list svc -secure -DimqSSLIsHostTrusted=true
imqcmd list svc -secure -Djavax.net.ssl.trustStore=/tmp/mytruststore 
            -Djavax.net.ssl.trustStorePassword=mytrustword
```

For complete information about the syntax of the imqcmd command, see Chapter 16, Command Line Reference, in Sun GlassFish Message Queue 4.4 Administration Guide.