WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 オペレーティング・システム: AIX, HP-UX, Linux, Solaris, Windows

Message Service Client 入門

この入門ガイドでは、Message Service Client を IBM® WebSphere® Enterprise Service Bus (ESB) や とともにインストール するために必要な知識について説明します。

本書では、以下の Message Service Client について説明します。

本書は、WebSphere ESB または のランチパッドをすでに開いていることを前提としています。

WebSphere ESB でのインストール

Message Service Client を WebSphere ESB とともにインストールする前に、以下を確認する必要があります。

  • ご使用のシステムがすべてのハードウェア要件およびソフトウェア要件を満たしているこ とを確認します。 http://www.ibm.com/software/integration/wsesb/sysreqsを参照してください。
  • Linux システムでは root として、Windows システムでは Administrator グループのメンバーとしてログオンしていることを確認します。
  • Message Service Client を CD からインストールしている場合、ご使用のプラットフォ ーム向けの IBM WebSphere Enterprise Service Bus CD2 というラベルの付いたディスクをお 手元に用意します。Message Service Client を他のロケーションからインストールする場合、CD2 の内 容があるロケーションがわかっていることを確認します。

Message Service Client for C/C++ のインストール

選択可能なセットアップ・オプションは 2 つあり、「完全 インストール」または「カスタム・インストール」を選ぶことができます。

このタスクは、ランチパッドをすでに開いていて、インストールを進める準備が できていることを前提としています。

Message Service Client for C/C++ を Linux または Windows 上でインストールする場合は、この手順に従ってください。インストールのセットアップ・プロセスでい つでも「キャンセル (Cancel)」をクリックしてインストール処理の 継続を中断することはできますが、「キャンセル (Cancel)」オプシ ョンは、製品が実際にインストールされているときには使用できない点に注意してください。

  1. ランチパッドを使用してインストール・ウィザードを開きます。ウィザードを開くには、以下のオプションを選択します。
    1. ウェルカム・ページで、「Message Service Client のインストール (Message service clients installation)」をクリックします。
    2. Message Service Client インストール・ページで、「IBM Message Service Client for C/C++」をクリックします。
    3. IBM Message Service Client for C/C++ インストール・ページで、「Message Service Client for C/C++ のインストール・ウィザードを起動する (Launch the installation wizard for Message Service Client for C/C++)」をクリックします。

    ご使用のプラットフォーム用の CD2 というラベルの付いたディスクのロケー ションを入力するようにプロンプトが出される場合があります。ディスクをお持ちの場合、ドライブに挿入して、「OK」をクリックします。 他のロケーションからインストールしている場合、CD2 の内容があるロケーションを入力し 、「OK」をクリックします。 このプロンプトは、ピアであるサブディレクトリーに CD1 と CD2 の内容が入っているロケー ションからインストールしている場合は表示されない点に注意してください。

    インストール・ウィザードにより、次のメッセージが表示されます。
    Welcome to the IBM Message Service Client for C/C++ installation wizard
  2. 次へ」をクリックします。

    使用許諾 契約書を読むように指示されます。

  3. 使用許諾契約書の条項に同意する場合、「同意する (I accept the terms of the license agreement)」をクリックし、「次へ (Next)」をクリックします。

    Message Service Client for C/C++ のインストール先を尋ねられます。

  4. 提示されたディレクトリーに Message Service Client for C/C++ をインストールする場合は、「次へ (Next)」をクリックします。 Message Service Client for C/C++ をウィザードにより示されたディレクトリーにインストールしたくない場合は、他のディレクトリーを選択します。Message Service Client for C/C++ のインストール先として まだ存在しないディレクトリーを指定した場合、ウィザードによりそのディレクトリーが作成されます。

    お客様のニーズに最 も合うセットアップ・タイプを選択するように指示されます。

  5. 必要なセットアップ・タイプを選択します。
    • すべてのプログラム機能をインストールする場合、「完全 (Complete)」をクリックします。
    • インストールする機能を選択したい場合、「カスタム (Custom)」をクリックします。
  6. 次へ」をクリックします。

    完全イン ストール・オプションを選択した場合、選択したインストール・オプションの詳細が表示され 、ステップ 8 で示 すように、次に進むことができます。カスタム・インストール・オプションを選択した場合、どの機能をインス トールしたいのか尋ねられ、ステッ プ 8 に移る前に、ス テップ 7 を完了させる 必要があります。

  7. カスタム・インストールの場合に限り、インストールしたい Message Service Client for C/C++ 機能を選択し、「次へ (Next)」をクリックします。

    Message Service Client for C/C++ アプリケ ーションを開発したい場合は、必ず「開発ツールおよびサンプル (Development Tools and Samples)」機能を選択してください。 この機能を選択すると、サンプル・アプリケーション、および C および C++ アプリケーショ ンのコンパイルに必要なライブラリーとヘッダー・ファイルが提供されます。この機能を選択しない場合は、 Message Service Client for C/C++ アプリケーションを 実行するために必要なファイルのみがインストールされます。

    選択したインストール・オプションの詳細が表示されます。

  8. 選択したインストール・オプションの内容を確認してから、「次へ (Next)」をクリックし、インストールを開始します。 インストールが開始されると、「キャンセル (Cancel)」が無効になるので注意してください。
    インストールの進捗状況を示すバーが表示されます。進行状況表示バーが完了するまで待ちます。インストールが正常に完了すると、次のメッセージが表示されます。
    The installation wizard has successfully installed IBM Message Service 
    Client for C/C++. Choose Finish to exit the wizard.
  9. 次へ」をクリックします。

    Message Service Client for C/C++ に関する readme ファイルを表示したい場合、「次へ (Next)」をクリックする前に「Readme の表示 (View Readme)」を選択します。

  10. 完了」をクリックして、インストール・ウィザードを閉じます。

