WebSphere MQ のトラブルシューティング

内容
apmdevops96jp
内容
この付録は、CA APM for IBM WebSphere MQ でトラブルシューティングの問題が発生した場合のソリューションを提供します。
エラーおよびトラブルシューティング手順
以下のリストでは、エラー、考えられるエラーの原因、およびトラブルシューティングの手順を示します。
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.TracerDriverThread] MQMonitor: For configuration instance @localhost and the drivers(manager, manager) an error occurred in sending a query to MQ. The target MQ (localhost:19100) is down. Reason code 2035 MQRC_NOT_AUTHORIZED
原因:
MQMonitor エージェントを実行しているユーザには、MQMonitor エージェントを実行し、キュー マネージャに接続するための適切な権限がありません。
アクション
以下の
いずれか
の操作を行います。
  • MQMonitor エージェントによって使用されるサーバ接続チャネルが CLIENT.WILY であり、MCA ユーザ ID がユーザ Wily に設定されている場合、MQMonitor エージェントが問題なくキュー マネージャに接続できるようにするには、ユーザ「Wily」が
    mqm
    グループのメンバになる必要があります。
  • MCA ユーザ ID を空白のまま残して、ユーザ ID が PCF API によってデフォルト値の MQADMIN に設定されるようにします。これにより、
    mqm
    グループの一部になります。
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.TracerDriverThread] MQMonitor: For configuration instance @ and the drivers(queue, queue, queue, queue, queue, queue) an error occurred in sending query to MQ. The target MQ (localhost:3414) may be down. Reason code 2397 MQRC_JSSE_ERROR
原因:
MQMonitor.properties
ファイルで提供されるトラストストア パスやキーストア パス、またはパスワードが正しくないことを示しています。 また、証明書の有効期限など、WebSphere MQ サーバとクライアント(MQMonitor エージェント)間の証明書の作成または交換に問題があることを示す場合もあります。
アクション
MQMonitor properties ディレクトリの下にある
IntroscopeAgent.profile
ファイルで、次の行からコメント「#」を削除します。
#log4j.logger.com.wily.powerpack.websphereMQ.agent.MQMonitor.TracerDriverThread=DEBUG
これにより、使用されているトラストストア パス、キーストア パス、証明書、およびそれらの有効期限日などの詳細を含む SSL ハンドシェイク デバッグ ステートメントが表示されます。 この情報は、JSSE エラーの原因を特定するのに役立ちます。
[ERROR] TraceManager.startUp ClassNotFoundException: Activity report parsing classes are not available. Ensure to have PCF JAR file from latest MS0B support pack.
原因:
正しくないバージョンの PCF JAR ファイルが使用されました。
アクション
ms0b.zip ファイル内の
com.ibm.mq.pcf-6.1.jar
ファイルが使用されていることを確認します。 詳細については、「サードパーティ ライブラリの取得」を参照してください。
[ERROR]sun.io.MalformedInputException at sun.io.ByteToCharUTF8.convert(ByteToCharUTF8.java(Compiled Code))
原因:
ロケール固有の環境変数に、サフィックス「.UTF-8」が含まれています。
アクション
すべての UNIX 系オペレーティング システムで、以下の手順を実行します。
  1. LANG、LC_ALL などのロケール固有の環境変数を確認します。 「locale」コマンドを実行することによってこれらの詳細を取得できます。
  2. サフィックス .UTF-8 が存在する場合は、ロケール固有の環境変数からこのサフィックスを削除します。
  3. たとえば、LANG=en_US.UTF-8 を LANG=en_US に変更します。
  4. MQMonitor エージェントを開始します。
[DEBUG] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.MBTreeConfigMain] User is not authorized to connect to queue manager (MQ reason code 2035 while trying to connect)
原因:
MQMonitor エージェントのユーザが、構成マネージャのキュー マネージャに接続することを許可されていません。
アクション
以下の手順を実行します。
  1. 以下のコマンドを使用して、構成マネージャのキュー マネージャに「allmqi」権限を適用します。
    setmqaut -m <CMPQMName> -t qmgr -p <userName@DomainName> +allmqi
  2. 以下のコマンドを使用して、同じキュー マネージャの SYSTEM.BROKER.CONFIG.QUEUE キューに「put」権限を適用します。
    setmqaut -m <CMPQMName>-n SYSTEM.BROKER.CONFIG.QUEUE -t queue - p <userName@DomainName> +put
