Oracle^® Solaris Cluster Data Service for IBM WebSphere MQ Guide

How to Register and Configure HA for WebSphere MQ in a Failover Resource Group

This procedure assumes that you installed the data service packages during your initial Oracle Solaris Cluster installation.

If you did not install the HA for WebSphere MQ packages as part of your initial Oracle Solaris Cluster installation, go to How to Install the HA for WebSphere MQ Package.

1. On a cluster member, become an administrator that provides solaris.cluster.modify authorization.
2. Register the following resource types.

   # clresourcetype register SUNW.HAStoragePlus
   # clresourcetype register SUNW.gds

3. Create a failover resource group for IBM MQ.

   ---

   Note -  Refer to Restriction for Multiple IBM MQ Instances for more information on the nodelist entry.

   ---

   # clresourcegroup create -n nodelist websphere-mq-resource-group

4. Create a resource for the IBM MQ Logical Hostname.

   # clreslogicalhostname create -g websphere-mq-resource-group \
   -h websphere-mq-logical-hostname \
   websphere-mq-logical-hostname-resource

5. Create a resource for the IBM MQ Disk Storage.
   1. If a ZFS highly available local file system is being used.

      # clresource create -g websphere-mq-resource-group  \
      -t SUNW.HAStoragePlus \
      -p Zpools=websphere-mq-zspool \
      websphere-mq-hastorage-resource

   2. If a cluster file system or a non-ZFS highly available local file system is being used.

      # clresource create -g websphere-mq-resource-group  \
      -t SUNW.HAStoragePlus \
      -p FilesystemMountPoints=websphere-mq-filesystem-mountpoint \
      websphere-mq-hastorage-resource

6. Bring online the failover resource group for IBM MQ that now includes the Logical Hostname and Disk Storage resources.

   # clresourcegroup online -M websphere-mq-resource-group

7. Create a resource for the IBM MQ queue manager.

   Edit /opt/SUNWscmqs/mgr/util/mgr_config and follow the comments within that file. After you have edited mgr_config, you must register the resource.

   # cd /opt/SUNWscmqs/mgr/util
   # vi mgr_config
   # ./mgr_register

   The following example shows the /opt/SUNWscmqs/mgr/util/mgr_config file that has been edited to configure a queue manager resource.

   # cat > /var/tmp/mgr1_config <<-EOF
   # +++ Required parameters +++
   RS=wmq1-qmgr
   RG=wmq1-rg
   QMGR=qmgr1
   LH=wmq1-lh
   HAS_RS=wmq1-ZFShas
   LSR_RS=
   CLEANUP=YES
   SERVICES=NO
   USERID=mqm
   
   # +++ Optional parameters +++
   DB2INSTANCE=
   ORACLE_HOME=
   ORACLE_SID=
   START_CMD=
   STOP_CMD=
   RS_ZONE=
   PROJECT=default
   TIMEOUT=300
   EOF

   # /opt/SUNWscmqs/mgr/util/mgr_register -f /var/tmp/mgr1_config

8. Enable the resource.

   # clresource enable websphere-mq-resource

9. Create and register a resource for any other IBM MQ components.

   Repeat this step for each IBM MQ component that is required.

   Edit /opt/SUNWscmqs/xxx/util/xxx_config and follow the comments within that file. Where xxx represents one of the following IBM MQ components:

   chi		Channel Initiator
   csv		Command Server
   lsr		Listener
   trm		Trigger Monitor

   After you have edited xxx_config, you must register the resource.

   # cd /opt/SUNWscmqs/xxx/util/
   # vi xxx_config
   # ./xxx_register

   The following example shows the /opt/SUNWscmqs/lsr/util/lsr_config file that has been edited to configure a listener resource.

   # cat > /var/tmp/lsr1_config <<-EOF
   # +++ Required parameters +++
   RS=wmq1-lsr
   RG=wmq1-rg
   QMGR=qmgr1
   PORT=1414
   IPADDR=
   BACKLOG=100
   LH=wmq1-lh
   QMGR_RS=wmq1-qmgr
   USERID=mqm
   RS_ZONE=
   PROJECT=default
   EOF

   # /opt/SUNWscmqs/lsr/util/lsr_register -f /var/tmp/lsr1_config

10. Enable the IBM MQ component resources.

    # clresource enable websphere-mq-resource

Next Steps

See Verifying the HA for WebSphere MQ Installation and Configuration.