これで、Message Service Client for C/C++ を正 常にインストールすることができました。

JMS 管理対象オブジェクトを Message Service Client for .NET アプリケーションで扱うには、Java 以外のクライアントが JMS 管理対象オブジェクトへアクセスするのを許可する JNDILookup Web Service のインストールが必要です。詳しくは、JNDILookup Web Service アプリケーションのインストールを参照してください。JNDILookup Web Service を Message Service Client for C/C++ とともに使用する前 提条件である、Web Services Client for C++ をインストールし、構成する必要があります。

Web Services Client for C++Message Service Client for C/C++ アプリケーション内で使用できるようインストールし、構成することもできます。

Message Service Client for .NET のインストール

選択可能なセットアップ・オプションは 2 つあり、「完 全インストール」または「カスタム・インストール」を選ぶことができます。

このタスクは、ランチパッドをすでに開いていて、インストールを進める準備がで きていることを前提としています。

Message Service Client for .NET を Windows にインストールする場合は、次の手順に従います。

  1. ランチパッドを使用してインストール・ウィザードを開きます。ウィザードを開くには、以下のオプションを選択します。
    1. ウェルカム・ページで、「Message Service Client のインストール (Message service clients installation)」をクリックします。
    2. Message Service Client インストール・ページで、「IBM Message Service Client for .NET」をクリックします。
    3. IBM Message Service Client for .NET インストール・ページで、「Message Service Client for .NET のインストール・ウィザードを起動する (Launch the installation wizard for Message Service Client for .NET)」をクリックします。

    ご使用のプラットフォーム用の CD2 というラベルの付いたディスクのロケー ションを入力するようにプロンプトが出される場合があります。ディスクをお持ちの場合、ドライブに挿入して、「OK」をクリックします。 他のロケーションからインストールしている場合、CD2 の内容があるロケーションを入力し 、「OK」をクリックします。 このプロンプトは、ピアであるサブディレクトリーに CD1 と CD2 の内容が入っているロケー ションからインストールしている場合は表示されない点に注意してください。

    インストール・ウィザードにより、次のメッセージが表示されます。
    Welcome to IBM Message Service Client for .NET installation wizard
  2. 次へ」をクリックします。

    使用許諾 契約書を読むように指示されます。

  3. 使用許諾契約書の条項に同意する場合、「同意する (I accept the terms of the license agreement)」をクリックし、「次へ (Next)」をクリックします。

    お客様のニーズに最も合うセットアップ・タイプを選択するように指示され ます。

  4. 必要なセットアップ・タイプを選択します。
    • すべてのプログラム機能をデフォルトのインストール・ディレクトリーにインストールする場合、「完全 (Complete)」をクリックします。
    • インストールする機能を選択し、インストール先を指定する場合は、「カスタム (Custom)」をクリックします。
  5. 次へ」をクリックします。

    完全イン ストール・オプションを選択した場合、ステップ 8 で示すように、インストール を開始するための準備が整ったことがインストール・ウィザードにより示されます。 カスタム・インストール・オプションを選択した場合、インストールしたい機能を選択するよ うに指示され、ステップ 8に進 む前に、ステップ 6 とステッ プ 7 を完了させる必要があります。

  6. カスタム・インストールの場合に限り、機能リスト内のアイコンをク リックして、Message Service Client for .NET 機 能のインストール方法に対する変更を指定します。Message Service Client for .NET をウィザードにより示されたディレクトリーにインストールしたくない場合は、他のディレクトリーを選択します。

    Message Service Client for .NET のインストール 先としてまだ存在しないディレクトリーを指定した場合、ウィザードによりそのディレクトリーが作成されます。

    XMS アプリケーションを 開発したい場合は、必ず「開発ツールおよびサンプル (Development Tools and Samples)」機能を選択してください。 この機能を選択すると、サンプル・アプリケーション、および .NET アプリケーションのコン パイルに必要なライブラリーとその他のファイルが提供されます。この機能を選択しない場合は、 XMS アプリケーションを 実行するために必要なファイルのみがインストールされます。

  7. カスタム・インストール・オプションを使用している場合は、 ステップ 6 で示すように、必要なオプションを選択してから「次へ (Next)」をクリックします。

    インストールを開始するための準備が整ったことがインストール・ウィザードにより示されます。

  8. インストール (Install)」をクリックして、インストールを開始します。
    インストールの進捗状況を示すバーが表示されます。進行状況表示バーが完了するまで待ちます。インストールが正常に完了すると、次のメッセージがウィンドウに表 示されます。
    The installation wizard has successfully installed IBM Message Service 
    Client for .NET. Click Finish to exit the wizard.
  9. 完了」をクリックして、インストール・ウィザードを閉じます。

