ポートレット・プロジェクトのテスト、デバッグ、またはプロファイル作成用にローカル (テスト環境) サーバーを定義する場合は、サーバーを作成し、構成する必要があります。
前提条件:- ローカル WebSphere® Portal v5.0 サーバーを使用するには、Rational® Developer ランチパッドから WebSphere Portal
v5.0 テスト環境をインストールする必要があります。
- ローカル WebSphere Portal
v5.1 サーバーを使用するには、Rational Developer に付属の WebSphere Portal
5.1 CD-ROM を使用して、WebSphere Portal v5.1 テスト環境をインストールする必要があります。
サーバーを使用する前に、WebSphere Portal v5.1 テスト環境を使用するように、Rational Developer を構成する必要があります。
ローカル WebSphere Portal
v5.1 サーバーを使用するには、Rational Developer に付属の WebSphere Portal
5.1 CD-ROM を使用して、WebSphere Portal v5.1 テスト環境をインストールする必要があります。
サーバーを使用する前に、WebSphere Portal v5.1 テスト環境を使用するように、Rational Developer を構成する必要があります。
ローカル・サーバーを作成し、構成するには、以下の手順に従ってください。
- 「新規サーバー」ウィザードを開く。
その方法については、ポートレットのテスト用のサーバーの定義を参照してください。
- ホスト名として localhost を選択する。
- サーバー型リストから、サーバーを選択する。
- 「次へ」を選択する。
- ページで、次の値のどちらかを選択する。
- デフォルトの HTTP ポートを使用するには、を選択し、を設定する。
- WebSphere Application
Server が使用するデフォルト番号以外のポート番号を使用するには、を選択し、を設定する。
これを設定すると、テスト環境は、指定する番号から始まる連続ポート番号を使用します。別のアプリケーションが使用していない一連のポート番号から開始するポート番号を指定する必要があります。
このオプションを選択すると、システム上で外部ポータル・サーバーまたは WebSphere Application
Server を実行することができ、テスト環境が別のポート番号を使用することを可能にします。また、下記で説明する通りにサーバー構成を編集すれば、テスト環境サーバーの HTTP ポート番号を構成することもできます。
- をクリックする。 ローカル・サーバー用の追加オプションを表示し、変更するには、「サーバー」ビューでサーバーをダブルクリックしてください。
これにより、サーバー構成エディターが開きます。
以前に定義された設定値を変更できます。さらに、「ポータル」タブには、以下にリストされている追加設定もあります。
- を選択して、テスト環境で管理ポートレットを使用する。
このオプションは、必要な場合のみ使用してください。
このオプションを使用すると、テスト環境の始動に時間がかかります。
管理ポートレットを使用可能にしている場合であっても、制限があります。
管理ポートレットを使用してポートレットをインストールすることはできません。
さらに、次回テスト環境を始動すると、加えられた変更の大部分がデフォルト値にリセットされます。特定のレイアウトでポートレットをデバッグするには、テスト環境の管理ポートレットではなく、ポータル・プロジェクトのテストとデバッグ・オプションを使用してください。JSR 168 ポートレット API を使用する連携ポートレット・プロジェクトを実行する場合は、配線ツールを使用できるようにこのオプションを使用可能にする必要があります。
- を選択して、ポートレット・プロジェクトがテスト中にポータルで別々のページを使用することを可能にする。デフォルトでは、複数ページが使用可能になっています。
単一のサーバーに関連した各ポートレット・プロジェクトは、別々のページにデプロイされます。それらすべてをサーバー上の単一ページにデプロイしたい場合は、ポートレット・プロジェクトをデプロイする時に複数ページを使用不可にすることができます。
- を選択して、ログ・エントリーをコンソールにリダイレクトする。
これを選択しない場合、ログ・エントリーは <product_installation_root>/runtimes/portal_vXX/log ディレクトリーに書き込まれます。ここで、product_installation_root は、ワークベンチがインストールされているディレクトリーであり、XX は、WebSphere Portal テスト環境のバージョンです。
「コンソール・ログを使用可能にする」は、最初に使用不可になっています。
- を選択して、ログイン状態でないポートレットをテストする。
- セクションに JAR ファイルまたはフォルダーの名前を入力して、その JAR ファイル、またはそのフォルダー内のファイルがサーバーから使用できるようにする。
さらに、同じ JAR ファイルを使用してプロジェクトをコンパイルするには、プロジェクトの Java™ のビルド・パスに JAR ファイルを追加することも必要です。
Java のビルド・パスに JAR ファイルを追加するには、次の手順を実行します。
- 「プロジェクト・エクスプローラー」ビューで、ポートレット・プロジェクトを強調表示する。
- 右クリックし、「プロパティー」を選択する。
- と選択する。
- 必要な JAR ファイルを追加し、「OK」をクリックする。
テスト環境構成が保管され、ポータル・プロジェクトがワークスペースに存在する場合、wps という名前の EAR プロジェクトが作成されます。
ローカル側でポータル・プロジェクトのテスト、デバッグ、またはプロファイル作成を計画する場合は、wps プロジェクトが作成された後、そのプロジェクトを変更しないでください。プロジェクトを作成する場合は、そのプロジェクトに wps という名前を付けないでください。