アプリケーション・インストール・バインディング設定の準備

このページを使用すると、インストール時にすべてのインストール・オプションを表示して、アプリケーションまたはモジュールの既存バインディングを変更するかどうかを選択することができます。 アプリケーションまたはモジュール内にある不完全なバインディング用にデフォルト・バインディングを生成したり、インストール中に 特定のバインディングを割り当てたりすることを選択できます。

このページは、2 番目の「アプリケーション・インストールの準備」ページです。

この管理コンソール・ページを表示するには、 「アプリケーション」 > 「新規アプリケーション」 > 「新規エンタープライズ・アプリケーション (New Enterprise Application)」とクリックし、インストールするアプリケーションまたはモジュールのパスを指定してから、「次へ」とクリックします。

コンソール・ページには、このトピックにリストされているバインディング・オプションのすべてが表示されるわけではありません。 インストールするアプリケーションまたはモジュールの内容によって、コンソール・ページに表示されるオプションが決まります。 また、「使用するバインディングの指定」オプションは、インストール済みのアプリケーションを更新する場合にのみ表示されます。

アプリケーションをどのようにインストールしますか?

情報の指定を要求するインストール・オプションのみを表示するか、 すべてのインストール・オプションを表示するかを指定します。

オプション 説明
ファースト・パス - 追加情報が必要な場合のみプロンプトを出す (Fast Path - Prompt only when additional information is required) ご使用のアプリケーションまたはモジュールの内容に基づいて、注意を必要とするオプションのみを表示します。 このファースト・パスを使用すると、選択可能なすべてのインストール・オプションを調べる必要がないため、 アプリケーションのインストールをより簡単に行うことができます。
詳細 - すべてのインストール・オプションおよびパラメーターの表示 (Detailed - Show all installation options and parameters) 使用可能なすべてのインストール・オプションを表示します。
使用するバインディングの指定

アプリケーションを更新する場合にバインディングをマージするか、新規または既存のバインディングを使用するかを指定します。

この設定はインストールされたアプリケーションを更新する場合のみ表示され、新規アプリケーションをインストールする場合は表示されません。

オプション 説明
新規および既存バインディングのマージ インストールされたアプリケーションの既存のバインディング値を保持し、不完全なバインディングに対して更新されたアプリケーションに新規バインディング値を追加します。 更新されたアプリケーションのバインディング値が、インストールされたアプリケーションに指定した値と異なる場合は、マージを使用します。 この製品は以下の順序でバインディング値を割り当てます。
  1. インストールされたアプリケーションの既存のバインディング値を使用します。
  2. インストールされたアプリケーションにバインディング値がない場合は、新規バインディング値を使用します。
  3. インストールされたアプリケーションおよび更新されたアプリケーションの両方にバインディング値がない場合は、デフォルト値を使用します。 この製品は、「デフォルト・バインディングの生成」を選択した場合のみデフォルト値を割り当てます。
新規バインディングの使用 更新されたアプリケーションのバインディング値を使用します。インストールされたアプリケーションの既存のバインディング値は使用しません。
既存バインディングの使用 インストールされたアプリケーションの既存のバインディング値を使用します。更新されたアプリケーションのバインディング値は使用しません。
デフォルト・バインディングの生成

デフォルト・バインディングおよびマッピングを生成するかどうかを指定します。 この設定を表示するには、「デフォルト・バインディングおよびマッピングの生成の選択 (Choose to generate default bindings and mappings)」を展開します。「デフォルト・バインディングの生成」を選択する場合、この製品はデフォルト値を使用して、アプリケーションの不完全なバインディングを完了します。 既存のバインディングは変更されません。

デフォルト・バインディングの生成」を選択し、どのステップにも赤いアスタリスク (*) が付いていなければ、「サマリー」ステップに直接進んで、アプリケーションをインストールできます。 赤のアスタリスクは、そのステップのデータが不完全であり、有効な値が必要であることを示しています。 「サマリー」パネルでは、 アプリケーションのインストールされるセル、ノード、およびサーバーを確認してください。