これで、Web Services Client for C++ を 正常にインストールすることができました。

JMS 管理対象オブジェクトを Message Service Client for .NET アプリケーションで扱うには、Java 以外のクライアントが JMS 管理対象オブジェクトへアクセスするのを許可する JNDILookup Web Service のインストールが必要です。詳しくは、JNDILookup Web Service アプリケーションのインストールを参照してください。

Web Services Client for C++ のインストール

インストール・ウィザードを使用したインストール

インストール・ウィザードを使用して Web Services Client for C++ をインストールす る際には、選択可能なセットアップ・オプションが 2 つあり、「完全インストール」または 「カスタム・インストール」を選ぶことができます。

このタスクを始める前に、インストールを実行しようとするプラットフォームに 関するすべての前提条件を満たしていること、および製品をインストールする場所への書き込みアク セス権があることを確認します。 このタスクは、ランチパッドをすでに開いていて、インストールを進める準備ができているこ とを前提としています。

Web Services Client for C++ を Linux または Windows にインストールする場合は、次の手順に従ってください。

  1. ランチパッドを使用してインストール・ウィザードを開きます。ウィザードを開くには、以下のオプションを選択します。
    1. ウェルカム・ページで、「Message Service Client のインストール (Message service clients installation)」をクリックします。
    2. Message Service Client インストール・ページで、「IBM Web Services Client for C++」をクリックします。
    3. IBM Web Services Client for C++ インストール・ページで、「Web Services Client for C++ のインストール・ウィザードを起動する (Launch the installation wizard for Web Services Client for C++)」をクリックします。

    ご使用のプラットフォーム用の CD2 というラベルの付いたディスクのロケー ションを入力するようにプロンプトが出される場合があります。ディスクをお持ちの場合、ドライブに挿入して、「OK」をクリックします。 他のロケーションからインストールしている場合、CD2 の内容があるロケーション を入力し 、「OK」をクリックします。 このプロンプトは、ピアであるサブディレクトリーに CD1 と CD2 の内容が入っているロケーシ ョンからインストールしている場合は表示されない点に注意してください。

    インストール・ウィザードが開き、次のメッセージが表示されます。

    Welcome to the Installation wizard for Web Services Client for C++

  2. 次へ」をクリックします。

    使用許諾 契約書を読むように指示されます。

  3. 使用許諾契約書の条項に同意する場合、「同意する (I accept the terms of the license agreement)」をクリックし、「次へ (Next)」をクリックします。

    クライアントのインストール先を尋ねられます。クライアントをウィザードにより示されたディレク トリーにインストールしたくない場合は、他のディレクトリーを選択することができます。クライアントのインストール先としてまだ存在 しないディレクトリーを指定すると、ウィザードによりそのディレクトリーが作成されます。

  4. 次へ」をクリックします。

    お客様のニーズ に最も合うセットアップ・タイプを選択するように指示されます。次のオプションのいずれかを選択します。

    • すべてのプログラム機能をインストールする場合、「完全 (Complete)」を選択します。
    • インストールするプログラムを機能別に選択したい場合、およびインストール先を指定 したい場合は、「カスタム (Custom)」を選択します。
  5. 次へ」をクリックします。
  6. カスタム・セットアップ・オプションを選択した場合、インストールしたい機能を次のオプションの中からいくつか、あるいはすべて選択します。
    • ランタイム
    • ツール
    • ドキュメンテーション
    • サンプル
  7. 次へ」をクリックします。

    インストールされる内容の詳細が表示されます。

  8. 内容を確認してから、「インストール (Install)」をク リックします。

    インストールの進捗状況を示すバーが表示されます。 進行状況表示バーが完了するまで待ちます。インストールが正常に完了すると、次のメッセージが表示されます。

    The Installation wizard has successfully installed IBM Web Services Client for C++. Choose Finish to exit the wizard.
  9. 完了 (Finish)」をクリックして、ウィザードを閉じます。