[DEBUG] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.MBTreeConfigMain] ConfigManagerProxy information was not received from the Configuration Manager. Either the Configuration Manager is not available or the user 'userName\MachineName' does not have authority to view the object. (UUID='', required attribute='name')
[FATAL] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.MBTreeConfigMain] Configuration Manager is not initialized.
原因:
構成マネージャが使用できないか、ユーザのホスト名\ユーザ名にオブジェクトを表示する権限がありません (UUID='', required attribute='name')。
アクション
以下の手順を実行します。
  1. MBMonitor.properties
    ファイルを確認します。 また、CMP 認証情報も確認します。
  2. MQMonitor エージェントのユーザを、構成マネージャの ACL エントリに含めます。 ユーザを ACL エントリに含めるには、以下のコマンドを使用して構成マネージャおよび MQMonitor エージェントを再起動します。
    mqsicreateaclentry <ConfigurationManagerName> -u <user> -m <machine> -x F - p
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.BrokerStatistics] MQJMS1111: JMS1.1 The required Queues/Publish Subscribe services are not set up {0}
原因:
JMS ブローカ キュー マネージャに、発行/サブスクライブの前提条件となるキューがありません。
アクション
MBMonitorJMSQueues.mqsc
スクリプトを使用して JMS ブローカ キュー マネージャで前提条件となるすべての JMS キューを作成し、MQMonitor エージェントを再起動します。
runmqsc <QMName> <MBMonitorJMSQueues.mqsc
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.MBTreeMsgflowStatistics] MQJMS2013: invalid security authentication supplied for MQQueueManager.
原因:
JMS ブローカ キュー マネージャに適切なユーザ権限がありません。
アクション
以下の手順を実行します。
  1. MQMonitor エージェントを停止し、以下のコマンドを使用して JMS ブローカのキュー マネージャの権限を変更します。
  2. 以下のように、「allmqi」権限をキュー マネージャに適用します。
    setmqaut -m <JMSQMName> -t qmgr -p <userName@DomainName> +allmqi
  3. 「allmqi」権限をすべての JMS キューに適用します(すべての JMS キュー名は SYSTEM.JMS.* で始まります)。
    setmqaut -m <JMSQMName> -n <NameOfJMSQueue> -t queue -p <userName@DomainName> +allmqi
  4. MQMonitor ユーザがドメイン ユーザでない場合は、MQ サーバで同じユーザを作成し、このユーザに権限を与えます。 この場合、ユーザ名によってドメイン名を指定せずに、ユーザの名前を与えます。
    setmqaut -m <JMSQMName> -t qmgr -p <userName> +allmqi
    キュー マネージャで権限を変更した後で、セキュリティを更新するか、またはキュー マネージャを再起動します。 また、MQMonitor エージェントも再起動します。