遷移: EJB bean、ローカル・ホーム、リモート・ホーム、または EJB 3.0 モジュールのビジネス・インターフェースに対して Java™ Naming and Directory Interface (JNDI) の値を指定する必要はありません。 この製品はランタイム中にコンテナーのデフォルト値を割り当てます。同様に、EJB 3.0、Web 2.4 または Web 2.5 モジュール内の EJB 参照の場合、ランタイム中に自動的にターゲットが解決されるため、JNDI の値を指定する必要はありません。 「デフォルト・バインディングの生成」を選択した場合でも、この製品は、それらの JNDI の値に対してデフォルト値を生成しませんが、仮想ホストなどのほかのバインディングに対してはデフォルト値を生成します。

デフォルト・バインディングの生成」を選択した場合、この製品は以下の方法でバインディングを生成します。

  • エンタープライズ Bean (EJB) JNDI 名は、prefix/ejb-name の形式で生成されます。 デフォルトの接頭部は ejb ですが、オーバーライドすることができます。 ejb-name は、デプロイメント記述子の <ejb-name> タグ、または EJB 3.0 モジュールの対応する注釈での指定と同様です。ランタイムによりコンテナーのデフォルト値が提供されるので、この製品は EJB 3.0 モジュールのエンタープライズ Beans に対してデフォルト値を生成しません。
  • EJB 参照は、<ejb-link> が検出されるとバインドされます。 それ以外では、固有の エンタープライズ Bean が、参照 Bean として、 一致するホーム (またはローカル・ホーム) インターフェースとともに検出された場合、 その参照は自動的に解決されます。ランタイムによりコンテナーのデフォルト値が提供されたり、自動的にターゲット参照が解決されるので、この製品は EJB 3.0、Web 2.4、または Web 2.5 モジュールの EJB 参照に対してデフォルト値を生成しません。
  • リソース参照バインディングは、<res-ref-name> タグまたは Java Platform, Enterprise Edition (Java EE) 5 モジュールの対応する注釈から派生します。 このアクションは、java:comp/env 名がリソースのグローバル JNDI 名と同じであることを前提としています。
  • EJB 2.0 および EJB 2.1 JAR ファイル用接続ファクトリー・バインディングは、 提供された JNDI 名と許可情報を基に、生成されます。 このアクションの結果、 インストールされるアプリケーションの各 EJB 2.0 および EJB 2.1 JAR ファイルに対してデフォルトの接続ファクトリーが設定されます。 Bean レベルの接続ファクトリーのバインディングは、生成されません。
  • EJB 1.1 JAR ファイル用データ・ソース・バインディングは、JNDI 名、 データ・ソースのユーザー名とパスワードのオプションを基に、生成されます。 このアクションの結果、各 JAR ファイルに対してデフォルトのデータ・ソースが設定されます。 Bean レベルのデータ・ソースのバインディングは、生成されません。
  • Java EE Connector Architecture (JCA) 1.5 準拠リソースとしてデプロイされた EJB 2.0 以降のメッセージ駆動型 Bean の場合、 activationSpec インスタンスに対応する JNDI 名が eis/MDB_ejb-name の形式で生成されます。 メッセージ宛先参照は、<message-destination-link> が検出され、JNDI 名が ejs/message-destination-linkName に設定された場合にバインドされます。 それ以外の場合、JNDI 名は eis/message-destination-refName に設定されます。
  • リスナー・ポートに対してデプロイされた EJB 2.0 以降のメッセージ駆動型 Bean の場合、 リスナー・ポートはメッセージ 駆動型 Bean の <ejb-name> タグから 派生し、Port ストリングが付加されます。
  • .war ファイルの場合、特に指定されないかぎり、仮想ホストが default_host として設定されます。

ほとんどのアプリケーション、または少なくともほとんどのアプリケーションのほとんどのバインディングは、 デフォルトのストラテジーで十分です。 ただし、エラーが発生する場合は、以下のアクションを実行してください。

  • 1 つ以上の EJB ファイルのグローバル JNDI 名を制御する。
  • コンテナー管理パーシスタンス (CMP) Bean のデータ・ソース・バインディングを制御する。 つまり、複数のデータ・ソースがあり、複数のグローバル・データ・ソースを必要とする場合。
  • リソース参照をグローバル・リソースの java:comp/env とは異なる JNDI 名にマップする。

そのような場合は、XML 文書を使用して動作を変更することができます (カスタム・ストラテジー)。 「特定バインディング・ファイル」設定を使用して、 カスタム・ストラテジーを指定したり、このヘルプ・ファイルにある設定の説明で例を参照します。

