構成に関する要件 (Sun Cluster Data Service for WebSphere MQ ガイド (Solaris OS 版))

Sun Cluster Data Service for WebSphere MQ ガイド (Solaris OS 版)

構成に関する要件

ここで説明する要件が適用されるのは、Sun Cluster HA for WebSphere MQ に限られます。Sun Cluster HA for WebSphere MQ のインストールと構成を始める前に、次の要件を満たしておく必要があります。

注意 –

次の要件を満たさないと、データサービスの構成がサポートされない場合があります。

WebSphere MQ コンポーネントと依存関係 — Sun Cluster HA for WebSphere MQ データサービスは、WebSphere MQ インスタンスとそれぞれのコンポーネントを保護するように構成できます。ここでは、このようなコンポーネントとその依存関係について説明します。

構成要素	説明
Queue Manager `(必須)`	-> SUNW.HAStoragePlus リソース SUNW.HAStoragePlus リソースは、WebSphere MQ ファイルシステムのマウントポイントを管理し、WebSphere MQ がマウント後に起動することを保証します。
Channel Initiator `(任意)`	-> Queue_Manager および Listener リソース Listener に依存しなければならないのは、inetd の代わりに runmqlsr を使用する場合だけです。デフォルトでは、WebSphere MQ が Channel Initiator を起動します。ただし、デフォルト (SYSTEM.CHANNEL.INITQ) 以外の別のチャネル開始キューが必要な場合は、このコンポーネントを配備するべきです。
Command Server `(任意l)`	-> Queue_Manager および Listener リソース Listener に依存しなければならないのは、inetd の代わりに runmqlsr を使用する場合だけです。このコンポーネントは、コマンドキューに送られたコマンドを処理するために WebSphere MQ が必要な場合です。
Listener `(任意)`	->Queue_Manager リソースこのコンポーネントを配備するのは、専用のリスナー `(runmqlsr)` が必要で、inetd リスナーを使用しない場合です。
Trigger Monitor `(任意)`	->Queue_Manager および Listener リソース Listener に依存しなければならないのは、inetd の代わりに runmqlsr を使用する場合だけです。このコンポーネントを配備するのは、トリガーモニターが必要な場合です。

注 –

各 WebSphere MQ コンポーネントの詳細は、IBM の WebSphere MQ Application Programming マニュアルを参照してください。

各 WebSphere MQ コンポーネントは、/opt/SUNWscmqs/xxx/util に構成/登録ファイルがあります。xxx は個々の WebSphere MQ コンポーネントを表す 3 文字の略語です。これらのファイルによって、Sun Cluster に WebSphere MQ コンポーネントを登録できます。

これらのファイル内では、適切な依存関係が適用されます。

