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

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

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

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

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

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

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

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

使用するバインディングの指定

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

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

表 2. バインディング・オプションの説明。マージされたバインディング、新規のバインディング、または既存のバインディングを使用できます。
オプション	説明
新規および既存バインディングのマージ	更新アプリケーションまたはモジュールのバインディング情報は、インストール済みバージョンの対応するバインディング情報より優先されます。更新バージョン内でバインディングのいずれかのエレメントが欠落している場合は、インストール済みバージョンの対応するエレメントが使用されます。インストール済みおよび更新アプリケーションまたはモジュールの両方にバインディング値がない場合は、デフォルト値が使用されます。「デフォルト・バインディングの生成」オプションを選択した場合のみ、製品によってデフォルト値が割り当てられます。
新規バインディングの使用	更新アプリケーションまたはモジュールのバインディング情報が使用されます。更新バージョンのアプリケーションまたはモジュールのバインディング情報は、インストール済みバージョンの対応するバインディング情報より優先されます。インストール済みバージョンのアプリケーションまたはモジュールのバインディング情報は無視されます。
既存バインディングの使用	インストール済みバージョンのアプリケーションまたはモジュールのバインディング情報は、更新バージョンの対応するバインディング情報より優先されます。バインディング情報のエレメントがインストール済みバージョンに存在しない場合、更新バージョンのエレメントが使用されます。つまり、インストール済みバージョンにバインディングが存在する場合、更新バージョンのアプリケーションまたはモジュールのバインディングは無視されます。存在しない場合は、新しいバインディングが採用され、無視されません。

デフォルト・バインディングの生成

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

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

遷移: EJB Bean、ローカル・ホーム、リモート・ホーム、または EJB 3.0 以降のモジュールのビジネス・インターフェースに対して、Java Naming and Directory Interface (JNDI) の値を指定する必要はありません。コンテナーのデフォルト値が、実行時に製品によって割り当てられます。同様に、実行時に製品によってターゲットが自動的に解決されるため、EJB 3.0、EJB 3.1、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、EJB 3.1、Web 2.4、または Web 2.5 モジュールの EJB 参照に対してデフォルト値を生成しません。
リソース参照バインディングは、<res-ref-name> タグまたは Java Platform, Enterprise Edition (Java EE) 5 または 6 モジュールの対応する注釈から派生します。このアクションは、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 スクリプト・オプションに似ています。

Java EE デフォルト・バインディングの使用

生成されたバインディングが Java Platform, Enterprise Edition (Java EE) バインディングの事前構成されたデフォルト・リソース・オプションを使用するかどうかを指定します。

デフォルトでは、Java EE バインディングの事前構成されたデフォルト・リソースを使用しません。生成されたバインディングを Java EE デフォルトにするには、「Java EE デフォルト・バインディングの使用」を選択します。

「Java EE デフォルト・バインディングの使用」は、-defaultbinding.ee.defaults スクリプト・オプションに似ています。

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

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

「特定のバインディング・ファイル」は、-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 の Java Message Service (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