[Windows][Linux]

IBM MQ Explorer を使用した MQ Telemetry のインストールの検査

IBM® MQ Explorer の「サンプル構成の定義」ウィザードと MQTT クライアント・ユーティリティーを使用して、 MQ Telemetry コンポーネントがインストールされていることを確認します。 また、パブリッシュ/サブスクライブが正しく動作することを確認します。

始める前に

MQ Telemetry ランタイムおよび IBM MQ Explorer のサポートがインストールされている必要があります。 テレメトリー・フォルダーは、キュー・マネージャーの一部です。 テレメトリー・フォルダーを表示するには、キュー・マネージャーを開始する必要があります。

既存のキュー・マネージャーで「サンプル構成の定義」ウィザードを実行するには、その前に、行われる構成変更に関する、ウィザードによって提供された情報を検討します。 変更が既存のキュー・マネージャーの構成に影響を与える場合があります。 あるいは、セキュリティー設定が変更されないように、新しく作成したキュー・マネージャーに対してサンプル構成ウィザードを実行してください。

本タスクについて

MQ Telemetry を構成するために、 IBM MQ Explorerから実行できるサンプル構成定義ウィザードがあります。 このウィザードは、遠隔測定 (MQXR) サービスの定義と開始、デフォルト伝送キューのセットアップ、遠隔測定チャネルの構成などの一連のステップを進めていきます。

この操作を手動で行う場合は、Linux® および AIX® でテレメトリーを行うためのキュー・マネージャーの構成を参照してください。 Windowsについては、 Windows 上のテレメトリー用のキュー・マネージャーの構成 を参照してください。

サンプル構成の定義ウィザードは、 IBM MQ Explorerの MQ Telemetry ウェルカム・ページから開くことができます。 ウィザードは、現行構成に基づいて、どのステップが必要かを判別します。

例えば、ウィザードによって以下のようなアクションが特定される場合があります。

  • 遠隔測定 (MQXR) サービスを定義する
  • 遠隔測定 (MQXR) サービスを開始する
  • 遠隔測定送信キューを定義する
  • キュー・マネージャーのデフォルト送信キューを SYSTEM.MQTT.TRANSMIT.QUEUEに設定します。

このキュー・マネージャー用のテレメトリーが既に構成されている場合は、ウィザードを開くためのリンクが静的テキストに置き換えられます。 このテキストで、サンプル構成がセットアップ済みであることが示されます。

構成が完了したら、 IBM MQ Explorer を使用して MQTT クライアント・ユーティリティーを開くことができます。 MQTT クライアント・ユーティリティーを使用して、 MQ Telemetry が正しくセットアップされていることを確認します。

以下の項目は、 MQTT クライアント・ユーティリティーを使用して達成できる主な目標を要約しています。

  • 接続、トピックへのサブスクライブ、およびメッセージのパブリッシュによる、基本またはカスタムの MQ Telemetry 構成の検証。
  • MQTT protocolの主な機能を紹介します。
  • MQ Telemetry アプリケーションのデバッグに役立つ単純なツールを提供します。

「ヘルプ」 メニューを使用するか、 F1 キーを押すと、 IBM MQ Explorer 内の追加情報を見つけることができます。

手順

  1. IBM MQ Explorer を始動します。

    Windows および Linux システムでは、システム・メニュー、 MQExplorer 実行可能ファイル、 mqexplorer コマンド、または strmqcfg コマンドを使用して IBM MQ Explorer を開始できます。

  2. 「 MQ Telemetry へようこそ」 ページを開きます。
    • 既存のキュー・マネージャーを使用するには、IBM MQ\Queue Managers\qMgrName\Telemetry フォルダーをクリックして 「MQ テレメトリーへようこそ」 ページを開きます。
    • 前述の理由で、新しいキュー・マネージャーを使用する場合は、以下のようにします。
      1. キュー・マネージャー > ニュー > キュー・マネージャーをクリックします。
      2. 「キュー・マネージャー名」 > 「次へ」 > 「次へ」 > 「次へ」として MQTTVerification と入力します。
      3. ポートが使用中の場合は、「listen するポート番号」でデフォルトのポートを変更し、>「完了」を選択します。
      4. キュー・マネージャーが開始したら、IBM MQ\Queue Managers\MQTTVerification\Telemetry フォルダーをクリックして 「MQ テレメトリーへようこそ」 ページを開きます。
  3. IBM MQ Explorerの 「 MQ Telemetry へようこそ」 ページで、 「サンプル構成の定義」をクリックします。

    このリンクが存在せず、代わりに「このキュー・マネージャー用にサンプル構成がセットアップされています (The sample configuration has been set up for this queue manager)」というテキストが表示された場合は、テレメトリーは既に構成されています。 ステップ 6に進みます。

    「サンプル構成の定義」をクリックすると、そのページが開き、サンプル構成の一部として実行されるアクションがリスト表示されます。

  4. MQTT クライアント・ユーティリティーを自動的に開始する場合は、 「 MQTT クライアント・ユーティリティーの起動」 にチェック・マークを付けます。 デフォルトでは、チェック・ボックスは選択済みになっています。
  5. 「終了」をクリックします。
  6. 「接続」をクリックします。

    MQTT クライアント・ユーティリティー・パネルで、ホスト名とポート名が正しいことを確認します。

    ステップ 4 で MQTT クライアント・ユーティリティー・パネルを自動的に開始しなかった場合は、 「 MQ Telemetry へようこそ」 パネルから直接リンクを使用するか、非 TLS チャネルを右クリックして開始することができます。これにより、そのチャネルが実行されるチャネルを制御できます。

    クライアント・ヒストリーには、Connectedイベント。

  7. 「サブスクライブ」をクリックします。

    クライアント・ヒストリーには、Subscribedイベント。

  8. 「公開」をクリックします。

    クライアント・ヒストリーには、PublishedおよびReceivedイベント。

結果

パブリッシュ/サブスクライブが正常に終了すると、 MQ Telemetry のインストールが検証されます。

インストールの処理中に問題が発生した場合は、エラー・ログを表示します。

  • Windows では、このログのデフォルトの場所は IBM MQ data directory\qmgrs\qMgrName\mqxr です
  • AIX および Linux では、このログのデフォルトの場所は /var/mqm/qmgrs/qMgrName/mqxr/ です