How to Register and Configure Sun Cluster HA for WebSphere MQ in a Failover Zone

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

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

Perform this procedure on one node of the cluster only.

1. Create a failover resource group for WebSphere MQ.

   Follow steps 1, 2, 3, 4, 5 and 6 in How to Register and Configure Sun Cluster HA for WebSphere MQ in a Failover Resource Group.

2. Register the failover zone in the failover resource group for WebSphere MQ.

   Refer to Sun Cluster Data Service for Solaris Containers Guide for complete information about failover zones.

   Edit the sczbt_config file and follow the comments within that file. Ensure that you specify the websphere-mq-resource-group for the RG= parameter within sczbt_config.

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

   # cd /opt/SUNWsczone/sczbt/util # vi sczbt_config # ./sczbt_register

   The following deployment example has been taken from Step 7 in Appendix B, Deployment Example: Installing aWebSphere MQ Queue Manager in a Failover Zone and shows /opt/SUNWsczone/sczbt/util/sczbt_config that has been edited to configure a failover zone resource.

   Vigor5# cat > /var/tmp/sczbt_config <<-EOF RS=wmq3-FOZ RG=wmq3-rg PARAMETERDIR=/FOZones SC_NETWORK=true SC_LH=wmq3-lh FAILOVER=true HAS_RS=wmq3-SVMhas,wmq3-ZFShas Zonename=z3 Zonebootopt= Milestone=multi-user-server Mounts="/ZFSwmq3/log /ZFSwmq3/qmgrs" EOF Vigor5# Vigor5# /opt/SUNWsczone/sczbt/util/sczbt_register -f /var/tmp/sczbt_config

3. Enable the failover zone resource

   # clresource enable websphere-mq-failover-zone-resource

4. Create a resource for the WebSphere MQ queue manager resource

   Edit /opt/SUNWscmqs/mgr/util/mgr_config and follow the comments within that file. Ensure that the RS_ZONE variable specifies the cluster resource for the failover zone. After you have edited mgr_config, you must register the resource.

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

   The following deployment example has been taken from Step 1 in Appendix B, Deployment Example: Installing aWebSphere MQ Queue Manager in a Failover Zone and shows /opt/SUNWscmqs/mgr/util/mgr_config that has been edited to configure a queue manager resource within a failover zone resource.

   Vigor5# cat > /var/tmp/mgr3_config <<-EOF # +++ Required parameters +++ RS=wmq3-qmgr RG=wmq3-rg QMGR=qmgr3 LH=wmq3-lh HAS_RS=wmq3-ZFShas LSR_RS= CLEANUP=YES SERVICES=NO USERID=mqm # +++ Optional parameters +++ DB2INSTANCE= ORACLE_HOME= ORACLE_SID= START_CMD= STOP_CMD= # +++ Failover zone parameters +++ # These parameters are only required when WebSphere MQ should run # within a failover zone managed by the Sun Cluster Data Service # for Solaris Containers. RS_ZONE=wmq3-FOZ PROJECT=default TIMEOUT=300 EOF Vigor5# Vigor5# /opt/SUNWscmqs/mgr/util/mgr_register -f /var/tmp/mgr1_config

5. Enable the WebSphere MQ resource.

   # clresource enable websphere-mq-resource

6. Create and register a resource for any other WebSphere MQ components.

   Repeat this step for each WebSphere 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 WebSphere MQ components:

   chi		Channel Initiator
   csv		Command Server
   lsr		Listener
   trm		Trigger Monitor

   Ensure that the RS_ZONE variable specifies the cluster resource for the failover zone. After you have edited xxx_config, you must register the resource.

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

   The following deployment example has been taken from Step 4 in Appendix A, Deployment Example: Installing a WebSphere MQ Queue Manager in Non-Global Zones and shows a modified /opt/SUNWscmqs/lsr/util/lsr_config that has been edited to configure a listener resource in a failover zone resource.

   Vigor5# cat > /var/tmp/lsr3_config <<-EOF # +++ Required parameters +++ RS=wmq3-lsr RG=wmq3-rg QMGR=qmgr3 PORT=1420 IPADDR= BACKLOG=100 LH=wmq3-lh QMGR_RS=wmq3-qmgr3 USERID=mqm # +++ Failover zone parameters +++ # These parameters are only required when WebSphere MQ should run # within a failover zone managed by the Sun Cluster Data Service # for Solaris Containers. RS_ZONE=wmq3-FOZ PROJECT=default EOF

   Vigor5# /opt/SUNWscmqs/lsr/util/lsr_register -f /var/tmp/lsr3_config

7. Enable the WebSphere MQ component resources.

   # clresource enable websphere-mq-resource

Next Steps

See Verifying the Sun Cluster HA for WebSphere MQ Installation and Configuration