test

Sun Cluster Data Service for WebSphere MQ Guide for Solaris OS

ProcedureHow to Register and Configure Sun Cluster HA for WebSphere MQ in a Failover Resource Group

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.

Note –

Perform this procedure on one node of the cluster only.

  1. On a cluster member, become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.

  2. Register the following resource types.


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

  3. Create a failover resource group for WebSphere MQ.

    Note –

    Refer to Restriction for multiple WebSphere MQ instances for more information on the nodelist entry.


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

  4. Create a resource for the WebSphere 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 WebSphere 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 WebSphere MQ that now includes the Logical Hostname and Disk Storage resources.


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

  7. Create a resource for the WebSphere 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 deployment example has been taken from Step 1 in Appendix A, Deployment Example: Installing a WebSphere MQ Queue Manager in Non-Global Zones and shows /opt/SUNWscmqs/mgr/util/mgr_config that has been edited to configure a queue manager resource.


    Vigor5# 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=

# +++ 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=
PROJECT=default
TIMEOUT=300
EOF


    Vigor5# /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 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

    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 /opt/SUNWscmqs/lsr/util/lsr_config that has been edited to configure a listener resource.


    Vigor5# 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

# +++ 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=
PROJECT=default
EOF


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

  10. 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