Sun Cluster 3.1 Data Service for WebSphere MQ Guide

How to Install and Configure WebSphere MQ

Use this procedure to install and configure WebSphere MQ.

  1. Determine how WebSphere MQ will be deployed in Sun Cluster – Here you need to determine how WebSphere MQ will be deployed.

    • Determine how many WebSphere MQ instances will be deployed.

    • Determine what Cluster File System will be used by each WebSphere MQ instance.

  2. Mount WebSphere MQ Cluster File Systems – After you have determined how WebSphere MQ will be deployed within Sun Cluster, you must ensure the Cluster File Systems are mounted.


    Note –

    If Failover File Systems will be used by the WebSphere MQ instance, you must mount these manually.


  3. Install WebSphere MQ onto all nodes within Sun Cluster – It is recommended that WebSphere MQ is installed onto local disks, however for a discussion of the advantages and disadvantages of installing the software on a local versus a cluster file system, see “Determining the Location of the Application Binaries” on page 3 of the Sun Cluster Data Services Installation and Configuration Guide.

    • Install WebSphere MQ onto all nodes within Sun Cluster that will run WebSphere MQ, regardless of the location of the application binaries. This is required because the pkgadd for WebSphere MQ additionally sets up several symbolic links on the host.


      Note –

      Follow IBM's WebSphere MQ for Sun Solaris — Quick Beginnings manual to install WebSphere MQ.


  4. Create your WebSphere MQ Manager(s) – After WebSphere MQ has been installed onto all nodes within Sun Cluster that will run WebSphere MQ, you should create your WebSphere MQ Manager(s).

    WebSphere MQ V5.3 has a bug when the default setting, LogDefaultPath=/var/mqm/log, is used when issuing crtmqm to create your WebSphere MQ Manager. The problem can be seen in the following example, for example the crtmqm command complains with AMQ7064: Log path not valid or inaccessible.

    To workaround this you must specify the -ld parameter when creating the WebSphere MQ Manager, for example crtmqm -ld /global/mqm/log/<qmgr> <qmgr>

    This will cause another <qmgr> directory to appear, that is /global/mqm/log/<qmgr>/<qmgr>, however it overcomes this bug.


    Example 1–6 Create your WebSphere MQ V5.3 Manager with the -ld parameter


    # crtmqm qmgr1
    AMQ7064: Log path not valid or inaccessible.
    #
    # crtmqm -ld /global/mqm/log/qmgr1  qmgr1
    WebSphere MQ queue manager created.
    Creating or replacing default objects for qmgr1 .
    Default objects statistics : 31 created. 0 replaced. 0 failed.
    Completing setup.
    Setup completed.
    #
    # cd /global/mqm/log/qmgr1 
    #
    # ls -l
    total 2
    drwxrwx---   3 mqm      mqm          512 Jan 10 11:44 qmgr1 
    #
    # cd qmgr1 
    #
    # ls -l
    total 12
    drwxrwx---   2 mqm      mqm          512 Jan 10 11:44 active
    -rw-rw----   1 mqm      mqm         4460 Jan 10 11:44 amqhlctl.lfh
    #
    # pwd
    /global/mqm/log/qmgr1/qmgr1 
    #
    # cd /global/mqm/qmgrs/qmgr1
    #
    # more qm.ini
    #*******************************************************************#
    #* Module Name: qm.ini                                             *#
    #* Type       : MQSeries queue manager configuration file          *#
    #  Function   : Define the configuration of a single queue manager *#
    #*                                                                 *#
    #*******************************************************************#
    #* Notes      :                                                    *#
    #* 1) This file defines the configuration of the queue manager     *#
    #*                                                                 *#
    #*******************************************************************#
    ExitPath:
       ExitsDefaultPath=/var/mqm/exits/
    #*                                                                 *#
    #*                                                                 *#
    Log:
       LogPrimaryFiles=3
       LogSecondaryFiles=2
       LogFilePages=1024
       LogType=CIRCULAR
       LogBufferPages=0
       LogPath=/global/mqm/log/qmgr1/qmgr1/
       LogWriteIntegrity=TripleWrite
    Service:
       Name=AuthorizationService
       EntryPoints=10
    ServiceComponent:
       Service=AuthorizationService
       Name=MQSeries.UNIX.auth.service
       Module=/opt/mqm/lib/amqzfu
       ComponentDataSize=0
     # 


    Note –

    This bug, of having to specify the -ld parameter when LogDefaultPath=/var/mqm/log is being used, has been reported to IBM and a fix is being worked on.