クライアント・アプリケーションとサーバー・アプリケーションのいずれを持っている場合も、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 の試用版または完全な製品をインストールします。
- WebSphere eXtreme
Scale 製品のスタンドアロン・バージョンをインストールします。
- WebSphere eXtreme
Scale 試用版をダウンロードし、解凍します。
- Apache Tomcat バージョン 6.0 以降をインストールします。
- Rational Application Developer をインストールし、Java EE Web アプリケーションを作成します。
手順
- WebSphere eXtreme
Scale ランタイム・ライブラリーを Java EE ビルド・パスに追加します。
クライアント・アプリケーション このシナリオでは、Rational Application Developer で WebSphere eXtreme
Scale クライアントを使用するための Web アプリケーションを構成し、実行します。
- 。「新規」をクリックします。
- eXtremeScaleClient の「ユーザー・ライブラリー名」を入力し、「OK」をクリックします。
- 「Jar を追加...」をクリックし、wxs_home/lib/ogclient.jar ファイルにナビゲートして選択します。
「オープン」をクリックします。
- オプション: (オプション) Javadoc を追加するには、Javadoc のロケーションを選択し、「編集....」をクリックしてください。 Javadoc ロケーション・パスでは、API 資料の URL を入力してもよいし、API 資料をダウンロードすることもできます。
- オンライン版の API 資料を使用するには、http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ を Javadoc ロケーション・パスに入力します。
- API 資料をダウンロードするには、WebSphere eXtreme
Scale API 資料ダウンロード・ページ へ移動します。Javadoc ロケーション・パスには、ローカルのダウンロード・ロケーションを入力します。
- 「OK」をクリックします。
- 「OK」をクリックし、「ユーザー・ライブラリー」ダイアログを閉じます。
- をクリックします。
- 「Java ビルド・パス」をクリックします。
- 「ライブラリーの追加」をクリックします。
- 「ユーザー・ライブラリー」を選択してください。「次へ」をクリックします。
- 「eXtremeScaleClient」ライブラリーを確認し、「終了をクリックします。
- 「OK」をクリックし、「プロジェクト・プロパティー」ダイアログを閉じます。
サーバー・アプリケーション このシナリオでは、Rational Application Developer で組み込み WebSphere eXtreme
Scale サーバーを実行するための Web アプリケーションを構成し、実行します。
- をクリックします。「新規」をクリックします。
- eXtremeScale の「ユーザー・ライブラリー名」を入力し、「OK」をクリックします。
- 「Jar を追加...」をクリックし、wxs_home/lib/objectgrid.jar を選択します。
「オープン」をクリックします。
- (オプション) Javadoc を追加するには、Javadoc のロケーションを選択し、「編集....」をクリックしてください。http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ を Javadoc ロケーション・パスに入力します。
- 「OK」をクリックします。
- 「OK」をクリックし、「ユーザー・ライブラリー」ダイアログを閉じます。
- をクリックします。
- 「Java ビルド・パス」をクリックします。
- 「ライブラリーの追加」をクリックします。
- 「ユーザー・ライブラリー」を選択してください。「次へ」をクリックします。
- 「eXtremeScaleClient」ライブラリーを確認し、「終了をクリックします。
- 「OK」をクリックし、「プロジェクト・プロパティー」ダイアログを閉じます。
- プロジェクト用の Tomcat サーバーを定義します。
- J2EE パースペクティブ内にいることを確認し、下のペインの「サーバー」タブをクリックします。をクリックしてもよいです。
- 「サーバー」ペイン内で右クリックし、を選択します。
- 「Apache, Tomcat v6.0 Server」を選択します。
「次へ」をクリックします。
- 「参照..」をクリックします。tomcat_root を選択します。
「OK」をクリックします。
- 「次へ」をクリックします。
- 左側の「使用可能」ペインで Java EE アプリケーションを選択し、追加 > をクリックして、サーバーの右側の「構成済み」ペインに選択したアイテムを移動し、「終了」をクリックします。
- プロジェクトの残りのエラーを解決します。 以下の手順で、「問題」ペインにあるエラーを除去します。
- をクリックします。「OK」をクリックします。プロジェクトをビルドします。
- Java EE プロジェクトを右クリックし、を選択します。
- 「ライブラリー」タブをクリックします。 パスが適切に構成されていることを確認してください。
- クライアント・アプリケーションの場合: Apache Tomcat、eXtremeScaleClient、および Java 1.5 JRE がパス上にあることを確認してください。
- サーバー・アプリケーションの場合: Apache Tomcat、eXtremeScale、および Java 1.5 JRE がパス上にあることを確認してください。
- アプリケーションを実行するための実行構成を作成します。
- 「実行」メニューから「実行構成」を選択します。
- Java Application カテゴリーを右クリックし、「新規」を選択します。
- 「New_Configuration」という名前の新規実行構成を選択します。
- プロファイルを構成します。
- プロジェクト (メインのタブ付きページ): 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
- 「適用」をクリックし、ウィンドウを閉じるか、もしくは「実行」をクリックします。
次のタスク
Rational Application Developer で、WebSphere eXtreme
Scale クライアントを
使用する Web アプリケーションを構成し実行したら、サーブレットを作成できます。このサーブレットは、WebSphere eXtreme
Scale API を使用してリモート・データ・グリッドに
データを保管したり、そこからデータを取得したりします。
スタンドアロン・インストールの WebSphere eXtreme
Scale を
使用する Rational Application Developer インターフェースで Java EE アプリケーションを
使用可能にしたら、WebSphere eXtreme
Scale システム API を使用して
カタログ・サービスの開始と停止を行うサーブレットを作成できます。