Sun Cluster 3.1 Data Service for Sun ONE Message Queue Guide

Installing and Configuring the Sun ONE Message Queue

The Sun ONE Message Queue is a Java 2 Enterprise Edition (J2EE™) 1.3 compliant messaging service. This queue is designed to meet the needs of enterprise customers and run under the control of Sun Cluster software. This section describes the steps to install and enable the Sun ONE Message Queue to run as the Sun Cluster HA for Sun ONE Message Queue.


Note –

If you run the Sun ONE Message Queue and another messaging service server and they use the same network resources, configure them to listen on different ports. Otherwise, a port conflict might occur between the two services.


Use the following procedure to install the Sun ONE Message Queue.

How to Install the Sun ONE Message Queue

Use the following procedure to install the Sun ONE Message Queue. Only the sections that are specific to the Sun ONE Message Queue are included here. See the Sun ONE Message Queue documentation for details.


Note –

Do not set the AUTOSTART property to YES in the /etc/imq/imqbrokerd.conf file. The AUTOSTART property is set to NO by default because Sun Cluster HA for Sun ONE Message Queue starts and stops the application after you have configured the data service.


  1. Install the Sun ONE Message Queue packages on all the nodes of the cluster if they are not already installed.

  2. Identify a location on a global file system where you intend to keep your message queue (for example, /global/s1mq).

    You can create a separate directory for this file system.

  3. On any node set IMQ_VARHOME and run the imqbrokerd command to create the configuration directory and files.


    # IMQ_VARHOME=/global/s1mq
    # export IMQ_VARHOME
    # imqbrokerd -name hamq1
    
  4. Set the imq.jms.tcp.hostname property to the logical hostname by editing $IMQ_VARHOME/instances/hamq1/props/config.properties.