はじめに
この『Sun Java SystemTM Message Queue 管理ガイド』では、システム管理者が Sun Java System Message QueueTM メッセージングシステムの設定と管理に必要な基本情報を提供しています。
対象読者
このマニュアルは、Message Queue 管理タスクを実行する必要がある管理者およびアプリケーション開発者を対象としています。Message Queue 管理者とは、Message Queue メッセージングシステム、特にシステムの中枢となるメッセージブローカの設定および管理の担当者のことです。
お読みになる前に
このマニュアルを読む前に、『Sun Java System Message Queue 3.7 UR1 技術の概要』に目を通し、Java メッセージの仕様書に従った Message Queue の実装、Message Queue サービスのコンポーネント、Message Queue アプリケーションの開発、配備、管理の基本的なプロセスに慣れてください。
マニュアルの構成
表 P–1 に、このマニュアルの内容について説明しています。
表 P–1 このマニュアルの内容|
部/章 |
説明 |
|---|---|
|
Message Queue 管理タスクとツールを説明します。 |
|
|
Message Queue 管理コンソールに精通するための実践的なチュートリアルを提供します。 |
|
|
Message Queue ブローカとクライアントの起動方法を説明します。 |
|
|
設定プロパティーの設定と読み込みの方法を説明し、ブローカの設定可能な部分に関する概略を示します。また、ファイルまたはデータベースを設定して持続機能を実行する方法も説明します。 |
|
|
ブローカ管理タスクを説明します。 |
|
|
物理的送信先に関する管理タスクを説明します。 |
|
|
パスワードファイル、認証、承認、および暗号化の管理など、セキュリティー関連のタスクを説明します。 |
|
|
オブジェクトストアを説明し、管理対象オブジェクト (接続ファクトリと送信先) に関連したタスクの実行方法について説明します。 |
|
|
Message Queue ブローカのクラスタの設定方法および管理方法を説明します。 |
|
|
Message Queue の監視機能の設定方法および使用方法を説明します。 |
|
|
メッセージサービスのパフォーマンスを分析し、最適化する技術を説明します。 |
|
|
Message Queue の共通の問題の原因の判断、および問題の解決に用いられる処置に関して提案を行います。 |
|
|
Message Queue のコマンドユーティリティーの構文と詳細を示します。 |
|
|
Message Queue メッセージブローカの設定プロパティーを説明します。 |
|
|
物理的送信先の設定プロパティーを説明します。 |
|
|
管理対象オブジェクト (接続ファクトリと送信先) の設定プロパティーを説明します。 |
|
|
Message Queue リソースアダプタをアプリケーションサーバーで使用するための設定プロパティーを説明します。 |
|
|
Message Queue メッセージブローカが監視、調整、診断のために提供できるメトリックス情報を説明します。 |
|
|
Message Queue ファイルの、サポートされる各プラットフォームでの場所を一覧表示しています。 |
|
|
さまざまな Message Queue インタフェースの安定性を説明します。 |
|
|
Message Queue 通信に使用する HTTP (Hypertext Transaction Protocol) の設定方法および使用方法を説明します。 |
|
|
使用頻度の高い Message Queue コマンドユーティリティー (imqcmd) コマンドを一覧表示しています。 |
|
関連マニュアル
Message Queue マニュアルセットを構成するマニュアルを、通常使用する順で次の表に示します。
表 P–2 Message Queue マニュアルセット|
マニュアル |
対象読者 |
説明 |
|---|---|---|
|
開発者および管理者 |
Message Queue ソフトウェアの Solaris、Linux、Windows の各プラットフォームへのインストール方法を説明します。 |
|
|
開発者および管理者 |
新機能、制限、既知のバグ、および技術的な注意点を収録します。 |
|
|
開発者および管理者 |
Message Queue の概念、機能、コンポーネントを説明します。 |
|
|
『Sun Java System Message Queue 3.7 UR1 Developer’s Guide for Java Clients 』 |
開発者 |
Message Queue の JMS または SOAP/JAXM 仕様による実装を使用する Java クライアントプログラムの開発に関するクイックスタートチュートリアルとプログラミング情報を提供します。 |
|
管理者、および開発者にも推奨 |
Message Queue 管理ツールを使用した管理タスクの実行に必要な基本情報を提供します。 |
|
|
『Sun Java System Message Queue 3.7 UR1 Developer’s Guide for C Clients 』 |
開発者 |
JMS API (C-API) の Message Queue C 実装を使用した C クライアントプログラムの開発者向けに、プログラミングとリファレンスのマニュアルを提供します。 |
オンラインヘルプ
Message Queue 3.7 UR1 には、Message Queue メッセージサービス管理タスクを実行するためのコマンド行ユーティリティーが含まれています。
また、Message Queue 3.7 UR1 には、グラフィカルユーザーインタフェース (GUI) 管理ツールである管理コンソール (imqadmin) も含まれています。管理コンソールには、状況に合わせて表示されるヘルプが用意されています。「管理コンソールのオンラインヘルプ」を参照してください。
JavaDoc
JavaDoc 形式の JMS と Message Queue API マニュアルは、次に示す場所に保存されています。
|
プラットフォーム |
ロケーション |
|---|---|
|
Solaris |
/usr/share/javadoc/imq/index.html |
|
Linux |
/opt/sun/mq/javadoc/index.html |
|
Windows |
IMQ_HOME/javadoc/index.html |
このマニュアルは、任意の HTML ブラウザで表示できます。このマニュアルには、標準の JMS API マニュアルのほか、Message Queue の管理対象オブジェクト用に Message Queue 固有の API が含まれており、メッセージングアプリケーションの開発者にとって役立ちます。
クライアントアプリケーション例
Message Queue には、開発者に役立つように、クライアントアプリケーションの例を多数用意しています。
Java クライアントアプリケーション例
Java クライアントアプリケーション例は、プラットフォームごとに次のディレクトリに格納されています。これらのディレクトリとそのサブディレクトリ内にある README ファイルを参照してください。
|
プラットフォーム |
ロケーション |
|---|---|
|
Solaris |
/usr/demo/imq/ |
|
Linux |
/opt/sun/mq/examples |
|
Windows |
IMQ_HOME/demo/ |
C クライアントプログラム例
C クライアントアプリケーション例は、プラットフォームごとに次のディレクトリに格納されています。これらのディレクトリ内にある README ファイルを参照してください。
|
プラットフォーム |
ロケーション |
|---|---|
|
Solaris |
/opt/SUNWimq/demo/C/ |
|
Linux |
/opt/sun/mq/examples/C/ |
|
Windows |
IMQ_HOME/demo/C/ |
Java Message Service (JMS) 仕様
JMS 仕様は、次の場所にあります。
この仕様には、サンプルクライアントコードが含まれています。
ディレクトリ変数の表記規則
Message Queue では 3 種類のディレクトリ変数が使用されますが、その設定方法は、プラットフォームによって異なります。表 P–3 では、これらの変数について説明し、Solaris、Linux、および Windows の各プラットフォームでの使用方法についても説明します。
注 –
表 P–3 に記載の情報は、Message Queue のスタンドアロンインストールのみに適用されます。Message Queue をアプリケーションサーバーインストールの一環としてインストールおよび実行する場合、ディレクトリ変数は、次のように異なる値が設定されます。IMQ_HOME は appServer_install_dir/imq (appServer_install_dir はアプリケーションサーバーのインストールディレクトリ)、IMQ_VARHOME は appServer_domainName_dir /imq (appServer_domainName_dir は Message Queue ブローカを起動するドメインのドメインディレクトリ) にそれぞれ設定されます。
表 P–3 ディレクトリ変数の表記規則
このマニュアルでは、IMQ_HOME、IMQ_VARHOME、IMQ_JAVAHOME などは、プラットフォーム固有の環境変数表記や構文 (UNIX での $IMQ_HOME など) に関係なく示されています。パス名には、通常、UNIX のディレクトリ区切り文字の表記法 (/) が使用されています。
テキストの表記規則
次の表に、このマニュアルで使用されている表記規則を説明します。
表 P–4 テキストの表記規則|
書式 |
説明 |
例 |
|---|---|---|
|
AaBbCc123 |
コマンド、ファイル、ディレクトリなどの名前、およびコンピュータの画面出力 |
.login ファイルを編集します。 すべてのファイルを一覧表示するには、ls -a を使用します。 machine_name% you have mail. |
|
AaBbCc123 |
入力文字列 (コンピュータの画面出力とは異なる) |
machine_name% su Password: |
|
aabbcc123 |
可変部分: 実際の名前や値と置き換えます |
ファイルを削除するコマンドは、rm filename です。 |
|
AaBbCc123 |
書籍名、新規用語、強調する用語 |
『User's Guide』の第 6 章を参照してください。 キャッシュは、ローカルに格納されるコピーです。 ファイルを保存しないでください。 注: オンラインでは、一部の強調項目が太字で表示されます。 |
コマンド例のシェルプロンプト
次の表に、C シェル、Bourne シェル、Korn シェル、Windows オペレーティングシステムにおけるデフォルトの UNIX® システムプロンプトおよびスーパーユーザープロンプトを示します。
表 P–5 シェルプロンプト|
シェル |
プロンプト |
|---|---|
|
C シェル |
machine_name% |
|
スーパーユーザーの C シェル |
machine_name# |
|
Bourne シェルおよび Korn シェル |
$ |
|
スーパーユーザーの Bourne シェルおよび Korn シェル |
# |
|
Windows |
C:\ |
記号の表記規則
次の表に、このマニュアルで使用される記号を説明します。
表 P–6 記号の表記規則|
記号 |
説明 |
例 |
説明 |
|---|---|---|---|
|
[ ] |
省略可能な引数とコマンドオプションを囲みます。 |
ls [-l] |
-l オプションは必須ではありません。 |
|
{ | } |
必須のコマンドオプションについて、選択肢の組を囲みます。 |
-d {y|n} |
-d オプションでは、y 引数と n 引数のいずれかを使用する必要があります。 |
|
${ } |
変数の参照を表します。 |
${com.sun.javaRoot} |
com.sun.javaRoot 変数の値を参照します。 |
|
- |
同時に押す複数のキーを結合します。 |
Control-A |
Control キーを押したまま A キーを押します。 |
|
+ |
連続して押す複数のキーを結合します。 |
Ctrl+A+N |
Control キーを押して離し、それ以降のキーを押します。 |
|
-> |
グラフィカルユーザーインタフェースでのメニュー項目の選択を表します。 |
「ファイル」->「新規」->「テンプレート」 |
「ファイル」メニューから「新規」を選択します。「新規」サブメニューから「テンプレート」を選択します。 |
マニュアル、サポート、およびトレーニング
Sun の Web サイトでは、次のリソースに関する情報を提供しています。
-
サポート (http://www.sun.com/support/)
-
トレーニング (http://www.sun.com/training/)
Sun 製品マニュアルの検索
Sun 製品ドキュメントは、docs.sun.com Web サイトから検索できるだけでなく、検索フィールドに次の構文を入力することで検索エンジンを使用できます。
search-term site:docs.sun.com |
たとえば、「ブローカ」を検索するには、次のように入力します。
broker site:docs.sun.com |
ほかの Sun Web サイト (たとえば java.sun.com、www.sun.com、developers.sun.com など) を検索に含めるには、検索フィールドで「docs.sun.com」ではなく「sun.com」を使用します。
サードパーティーの Web サイト参照
このマニュアルでは、追加の関連情報を提供するサードパーティーの URL を参照しています。
注 –
サンマイクロシステムズ株式会社は、このマニュアルに記載されたサードパーティーの Web サイトの可用性については一切責任を負いません。また、このようなサイトまたはリソースで提供されているコンテンツ、広告、製品、そのほかのマテリアルを支持するわけではなく、それらに対する責任も一切負いません。サンマイクロシステムズ株式会社は、このようなサイトまたはリソースで提供されているコンテンツ、商品、またはサービスを使用もしくは信用したことで、実際に引き起こされた、または引き起こされたと考えられる損害や損失についても一切の責任は負いません。
ご意見をお寄せください
Sun では、マニュアルの品質向上のために、お客様からのコメントやご意見をお待ちしています。ご意見がありましたら、http://docs.sun.com にアクセスし、「コメントの送信」をクリックしてください。オンラインフォームで、マニュアルのタイトルと Part No. をお知らせください。Part No. は、マニュアルのタイトルページまたは URL にある 7 桁または 9 桁の番号です。たとえば、このマニュアルの Part No. は、820-0846 です。
- © 2010, Oracle Corporation and/or its affiliates