既存バインディングをオーバーライドする

生成したバインディングで既存のバインディングを置き換えるかどうかを指定します。

デフォルトでは、既存バインディングをオーバーライドしません。生成したバインディングで既存バインディングを置き換えるには、「既存バインディングをオーバーライドする」を選択します。

既存バインディングをオーバーライドする」は、-defaultbinding.force スクリプト・オプションに似ています。

特定のバインディング・ファイル

デフォルト・バインディングをオーバーライドするバインディング・ファイルを指定します。

特定のバインディング・ファイル」は、-defaultbinding.strategy.file スクリプト・オプションに似ています。

XML 文書でデフォルト・バインディングの動作を変更します (カスタム・ストラテジー)。 カスタム・ストラテジーは、デフォルト・ストラテジーを拡張するので、 デフォルト・ストラテジーが不十分な領域のみをカスタマイズする必要があります。 すなわち、必要なのは、デフォルト・ストラテジーによって生成されたバインディングを変更する方法の記述のみで、 アプリケーション全体のバインディングを定義する必要はありません。

デフォルト・バインディング・ジェネレーターのさまざまな局面をオーバーライドするには、以下の例を使用します。

EJB JNDI 名の制御

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>helloEjb.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
要確認: <ejb-name> の設定が、EJB JAR デプロイメント記述子の ejb-name 記入項目と一致することを確認します。ここで、設定は <ejb-name>HelloEjb</ejb-name> です。

EJB JAR ファイルの接続ファクトリー・バインディングの設定

<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <connection-factory>
        <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
        <res-auth>Container</res-auth>
      </connection-factory>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

EJB ファイルの接続ファクトリー・バインディングの設定

<?xml version="1.0">
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourCmp20</ejb-name>
          <connection-factory>
           <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
           <res-auth>PerConnFact</res-auth>
          </connection-factory>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
 </module-bindings>
</dfltbndngs>
制約事項: <ejb-name> の設定が、デプロイメント記述子の ejb-name タグと一致することを確認します。ここで、設定は <ejb-name>YourCmp20</ejb-name> です。

特定のエンタープライズ Bean のメッセージ宛先参照 JNDI の設定

これは、特定のエンタープライズ Bean の message-destination-refs を設定するための、 カスタム・ストラテジー・ファイルにおける XML 例の一部を示しています。

<?xml version="1.0">
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
 <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
    <jar-name>yourEjb21.jar</jar-name>
    <ejb-bindings>
     <ejb-binding>
      <ejb-name>YourSession21</ejb-name> 
      <message-destination-ref-bindings>
       <message-destination-ref-binding>
        <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>
        <jndi-name>eis/somAO</jndi-name>
       </message-destination-ref-binding>
      </message-destination-ref-bindings>
     </ejb-binding>
    </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>
制約事項: <ejb-name> の設定が、デプロイメント記述子の ejb-name タグと一致することを確認します。ここで、設定は <ejb-name>YourSession21</ejb-name> です。また、<message-destination-ref-name> の設定が、デプロイメント記述子の message-destination-ref-name タグと一致することを確認します。 ここで、設定は <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name> です。

WAR、EJB JAR ファイル、 または Java EE クライアント JAR ファイルからのリソース参照バインディングのオーバーライド

この例は、WAR ファイルからリソース参照バインディングをオーバーライドするコードを示しています。 類似コードを使用して、エンタープライズ Bean (EJB) JAR ファイルまたは Java EE クライアント JAR ファイルからのリソース参照バインディングをオーバーライドします。

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <war-binding>
      <jar-name>hello.war</jar-name>
      <resource-ref-bindings>
        <resource-ref-binding>
          <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>
          <jndi-name>war/override/dataSource</jndi-name>
        </resource-ref-binding>
      </resource-ref-bindings>
    </war-binding>
  </module-bindings>
</dfltbndngs>
制約事項: <resource-ref-name> の設定が、デプロイメント記述子の resource-ref タグと一致することを確認します。前の例では、設定は <resource-ref-name>jdbc/MyDataSrc</resource-ref-name> です。

JCA 1.5 準拠リソースとしてデプロイされたメッセージ駆動型 Bean の JNDI 名のオーバーライド

