このタスクを使用して、WebSphere Extended Deployment 内で、Java 2 Platform, Enterprise Edition
(J2EE) ObjectGrid サンプルをロードし、実行します。
Before you begin
WebSphere Application Server および WebSphere Extended Deployment をインストールしておく必要があります。
Why and when to perform this task
このタスクは、ObjectGrid と WebSphere Extended Deployment との統合を理解し、テストする場合に使用します。
- ObjectGridSample.ear ファイルをインストールします。 エンタープライズ・アーカイブ (EAR) ファイルを、単一アプリケーション・サーバーまたはクラスター上にインストールすることができます。
ObjectGridSample.ear ファイルを管理コンソールにインストールするには、以下のステップを実行します。
- 管理コンソールで、「アプリケーション」 > 「新規アプリケーションのインストール」とクリックします。
- 「アプリケーション・インストールの準備」ページで、ObjectGrid サンプル・アプリケーションの場所を指定します。
例えば、<install_root>/installableApps/ObjectGridSample.ear を参照します。
「次へ」をクリックします。
- 2 番目の「アプリケーション・インストールの準備」ページで、デフォルト設定を選んで、「次へ」をクリックします。
- 「インストール・オプションの選択」ページで、デフォルト設定を選んで、「次へ」をクリックします。
- 「サーバーにモジュールをマップ」ページで、アプリケーションに含まれるモジュールをインストールするデプロイメント・ターゲットを指定します。
すべてのモジュールに対して、「クラスターおよびサーバー」リストから、ターゲット・サーバーまたはクラスターを選択します。
「モジュール」チェック・ボックスを選択して、すべてのアプリケーション・モジュールを選択するか、個々のモジュールを選択します。
- 以下のページで、デフォルト値を使用して「終了」をクリックします。
- アプリケーション・インストールを終了してから、「マスター構成に保管」をクリックします。
- 「ノードとの変更の同期化」オプションをクリックします。
「エンタープライズ・アプリケーション」 > 「保管」ページで、「保管」をクリックします。
- 「OK」をクリックします。
- サーバーの default_host の HTTP ポートを確認して、ホストの別名を追加します。
インストール中にホスト名を変更していない限り、デフォルトで Web モジュールは、default_host 仮想ホスト名にバインドされています。
クラスターにアプリケーションをインストールする場合は、クラスター・メンバーごとに、default_host
の HTTP ポートに対して少なくとも 1 つのホスト別名を構成する必要があります。
また、それぞれのクラスター・メンバーの default_host の HTTP
ポートを確認して、対応するホスト別名を管理コンソール内の「ホスト別名」リストに追加する必要があります。
サーバーの default_host の HTTP ポートを確認するには、以下のステップを実行します。
- 管理コンソールで、「サーバー」 > 「アプリケーション・サーバー」
> 「server_name」とクリックします。
- 通信セクションでポートを展開します。
「WC_defaulthost」ポートは、default_host 仮想ホスト・ポートです。
ホスト別名を追加するには、以下のステップを実行します。
- 管理コンソールで、「環境」 > 「仮想ホスト」 > 「default_host」 > 「ホスト別名」 > 「新規」とクリックします。
- ホスト名のデフォルト値を使用して、ポートを指定します。
- 「OK」をクリックします。
- ObjectGrid サンプル・アプリケーションを開始します。
- サーバー上のアプリケーションを開始するには、「サーバー」 > 「アプリケーション・サーバー」とクリックします。 インストール済みの ObjectGridSample.ear ファイルを持つサーバーを選択します。
「開始」をクリックします。
- クラスター上のアプリケーションを開始するには、「サーバー」 > 「クラスター」とクリックします。
インストール済みの ObjectGridSample.ear ファイルを持つクラスターを選択します。
「開始」をクリックします。
サーバーまたはクラスター上でアプリケーションを開始したあとは、ホスト・サーバーまたはクラスターから独立してアプリケーションを停止および開始することができます。
ObjectGrid サンプル・アプリケーションを停止または開始するには、以下のステップを実行します。
- 管理コンソールで、「アプリケーション」 > 「エンタープライズ・アプリケーション」とクリックします。
- ObjectGrid サンプル・アプリケーションを選択します。
- 「開始」または「停止」をクリックします。
- ObjectGrid サンプルにアクセスします。
単一サーバーまたはクラスターに ObjectGridSample.ear ファイルをインストールし、アプリケーションを開始したあとは、以下の Web アドレスで ObjectGrid サンプルにアクセスすることができます。
http://hostname:port/ObjectGridSample
例えば、ホスト名が localhost で、ポート値が 9080 である場合、Web アドレス http://localhost:9080/ObjectGridSample を使用します。
WebSphere Application Server 環境で分散 ObjectGrid の機能をテストします。
ObjectGridSample.ear ファイルにも、WebSphere Application Server 環境における分散 ObjectGrid の使用を説明する DistributedObjectGridServlet サーブレットが含まれています。DistributedObjectGridServlet サーブレットをホストするアプリケーション・サーバーは、必要な ObjectGrid クラスターのメンバーである ObjectGrid サーバーもホストする必要があります。
ObjectGridSample.ear ファイルがインストールされたアプリケーション・サーバーでも必要な ObjectGrid サーバーをホストしたあとは、DistributedObjectGridServlet サーブレットが他のサーブレットと同様に動作します。サーブレットには、Web アドレス http://hostname:port/ObjectGridSample/DistributedObjectGridServlet でアクセスできます。例えば、
ホスト名が localhost で、ポート値が 9080 である場合、Web アドレス http://localhost:9080/ObjectGridSample/DistributedObjectGridServlet を使用します。トレース・ストリング ObjectGrid*=all=enabled を使用して ObjectGrid のトレースを使用可能にできます。
Result
WebSphere Extended Deployment サーバー上に ObjectGrid サンプル・アプリケーションおよび分散 ObjectGrid サンプル・アプリケーションをインストールし、構成しました。
What to do next
サーバーまたはクラスター上にアプリケーションをインストールしたあとは、以下の Web アドレスでアプリケーションを開始してから、サンプル資料にアクセスできます。
http://hostname:port/ObjectGridSample/docs/introduction.html
例えば、ホスト名が
localhost で、ポート値が
9080 である場合、Web アドレス
http://localhost:9080/ObjectGridSample/docs/introduction.html を使用します。