Rational Application Developer の Apache Tomcat で WebSphere eXtreme Scale のクライアント・アプリケーションまたはサーバー・アプリケーションを実行する

クライアント・アプリケーションとサーバー・アプリケーションのいずれを持っている場合も、Rational® Application Developer の Apache Tomcat でアプリケーションを実行するには同じ基本手順を踏みます。クライアント・アプリケーションの場合、Web アプリケーションを構成し、実行して、Rational Application Developer で WebSphere® eXtreme Scale クライアントを使用します。WebSphere eXtreme Scale カタログ・サービスおよびコンテナーを実行するための Web プロジェクトを作成するには、以下の説明に従ってください。サーバー・アプリケーションの場合、WebSphere eXtreme Scale のスタンドアロン・インストール済み環境を使用した Rational Application Developer インターフェースで Java EE アプリケーションを使用可能に設定します。WebSphere eXtreme Scale クライアント・ライブラリーを使用するための Java EE アプリケーション・プロジェクトを構成するには、以下の説明に従ってください。

始める前に

以下のように、WebSphere eXtreme Scale の試用版または完全な製品をインストールします。

手順

  1. WebSphere eXtreme Scale ランタイム・ライブラリーを Java EE ビルド・パスに追加します。

    クライアント・アプリケーション このシナリオでは、Rational Application Developer で WebSphere eXtreme Scale クライアントを使用するための Web アプリケーションを構成し、実行します。

    1. 「ウィンドウ」 > 「プリファレンス」 > 「Java」 > 「ビルド・パス」 > 「ユーザー・ライブラリー」「新規」をクリックします。
    2. eXtremeScaleClient の「ユーザー・ライブラリー名」を入力し、「OK」をクリックします。
    3. Jar を追加...」をクリックし、wxs_home/lib/ogclient.jar ファイルにナビゲートして選択します。 「オープン」をクリックします。
    4. オプション: (オプション) Javadoc を追加するには、Javadoc のロケーションを選択し、「編集....」をクリックしてください。 Javadoc ロケーション・パスでは、API 資料の URL を入力してもよいし、API 資料をダウンロードすることもできます。
      • オンライン版の API 資料を使用するには、http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ を Javadoc ロケーション・パスに入力します。
      • API 資料をダウンロードするには、WebSphere eXtreme Scale API 資料ダウンロード・ページ へ移動します。Javadoc ロケーション・パスには、ローカルのダウンロード・ロケーションを入力します。
    5. OK」をクリックします。
    6. OK」をクリックし、「ユーザー・ライブラリー」ダイアログを閉じます。
    7. 「プロジェクト」 > 「プロパティー」をクリックします。
    8. Java ビルド・パス」をクリックします。
    9. ライブラリーの追加」をクリックします。
    10. ユーザー・ライブラリー」を選択してください。「次へ」をクリックします。
    11. eXtremeScaleClient」ライブラリーを確認し、「終了をクリックします。
    12. OK」をクリックし、「プロジェクト・プロパティー」ダイアログを閉じます。

    サーバー・アプリケーション このシナリオでは、Rational Application Developer で組み込み WebSphere eXtreme Scale サーバーを実行するための Web アプリケーションを構成し、実行します。

    1. 「ウィンドウ」 > 「プリファレンス」 > 「Java」 > 「ビルド・パス」 > 「ユーザー・ライブラリー」をクリックします。「新規」をクリックします。
    2. eXtremeScale の「ユーザー・ライブラリー名」を入力し、「OK」をクリックします。
    3. Jar を追加...」をクリックし、wxs_home/lib/objectgrid.jar を選択します。 「オープン」をクリックします。
    4. (オプション) Javadoc を追加するには、Javadoc のロケーションを選択し、「編集....」をクリックしてください。http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ を Javadoc ロケーション・パスに入力します。
    5. OK」をクリックします。
    6. OK」をクリックし、「ユーザー・ライブラリー」ダイアログを閉じます。
    7. 「プロジェクト」 > 「プロパティー」をクリックします。
    8. Java ビルド・パス」をクリックします。
    9. ライブラリーの追加」をクリックします。
    10. ユーザー・ライブラリー」を選択してください。「次へ」をクリックします。
    11. eXtremeScaleClient」ライブラリーを確認し、「終了をクリックします。
    12. OK」をクリックし、「プロジェクト・プロパティー」ダイアログを閉じます。
  2. プロジェクト用の Tomcat サーバーを定義します。
    1. J2EE パースペクティブ内にいることを確認し、下のペインの「サーバー」タブをクリックします。「ウィンドウ」 > 「ビューを表示」 > 「サーバー」をクリックしてもよいです。
    2. 「サーバー」ペイン内で右クリックし、「新規」 > 「サーバー」を選択します。
    3. 「Apache, Tomcat v6.0 Server」を選択します。 「次へ」をクリックします。
    4. 参照..」をクリックします。tomcat_root を選択します。 「OK」をクリックします。
    5. 次へ」をクリックします。
    6. 左側の「使用可能」ペインで Java EE アプリケーションを選択し、追加 > をクリックして、サーバーの右側の「構成済み」ペインに選択したアイテムを移動し、「終了」をクリックします。
  3. プロジェクトの残りのエラーを解決します。 以下の手順で、「問題」ペインにあるエラーを除去します。
    1. 「プロジェクト」 > 「クリーン」 > 「project_name」 をクリックします。「OK」をクリックします。プロジェクトをビルドします。
    2. Java EE プロジェクトを右クリックし、「ビルド・パス」 > 「ビルド・パスの構成」を選択します。
    3. ライブラリー」タブをクリックします。 パスが適切に構成されていることを確認してください。
      • クライアント・アプリケーションの場合: Apache Tomcat、eXtremeScaleClient、および Java 1.5 JRE がパス上にあることを確認してください。
      • サーバー・アプリケーションの場合: Apache Tomcat、eXtremeScale、および Java 1.5 JRE がパス上にあることを確認してください。
  4. アプリケーションを実行するための実行構成を作成します。
    1. 実行」メニューから「実行構成」を選択します。
    2. Java Application カテゴリーを右クリックし、「新規」を選択します。
    3. New_Configuration」という名前の新規実行構成を選択します。
    4. プロファイルを構成します。
      •  プロジェクト (メインのタブ付きページ): your_project_name
      • メイン・クラス (メインのタブ付きページ): your_main_class
      • VM 引数 (引数タブ付きページ): -Djava.endorsed.dirs=wxs_root/lib/endorsed

      java.endorsed.dirs へのパスは絶対パスでなければならず、変数やショートカットが含まれてはならないため、VM 引数 に関する問題は頻繁に発生します。

      その他の一般的なセットアップの問題には、オブジェクト・リクエスト・ブローカー (ORB) が関係しています。次のエラーが発生する可能性があります。詳しくは、カスタム・オブジェクト・リクエスト・ブローカーの構成を参照してください。
      Caused by: java.lang.RuntimeException: The ORB that comes with the 
      Java implementation does not work with ObjectGrid at this time.
      アプリケーションからアクセス可能な objectGrid.xml ファイルまたは deployment.xml ファイルを持っていない場合、次のエラーが発生する可能性があります。
      Exception in thread "P=211046:O=0:CT" com.ibm.websphere.objectgrid.ObjectGridRuntimeException: 
      Cannot start OG container at Client.startTestServer(Client.java:161) at Client.main(Client.java:82) Caused by: java.lang.IllegalArgumentException: The objectGridXML must
      not be null at com.ibm.websphere.objectgrid.deployment.DeploymentPolicyFactory.
      createDeploymentPolicy (DeploymentPolicyFactory.java:55) at Client.startTestServer(Client.java:154) ... 1 more
  5. 適用」をクリックし、ウィンドウを閉じるか、もしくは「実行」をクリックします。

次のタスク

Rational Application Developer で、WebSphere eXtreme Scale クライアントを 使用する Web アプリケーションを構成し実行したら、サーブレットを作成できます。このサーブレットは、WebSphere eXtreme Scale API を使用してリモート・データ・グリッドに データを保管したり、そこからデータを取得したりします。

スタンドアロン・インストールの WebSphere eXtreme Scale を 使用する Rational Application Developer インターフェースで Java EE アプリケーションを 使用可能にしたら、WebSphere eXtreme Scale システム API を使用して カタログ・サービスの開始と停止を行うサーブレットを作成できます。