# cd /opt/SUNWscmqs
# 
# ls -l chi/util
total 4
-rwxr-xr-x   1 root     sys          720 Dec 20 14:44 chi_config
-rwxr-xr-x   1 root     sys          586 Dec 20 14:44 chi_register
# 
# ls -l csv/util
total 4
-rwxr-xr-x   1 root     sys          645 Dec 20 14:44 csv_config
-rwxr-xr-x   1 root     sys          562 Dec 20 14:44 csv_register
# 
# ls -l lsr/util
total 4
-rwxr-xr-x   1 root     sys          640 Dec 20 14:44 lsr_config
-rwxr-xr-x   1 root     sys          624 Dec 20 14:44 lsr_register
# 
# ls -l mgr/util
total 4
-rwxr-xr-x   1 root     sys          603 Dec 20 14:44 mgr_config
-rwxr-xr-x   1 root     sys          515 Dec 20 14:44 mgr_register
# 
# ls -l trm/util
total 4
-rwxr-xr-x   1 root     sys          717 Dec 20 14:44 trm_config
-rwxr-xr-x   1 root     sys          586 Dec 20 14:44 trm_register
# 
# 
# more mgr/util/*
::::::::::::::
mgr_config
::::::::::::::
#
# Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
# 
# This file will be sourced in by mgr_register and the parameters
# listed below will be used.
#
# These parameters can be customized in (key=value) form
#
#          RS - name of the resource for the application
#          RG - name of the resource group containing RS
#        QMGR - name of the Queue Manager
#        PORT - name of the Queue Manager port number
#          LH - name of the LogicalHostname SC resource
#      HAS_RS - name of the Queue Manager HAStoragePlus SC resource
#     CLEANUP - Cleanup IPC entries YES or NO (Default CLEANUP=YES)
#      USERID - name of userid to issue strmqm/endmqm commands 
#               (Default USERID=mqm)
#
#       +++ Optional parameters +++
#
# DB2INSTANCE - name of the DB2 Instance name
# ORACLE_HOME - name of the Oracle Home Directory
#  ORACLE_SID - name of the Oracle SID
#   START_CMD - pathname and name of the renamed strmqm program
#    STOP_CMD - pathname and name of the renamed endmqm program
#
# Note 1: Optional parameters
#
#       Null entries for optional parameters are allowed if not used.
#
# Note 2: XAResourceManager processing
#
#       If DB2 will participate in global units of work then set
#       DB2INSTANCE=
#
#       If Oracle will participate in global units of work then set
#       ORACLE_HOME=
#       ORACLE_SID=
#
# Note 3: Renamed strmqm/endmqm programs
#
#       This is only recommended if WebSphere MQ is deployed onto 
#       Global File Systems for qmgr/log files. You should specify 
#       the full pathname/program, i.e. /opt/mqm/bin/<renamed_strmqm>
#
# Note 4: Cleanup IPC
#
#       Under normal shutdown and startup WebSphere MQ manages it's
#       cleanup of IPC resources with the following fix packs.
#
#       MQSeries v5.2 Fix Pack 07 (CSD07) or later
#       WebSphere MQ v5.3 Fix Pack 04 (CSD04) or later
#
#       Please refer to APAR number IY38428.
#
#       However, while running in a failover environment, the IPC keys
#       that get generated will be different between nodes. As a result
#       after a failover of a Queue Manager, some shared memory segments
#       can remain allocated on the node although not used. 
#
#       Although this does not cause WebSphere MQ a problem when starting
#       or stopping (with the above fix packs applied), it can deplete
#       the available swap space and in extreme situations a node may 
#       run out of swap space. 
#
#       To resolve this issue, setting CLEANUP=YES will ensure that 
#       IPC shared memory segments for WebSphere MQ are removed whenever
#       a Queue Manager is stopped. However IPC shared memory segments 
#       are only removed under strict conditions, namely
#
#       - The shared memory segment(s) are owned by
#               CREATOR=mqm and CGROUP=mqm
#       - The shared memory segment has no attached processes
#       - The CPID and LPID process ids are not running
#       - The shared memory removal is performed by userid mqm
#
#       Setting CLEANUP=NO will not remove any shared memory segments.
#
#       Setting CLEANUP=YES will cleanup shared memory segments under the
#       conditions described above.
#

RS=
RG=
QMGR=
PORT=
LH=
HAS_RS=
CLEANUP=YES
USERID=mqm
DB2INSTANCE=
ORACLE_HOME=
ORACLE_SID=
START_CMD=
STOP_CMD=
::::::::::::::
mgr_register
::::::::::::::
#
# Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#

. `dirname $0`/mgr_config

scrgadm -a -j $RS -g $RG -t SUNW.gds \
-x Start_command="/opt/SUNWscmqs/mgr/bin/start-qmgr \
-R $RS -G $RG -Q $QMGR -C $CLEANUP \
-U $USERID -D '$DB2INSTANCE' -O '$ORACLE_HOME' -I '$ORACLE_SID' \
-S '$START_CMD' -E '$STOP_CMD' " \
-x Stop_command="/opt/SUNWscmqs/mgr/bin/stop-qmgr \
-R $RS -G $RG -Q $QMGR -C $CLEANUP \
-U $USERID -D '$DB2INSTANCE' -O '$ORACLE_HOME' -I '$ORACLE_SID' \
-S '$START_CMD' -E '$STOP_CMD' " \
-x Probe_command="/opt/SUNWscmqs/mgr/bin/test-qmgr \
-R $RS -G $RG -Q $QMGR -C $CLEANUP \
-U $USERID -D '$DB2INSTANCE' -O '$ORACLE_HOME' -I '$ORACLE_SID' \
-S '$START_CMD' -E '$STOP_CMD' " \
-y Port_list=$PORT/tcp -y Network_resources_used=$LH \
-x Stop_signal=9 \
-y Resource_dependencies=$HAS_RS
#

