サーバー・ランタイム環境設定の定義

「設定」ページを使用して、アプリケーションのコンパイル、テスト、または実行に、アプリケーション・サーバーの特定のランタイム環境を使用するよう、ワークベンチに指示できます。

このタスクについて

サーバー・ランタイム環境 は、次の定義から構成されます。
  • サーバー・ランタイム環境を識別する名前
  • サーバーのベンダーおよびバージョン・レベルを指定するサーバーのタイプ
  • サーバーのローカル・インストール済み環境へのディレクトリー・パス
  • 場合によっては、Java ランタイム環境への参照も含まれます。
サーバー・ランタイム環境がサーバーのスタブ・ディレクトリーを参照している場合は、スタブ・サーバーに対してアプリケーションのコンパイルしかできません。ただし、サーバーのフルインストールを参照している場合は、サーバーのインストール済み環境に対して、アプリケーションをコンパイル、テスト、および実行できます。
サーバー・ランタイム環境を定義するには、以下のステップを実行します。

手順

  1. 「ウィンドウ」メニューから、「設定」を選択します。
  2. 「設定」ウィンドウで「サーバー」フォルダーを展開し、 「ランタイム環境」を選択します。 「設定」ダイアログの「サーバー・ランタイム環境」セクションが表示されます。
  3. オプション: オプション: 「検索」 ボタンをクリックします。 これにより、ローカル・ディレクトリーでサーバー・ランタイム環境が検索されます。 リモート・ホストの検索はサポートされていません。
    1. 「ランタイム環境の検索 (Search for Runtime Environments)」ダイアログ・ボックスが開きます。「フォルダー」フィールドで、サーバー・ランタイム環境の検索をワークベンチに開始させるディレクトリーをブラウズまたは入力します。「OK」をクリックします。
    2. インストール済み環境のリストが表示されたら、必要なターゲット・サーバーを選択し、 表示されたダイアログで「OK」をクリックします。次に「設定」ダイアログで 「OK」をクリックします。どのアプリケーション・サーバーのインストール済み環境も検出されないときは、 このタスクのステップの実行を続けてください。
  4. 「追加」をクリックします。 「新規サーバー・ランタイム環境」ウィザードが開きます。
    1. 「ランタイム環境のタイプの選択 (Select the type of runtime environment)」リストの下で、ターゲットのサーバー・ランタイム環境と同様に、サーバーとバージョン・レベルを選択します。
      ヒント: 「ランタイム環境のタイプの選択 (Select the type of runtime environment)」ラベルの下のテキスト・フィールドで、テキスト type filter text を、使用可能なアプリケーション・サーバーのリストをフィルタリングするためのキーワードに置換できます。フィルター・キーワードの例を以下に示します。
      Apache
      使用可能なサーバーのリストのうち、ベンダーが Apache であるものをフィルタリングします。
      WebSphere
      使用可能なサーバーのリストのうち、名前が WebSphere であるものをフィルタリングします。
      ejb
      使用可能なサーバーのリストのうち、EJB モジュールをサポートするものをフィルタリングします。
      web
      使用可能なサーバーのリストのうち、Web モジュールをサポートするものをフィルタリングします。
      5.0
      使用可能なサーバーのリストのうち、バージョンが 5.0 であるか、JEE 5 仕様レベルをサポートするものをフィルタリングします。
      1.2
      使用可能なサーバーのリストのうち、Java EE 1.2 仕様レベルをサポートするもの、 あるいはバージョン・レベルが 1.2 である可能性のあるものをフィルタリングします。
    2. サーバー・ランタイム環境を追加する際、デフォルトでは、サーバーが作成されて、「サーバー」ビューの項目として追加されます。「サーバー」ビューにサーバーを作成せずに、サーバー・ランタイム環境を追加するだけの場合は、「新規ローカル・サーバーを作成 (Create a new local server)」チェック・ボックスをクリアしてください。
    3. 「次へ」をクリックします。サーバーのパネルが表示されます。
    4. 「インストール・ディレクトリー」または 「ロケーション」フィールドに、ターゲット・サーバーのロケーションを入力するか、 または参照を使用して選択します。
      ヒント: ターゲット・サーバーの誤ったロケーションを 指定した場合、ワークベンチを使用してモジュールをアセンブルし、次にアプリケーション・サーバーを使用して モジュールをデプロイしてください。
      ターゲット・サーバーに「J2EE ランタイム・ライブラリー」(汎用 Java EE コンテナー) を選択した場合は、.jar ファイルを含むディレクトリー (Java™ Developer Kit (JDK) インストールの場合の ¥bin¥lib ディレクトリーなど) を指定してください。
    5. 「終了」をクリックします。 「サーバー・ランタイム環境」セクションのテーブルに、ターゲット・サーバー名とタイプが追加されます。
    6. 「設定」ダイアログで、「OK」をクリックします。

次のタスク

使用可能なターゲット・サーバーのリストを変更するには、「ウィンドウ」>「設定」>「サーバー」>「ランタイム環境」とクリックして、「設定」ダイアログの「サーバー・ランタイム環境」セクションに進みます。 必要なときにターゲット・サーバーのリストを変更する場合、「追加」、 「編集」、「削除」、または「検索」のオプションを使用してください。

モジュールのターゲット・サーバーを変更するには、次のようにします。
  1. 「プロジェクト・エクスプローラー」ビューでそのモジュールを右クリックし、「プロパティー」>「プロジェクト・ファセット」とクリックします。 「プロジェクト・ファセット」ページが開きます。
  2. 「ランタイム」タブを選択します。
  3. 「ランタイム」 テーブルの下でモジュールのターゲット・サーバーを選択します。
重要: 仕様レベル 2.1 以前の EJB プロジェクト用のターゲット・サーバーを変更する場合は、EJB プロジェクトを右クリックし、「デプロイメントの準備」を選択して、デプロイメント・コードを再生成します。生成されたデプロイメント・コードとは 異なるサーバー・ターゲットでアプリケーションを実行しようとすると、アプリケーションの実行が失敗します。

フィードバック