これは、JCA 1.5 準拠リソースとしてデプロイされた EJB 2.0 以降のメッセージ駆動型 Bean の JMS activationSpec JNDI 名をオーバーライドするための、 カスタム・ストラテジー・ファイルにおける XML 例の一部を示しています。

<?xml version="1.0"?>
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
  <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
     <jar-name>YourEjbJar.jar</jar-name>
     <ejb-bindings>
      <ejb-binding>
        <ejb-name>YourMDB</ejb-name>
        <activationspec-jndi-name>activationSpecJNDI</activationspec-jndi-name>
      </ejb-binding>
     </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>

EJB 2.0、2.1、3.0 メッセージ駆動型 Bean の JMS リスナー・ポート名のオーバーライド

これは、リスナー・ポートに対してデプロイされた EJB 2.0 以降のメッセージ駆動型 Bean の JMS リスナー・ポート名をオーバーライドするための、 カスタム・ストラテジー・ファイルにおける XML 例の一部を示しています。

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourMDB</ejb-name>
          <listener-port>yourMdbListPort</listener-port>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

EJB JAR、WAR ファイル、または EJB ファイルからの EJB 参照バインディングのオーバーライド

この例は、EJB JAR ファイルから EJB 参照バインディングをオーバーライドするためのコードを示しています。 同様のコードを使用して、WAR ファイルまたは EJB ファイルから EJB 参照バインディングをオーバーライドします。

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-ref-bindings>
        <ejb-ref-binding>
          <ejb-ref-name>YourEjb</ejb-ref-name>
          <jndi-name>YourEjb/JNDI</jndi-name>
        </ejb-ref-binding>
      </ejb-ref-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
Bean に固有接頭部を指定する

この製品が生成されたエンタープライズ Bean JNDI 名の最初の部分に適用するストリングを指定します。 接頭部はセルまたはノード内で固有でなければなりません。

デフォルトでは、Bean に固有接頭部を指定していません。

Bean に固有接頭部を指定する (Specify unique prefix for beans)」は、スクリプト・オプション -defaultbinding.ejbjndi.prefix に似ています。

EJB 1.1 CMP Bean のデフォルト・バインディング

コンテナー管理パーシスタンス (CMP) 1.1 Bean のデフォルト・データ・ソースの JNDI 名および他のバインディングを指定します。

デフォルトでは、EJB 1.1 CMP Bean のデフォルト・バインディングを使用しません。

EJB 1.1 CMP Bean のデフォルト・バインディング (Default bindings for EJB 1.1 CMP beans)」を選択する場合、コンテナー管理パーシスタンス (CMP) 1.1 Bean で使用するデフォルト・データ・ソースの JNDI 名を指定してください。 また、このデフォルト・データ・ソースのユーザー名およびパスワードも指定します。

EJB 1.1 CMP Bean のデフォルト・バインディング (Default bindings for EJB 1.1 CMP beans)」は、スクリプト・オプション -defaultbinding.datasource.jndi と似ています。

デフォルト接続ファクトリー・バインディング

デフォルト接続ファクトリーの JNDI 名を指定します。

デフォルトでは、デフォルト接続ファクトリー・バインディングを使用しません。「デフォルト接続ファクトリー・バインディング」を選択して、接続ファクトリーのバインディングを指定します。

デフォルト接続ファクトリー・バインディング」を選択する場合、使用するデフォルト接続ファクトリーの JNDI 名を指定してください。 また、アプリケーションまたはコンテナー全体に対してリソース許可があるかを指定してください。

デフォルト接続ファクトリー・バインディング」は、スクリプト・オプション -defaultbinding.cf.jndi と似ています。

Web モジュールおよび SIP モジュールにデフォルト仮想ホスト名を使用する

Web モジュール (WAR ファイル) または Session Initiation Protocol (SIP) モジュール (SAR ファイル) の仮想ホストを指定します。

デフォルトでは、Web モジュールまたは SIP モジュールにデフォルト仮想ホスト名を使用しません。「Web モジュールおよび SIP モジュールにデフォルト仮想ホスト名を使用する」を選択する場合、デフォルトのホスト名を指定してください。

Web モジュールおよび SIP モジュールにデフォルト仮想ホスト名を使用する」は、スクリプト・オプション -defaultbinding.virtual.host に似ています。




マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。

関連概念
関連タスク
関連情報
アプリケーション・インストール設定の準備


ファイル名: urun_rapp_instw_gendefbind.html