IBM MQコンソールを使用したMQのセットアップ
。
MQ コンソール (または MQ Web UI) は、キューマネージャやキューなどの MQ オブジェクトを視覚化して管理することができる、強力なブラウザ内のユーザーインターフェースです。その内部では、キューマネージャやキューの作成、メッセージの確認、権限やプロパティの設定などを行うことができます。
管理者は、MQコンソールを使用してキュー・マネージャを管理します。 開発者は、MQ コンソールを使用して、クライアントアプリケーションをテストおよびデバッグすることができます。
このチュートリアルでは、IBM MQ コンソールを設定し、アクセスし、それを使用して MQ オブジェクトを表示および編集する方法を紹介します。
前提条件¶
まず、MQ をインストールするか、コンテナやクラウド上で実行する必要があります。Ready, Set, Connect_シリーズのリストからプラットフォームを選んでください。これらの各チュートリアルの最後のステップは、このチュートリアルに戻ります。 (MQをクラウドで運用している場合は、このチュートリアルを使う必要はありません。代わりに、_IBM Cloud docsのチュートリアルをご利用ください)。
LinuxまたはWindows用のMQをインストールした場合、このチュートリアルに従うことで、コンソールを設定し、その強力な機能を使用することができます。このチュートリアルでは、Linux(Ubuntu)用の具体的なコマンドを紹介しますが、原理はすべてのプラットフォームに適用され、コマンドは他のプラットフォームでも少しの変更で動作するはずです。Windowsを使用している場合は、この_IBM Docs_ articleに、使用すべきMQデータパスが記載されています。
見積もり時間¶
このチュートリアルの完了には約30分かかります。
手順¶
MQをクラウドで運用している場合、このチュートリアルは必要ありません。代わりに、IBM Cloud docsのチュートリアルをご利用ください。
MQをコンテナで実行している場合、MQのインストール時にMQコンソールが事前に設定されているため、このチュートリアルのステップ2から始めることができます。
コンソールでは、クライアントとしてブラウザで接続されたユーザーが、MQのインストールを管理、変更、および保護することができるため、ユーザーがこれらのタスクを実行する権限を持っていることを確認することが重要です。そのためには、トークン認証またはクライアント証明書認証が必要です。このチュートリアルでは、トークン認証を設定する方法を紹介しますが、証明書認証を使用したい場合は、この_IBM Docs_ articleに有用な情報があります。
MQコンソールにアクセスする方法(ステップ2)と、MQコンソールを使用してMQオブジェクトを表示・編集する方法(ステップ3)を動画で見たいという方は、こちらをご覧ください。
Step 1: MQコンソールの設定¶
MQをコンテナで実行する場合は、MQのインストール時にMQコンソールが事前に設定されているため、このステップをスキップしてステップ2から始めることができます。
ここではまず、サンプルの設定を使用します。sampleディレクトリに移動して、basic_registry.xml
をMQ webディレクトリにコピーします。
このbasic_registry.xml
ファイルの中には、使用したいアクセスグループが定義されていて、その他の基本的な設定もあります。
デフォルトでは、MQコンソールを実行しようとすると、mqwebuser.xml
ファイルの内容が使用されます。先ほどコピーしたサンプルコードを代わりに使用したいので、この不要なファイルの名前を変更し、basic_registry.xml
の名前をmqwebuser.xml
に変更します。
また、このファイルには書き込み権限が必要ですが、現在は持っていません。これは今のところありませんが、これを与えてみましょう。
これで、mqwebuser.xml
ファイルへの書き込みアクセスが可能になったことを確認してください。
現在、コンソールにはローカルでしかアクセスできません。もし、他の場所からMQコンソールにアクセスできるようにしたい場合は、これを許可する必要があります。これには、コマンドラインツールの setmqweb
を使用します。
これで、ユーザが正しいユーザ名とパスワードを知っていれば、どの場所からでもコンソールにアクセスできるようになりました。
コンソールは現在起動していません。コンソールを起動するには、単に strmqweb
と入力してください。 次のような出力が表示されるはずです。
コンソールが利用できるURLを見るには、dspmqweb
と入力してください。このような出力が表示されるはずです。
成功です。サインインして、コンソールを使ってみましょう。
Step 2: MQ コンソールへのアクセス¶
https://localhost:9443/ibmmq/console
に移動します。ブラウザが安全でない接続について警告します。これは、MQ を実行しているサーバーがデフォルトで自己署名証明書を使用しているためで、ここでは警告を受け入れてコンソールに進んでも問題ありません。(独自の自己署名証明書またはCA署名証明書をブラウザに提供したい場合は、この_IBM Docs_記事を参照してください。
ブラウザで続行することを確認すると、サインインページが表示され、ユーザー名とパスワードの入力を求められます。使用しているMQのプラットフォームとバージョンに応じて、特定のユーザー名とパスワードでサインインする必要があります。
プラットフォーム | MQバージョン | 認証情報 |
---|---|---|
Containers/Docker | Any | Username: admin Password: passw0rd |
LinuxまたはWindows | 9.0.2以上 | ユーザー名:mqadmin パスワード:mqadmin |
LinuxまたはWindows | 9.0.1以下 | ユーザー名:admin パスワード:admin |
クラウド | 任意 | MQコンソールの使用に関するこのクラウドチュートリアルには、必要な情報がすべて含まれています。 コンソールは、キュー・マネージャーのダッシュボードの "Administration "タブの下にあります。 |
さて、あなたはコンソールの中にいるはずです!
Step 3: MQ コンソールを使った MQ オブジェクトの表示と編集¶
コンソールでは、すべてのMQオブジェクトを表示・編集したり、他のオブジェクトを作成することができます。また、ユーザーやオブジェクトごとに権限を設定することもできます。MQコンソールの完全なツアーは、この_IBM Docs_の記事にありますが、ここでは基本的な操作を説明します。
これでコンソールのスタートページが表示されるはずです。MQの管理、オブジェクトの作成、いくつかの教育アイテムなどのオプションがあるタイルが表示されます。「管理」を選択すると、キュー・マネージャーのリストが表示されます。ここから作成したり管理したりすることができます。QM1のようなキュー・マネージャーを選択すると、下の画像のように、このキュー・マネージャーに関連するキューやその他のオブジェクトが表示されます。
ここから、"Create "オプションを使って、独自のキューを作成することができます。また、以下のように、個々のキューを選択することで、既存のキューのメッセージを見ることができます。
このページの「Create」オプション(ここでは「create a new message」の意味)を使って、このキューにメッセージを入れることができます。Application data "フィールドには、メッセージの内容が入ります。「Create」をクリックすると、メッセージがキューに入ります。
これで、MQコンソールの設定が完了しました。MQコンソールは、メッセージングシステムの管理と可視化に役立ちます。
まとめ¶
このチュートリアルでは、MQコンソールについて説明しました。コンソールを設定し、アクセスし、メッセージをキューに入れるために使用しました。
もっと詳しく知りたい方は、この IBM Docs articleで、MQ Console に関連するすべての機能とオプションの概要を説明しています。