これで、Web Services Client for C++ を 正常にインストールすることができました。 次の作業で行う必要のあるインストール後の構成については、 インストール後の構成を参照してください。

インストール後の Web Services Client for C++ の構成

インストール完了後に、インストールした内容と一致するように axiscpp.conf ファイルを構成し なければならない場合があります。

プラットフォームに応じて、 axiscpp.conf ファイルは、 Windows では <inst_dir> 内 に、UNIX では <inst_dir>/etc 内にあります。

次のコードは、用意されているデフォルトのテンプレート構成ファイルを示しています。このファイル内のパス名は、プラットフォームに より異なりますので、注意してください。

# The comment character is '#'
# Available directives are as follows
#
# ClientWSDDFilePath:  The path to the client WSDD
# SecureInfo:          The GSKit security information
#

このファイルを変更する必要があるのは、 Web サービス・クライアント・アプリケーションとともにハンドラ ーを使用している場合、または Web サービス通信を SSL により保護している場合のみです。ハンドラーまたは SSL を追加していない場合は、このファイルを変更する必要はありません。

axiscpp.conf 構成ファイル を使用している場合、 axiscpp.conf のロケーショ ンを AxisClient ライブラリーに知らせる環境変数を作成する必要があります。プラットフォームの種類に関係なく、この変数 を AXISCPP_DEPLOY と呼 びます。

Web Services Client for C++ のポスト・イ ンストール構成を実行するには、次のステップを行います。

  1. ハンドラーまたは SSL を追加している場合には、 クライアント・サイド・ハンドラーの開発と使用法および Web サービス通信の保護 に説明されているように、axiscpp.conf ファイルを構成します。
  2. axiscpp.conf を使用している場合、AXISCPP_DEPLOY の値を <inst_dir> に設定します。 例えば、次に例を示します。
    • UNIX platforms UNIX® プラットフォームの場合: export AXISCPP_DEPLOY = <inst_dir>
    • For Windows platforms Windows プラットフォームの場合: set AXISCPP_DEPLOY = <inst_dir>
  3. AXISCPP_DEPLOY の作成後 、 次のように、AxisClient ライブラリーを含むデ ィレクトリーの絶対パスを、オペレーティング・システムに応じて、パスまたはライブラリー ・パスの環境変数のいずれかに追加します。
    • LINUX platforms Linux プラットフォームの場合: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH :<inst_dir>/lib
    • For Windows platforms Windows プラットフォームの場合: path=%path%;<inst_dir>¥bin
  4. 次のように、XML4C ライブラリーを含むディレクトリーの絶対パスを、オペレー ティング・システムに応じて、パスまたはライブラリー・パスの環境変数のいずれかに追加します。
    • LINUX platforms Linux プラットフォームの場合: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH :<inst_dir>/prereqs/XML4C
    • For Windows platforms Windows プラットフォームの場合: path=%path%;<inst_dir>¥prereqs¥XML4C
これで、Web サービス・アプリケーションの開発およびデプロイを開始する準備が 整いました。

Message Service Client のサイレント・インストール

インストール・ウィザードを使用する代わりに、応答ファイルを使用して Message Service Client を対話式にインストールすることができます。この応答ファイルは、シンプルなテキスト・ファイル であり、インストーラーが必要とする情報を含んでいます。インストール・プログラムは、グラフィカル・ユーザー・イン ターフェースを表示する代わりに、用意したファイルから応答を読み取ります。

更新、制限および既知の問題

Message Service Client を含む WebSphere ESB の更新、制限、およ び既存の問題については、IBM ソフトウェア・サポート Web サイト (http://www.ibm.com/software/integration/wsesb/support) 上で Technote 形式で文書化されています。

商標

IBM および WebSphere は、IBM Corporation の商標です。

Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation の米国およびその他の国における商標です。

Linux は、Linus Torvalds の米国およびその他の国における商標です。

UNIX は、The Open Group の米国およびその他の国における登録商標です。

他の会社名、製品名およびサービス名等はそれぞれ各社の商標です。


Concept topic

ご利用条件 | フィードバック (英語のみ)

Timestamp icon最終更新: 5 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\clients\GettingStarted.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)