WebSphere MQ Manager の保護—

WebSphere MQ インスタンス、すなわち /global/mqm/qmgrs/<qmgr> および /global/mqm/log/<qmgr> に広域ファイルシステムを使用している場合、WebSphere MQ は Sun Cluster 内の別のノード上ですでに Queue Manager が稼働しているかどうかを判別できません。

通常は使用しているクラスタファイルシステム (すなわち FFS なのか GFS なのか) に関係なく、Sun Cluster HA for WebSphere MQ データサービスが Queue Manager の起動と停止を管理します。

しかし、WebSphere MQ インスタンスが広域ファイルシステム上で稼働しているときに、だれかが Sun Cluster 内の別のノードで Queue Manager を手動で起動する可能性もあります。

注 –
この問題は IBM に報告済みであり、現在、修正作業中です。

この問題を回避する方法は 2つあります。
1. WebSphere MQ インスタンスにフェイルオーバーファイルシステムを使用します。
  
  WebSphere MQ インスタンスファイルをマウントできるのが、1 時点で 1 ノードだけになるので、この方法を推奨します。この構成の場合、WebSphere MQ は Queue Manager が稼働しているかどうかを判別できます。
2. strmqm/endmqm にシンボリックリンクを作成して check-start (提供スクリプト) を実行します。
  
  /opt/SUNWscmqs/mgr/bin/check-start によって、WebSphere MQ Manager が起動または停止されることがないよう防止されます。
  
  check-start スクリプトは、WebSphere MQ Manager が Sun Cluster によって起動または停止されることを確認し、手動で WebSphere MQ Manager の起動または停止が試行されるとエラーを報告します。
  
  例 3 に、WebSphere MQ Manager を手動で起動しようとする場合を示します。応答は check-start スクリプトによって生成されています。
  
  注意 –
  Sun Cluster HA for WebSphere MQ データサービスのホストとなるクラスタノードごとに、この作業を行う必要があります。crtmqm が代わりに strmqm と endmqm を呼び出すので、Queue Manager を作成するまではこの手順を実行しないでください。
  
  注 –
  この回避方法を採用した場合、WebSphere MQ のメンテナンスが必要になるたびに、元に戻さなければなりません。その後、再びこの回避方法を適用する必要があります。WebSphere MQ が修正されるまでの間は、WebSphere MQ インスタンスにフェイルオーバーファイルシステムを使用するよう推奨します。

例 3 誤って WebSphere MQ Manager を手動で起動しようとした場合

# strmqm qmgr1
# Request to run </usr/bin/strmqm qmgr1> within SC3.0 has been refused
#

この方法を使用しなければならないのは、WebSphere MQ インスタンスに広域ファイルシステムが必要な場合だけです。例 4 に、この場合に必要な手順の詳細を示します。

例 4 strmqm および endmqm で check-start を実行するためのシンボリックリンクの作成

# cd /opt/mqm/bin
#
# mv strmqm strmqm_sc3
# mv endmqm endmqm_sc3
#
# ln -s /opt/SUNWscmqs/mgr/bin/check-start strmqm
# ln -s /opt/SUNWscmqs/mgr/bin/check-start endmqm
#

/opt/SUNWscmqs/mgr/etc/configファイルを編集し、START_COMMAND と STOP_COMMAND の以下のエントリを変更します。この例では、_sc3 を使用してコマンド名に接尾辞を追加しています。別の名前も選択できます。

# cat /opt/SUNWscmqs/mgr/etc/config
# Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
# Usage:
#       DEBUG=<RESOURCE_NAME> or ALL
#       START_COMMAND=/opt/mqm/bin/<renamed_strmqm_program>
#       STOP_COMMAND=/opt/mqm/bin/<renamed_endmqm_program>
#
DEBUG=
START_COMMAND=/opt/mqm/bin/strmqm_sc3
STOP_COMMAND=/opt/mqm/bin/endmqm_sc3
#