[FATAL] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.MBTreeConfigMain] Configuration Manager is not initialized.
[FATAL] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.MBTreeConfigMain] Start the Configuration Manager and run WebSphere MB agent again.
原因:
構成マネージャが使用できません。
アクション
MQMonitor エージェントを停止し、以下のコマンドを使用して構成マネージャをオンにします。
mqsistart <ConfigurationManagerName>
[INFO] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.MBTreeMsgflowStatistics] No Execution groups to monitor.
[INFO] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.BrokerStatistics] No Execution groups to monitor.
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.ExecutionGroupTracer] Statistics for all Execution groups are missing. WebSphere MB agent probably lost connection.
[INFO] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.ExecutionGroupTracer] WebSphere MB agent restart will be performed now.
原因:
MBMonitor.properties
ファイルで、
statistics.broker.list
プロパティにブローカが設定されていますが、同時にそのブローカで監視を行う実行グループが
<BROKER>.executiongroup
プロパティを使用して指定されていません。
アクション
statistics.broker.list
プロパティおよび
<BROKER1>.executiongroup
プロパティの値を確認します。
statistics.broker.list
が「all」以外の値に設定されている場合、同じブローカ名の
<BROKER1>.executiongroup
には同じ値が設定されている必要があります。
たとえば、以下の通りです。
statistics.broker.list=amqbroker_ca amqbroker_ca.executiongroup=amqbroker_ca_exegrp
ここで、
amqbroker_ca
はユーザが監視するブローカの名前であり、
amqbroker_ca_exegrp
はそのブローカで定義された実行グループです。
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.ExecutionGroupTracer] Statistics for all Execution groups are missing. WebSphere MB agent probably lost connection.
[INFO] [com.wily.powerpack.websphereMQ.agent.MQMonitor.MBMonitor.ExecutionGroupTracer] WebSphere MB agent restart will be performed now.
原因:
メッセージ フロー統計とブローカ統計が、WebSphere MB の実行グループに対して有効になっていません。
アクション
IBM コマンドを使用して、メッセージ フロー統計とブローカ統計が有効になっているかどうかを確認します。 メッセージ フロー統計とブローカ統計を有効にする方法の詳細については、このユーザ ドキュメントの WebSphere MB の設定のセクションを参照してください。
[WARN] [Manager.Agent] The agent WebSphere MQ and Message Broker Agent is reporting too many metrics (current=50000, max=50000). New metrics will not be accepted
原因:
50000 メトリックを超えるメトリックが送信されているため、MQMonitor エージェントによってレポートされるメトリックが Enterprise Manager によってクランプされています。 このために、新しいメトリックが Enterprise Manager によってレポートされません。
アクション
以下の
いずれか
の操作を行います。
  • IntroscopeEnterpriseManager.properties
    ファイルを開き、エージェントがレポートできるメトリック数の制限を増加します。 これは、プロパティの編集によって設定できます。
    introscope.enterprisemanager.agent.metrics.limit=50000
    Enterprise Manager を再起動します。
  • キュー マネージャ、キュー、チャネルなどの WebSphere MQ オブジェクトの監視レベルを下げます。 たとえば、キューの監視レベルを Minimum レベルに下げるには、以下のようにプロパティを設定します。
    <QueueManager name>@localhost.monitor.queue=minimum
    MQMonitor エージェントを再起動します。
[VERBOSE] [IntroscopeAgent.Agent] java.lang.ClassNotFoundException: com.wily.introscope.agent.extensions.trace.MapEnablingTracer
原因:
webspheremq-extra.pbd
が有効であるか、または
webspheremq.pbl
でコメント化が解除されていますが、SOA Performance Manager がインストールされていません。
アクション
以下の
いずれか
の操作を行います。
  • SOA 依存マップで MQ ノードを表示する場合は、SOA Performance Manager をインストールします。
    SOA 依存マップでの MQ ノードの表示に関する詳細については、SOA 依存マップ用のアプリケーションの設定および SOA 依存マップの Websphere MQ を参照してください。
  • SOA 依存マップで MQ ノードを表示しない場合は、
    webspheremq.pbl
    webspheremq-extra.pbd
    をコメント化して PBD を無効にし、Enterprise Manager を再起動して変更を有効にします。
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.TracerDriverThread] MQMonitor: An error occurred sending or processing an MQ PCF command. java.io.UnsupportedEncodingException: IBM-932 (CCSID)
原因:
使用されている JRE バージョンが IBM-932 エンコードをサポートしていません。
アクション
IBM-932 エンコードをサポートしている JRE バージョンを使用するようにします。
[ERROR] [com.wily.powerpack.websphereMQ.agent.MQMonitor.TracerDriverThread] MQMonitor: For configuration instance QM1 and the drivers(namelist,cluster) an error occurred in sending query to MQ. The target MQ (10.131.172.101:8002) may be down. Reason code 2059 MQRC_Q_MGR_NOT_AVAILABLE
原因:
MQMonitor.properties
のキュー マネージャ インスタンスのホスト、ポート、チャネル名、および CCSID の値が不正または不適切です。
アクション
MQMonitor.properties
のキュー マネージャ インスタンスのホスト、ポート、チャネル名、および CCSID に正しい値または適切な値を指定します。 英語以外の文字セットを使用している場合は、適切な CCSID を提供します。
<IBM WebSphereMQ Install Directory>/conv/table/ccsid.tbl
にアクセスし、適切な言語セクションの下にリストされた CCSID をすべて試みます。 たとえば、IBM WebSphere MQ が日本語版の場合は、
ccsid.tbl
ファイルの Japanese セクションに移動し、このセクションでリストされた CCSID をすべて試みます。