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

このページを使用して、アプリケーション (EAR ファイル) またはモジュール (JAR または WAR ファイル) をインストールします。

この管理コンソール・ページを表示するには、「アプリケーション」>「新規アプリケーションのインストール」をクリックします。

このページのステップに従って、アプリケーションまたはモジュールをインストールします。 少なくとも最初のステップは完了する必要があります。それ以降のステップのいくつか、 またはすべてを完了する必要があるかどうかは、アプリケーション、EJB モジュール、 または Web モジュールのいずれをインストールするかによります。

パス
エンタープライズ・アプリケーションの .ear、.jar、または .war ファイルへの完全修飾パスを指定します。

ブラウザーとアプリケーション・ファイルが同一マシン上にある場合 (サーバーもそのマシン上にあるかないかにかかわらず)、「ローカル・パス」を使用します。

アプリケーション・ファイルが現行セルのコンテキストのいずれかのノードにある場合、「 サーバー・パス」を使用します。 選択ノードでノード・エージェントまたはデプロイメント・マネージャーが実行中の場合、 そのノードのファイル・システム全体をブラウズすることができます。 ブラウズ中に表示されるのは、.ear、.jar、または .war ファイルのみです。

アプリケーションのインストール中、アプリケーション・ファイルは通常、 ブラウザーを稼働しているクライアント・マシンから、そのファイルがデプロイされる、 管理コンソールを稼働しているサーバー・マシンにアップロードされます。 この場合、サーバー・マシンにアップロードされる EAR、WAR、または JAR モジュールの選択には、 管理コンソールが稼働する Web ブラウザーが使用されます。

ただし場合によっては、アプリケーション・ファイルが、 セル内の任意のノードのファイル・システム上に常駐していることがあります。 このようなファイルをアプリケーション・サーバーでインストールする場合は、「 サーバー・パス」オプションを使用してください。

このオプションを使用して、 アプリケーション・サーバーを実行中のマシンにすでにあるアプリケーション・ファイルを指定することもできます。 例えば、Windows NT におけるこのフィールドの値は、 C:¥WebSphere¥AppServer¥installableApps¥test.ear のようになります。 スタンドアロンの WAR モジュールをインストールする場合、コンテキスト・ルートも指定する必要があります。

コンテキスト・ルート
Web アプリケーション (WAR) のコンテキスト・ルートを指定します。

このフィールドは、スタンドアロンの WAR ファイルをインストールする場合にのみ使用します。コンテキスト・ルートは、(WAR ファイルからの) 定義済みのサーブレット・マッピングと組み合わされて、ユーザーがサーブレットへのアクセス時に入力する完全 URL を構成します。 例えば、コンテキスト・ルートが /gettingstarted で、サーブレット・マッピングが MySession の場合、URL は http://host:port/gettingstarted/MySession となります。

デフォルト・バインディングの生成
デフォルト・バインディングを生成するかどうかを指定します。 チェック・ボックスにチェックマークを付けた場合、アプリケーション内の 不完全なバインディングはすべてデフォルト値で埋められます。 既存のバインディングは、変更されません。

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

バインディングは、次のように生成されます。

ほとんどのアプリケーション、または少なくともほとんどのアプリケーションのほとんどのバインディングは、 デフォルトのストラテジーで十分です。 ただし、以下の場合は機能しません。

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

プレフィックス
生成される JNDI 名に使用するプレフィックスを指定します。
オーバーライド
既存のバインディングをオーバーライドするかどうかを指定します。

このチェック・ボックスがチェックされていると、 既存のバインディングは、生成されたバインディングでオーバーライドされます。

EJB 1.1 CMP バインディング
デフォルト・データ・ソースの JNDI 名を指定します。

EJB 1.1 CMP のデフォルト・バインディング」ラジオ・ボタンが選択されている場合は、 CMP 1.1 Bean で使用されるデフォルトのデータ・ソースの JNDI 名を指定してください。 また、このデフォルト・データ・ソースのユーザー ID とパスワードも指定します。

接続ファクトリー・バインディング
デフォルト・データ・ソースの JNDI 名を指定します。

デフォルト接続ファクトリー・バインディング」ラジオ・ボタンが選択されている場合は、 バインディングで使用されるデフォルトのデータ・ソースの JNDI 名を指定してください。 また、リソース許可も指定します。

仮想ホスト
WAR モジュールの仮想ホストを指定します。
特定バインディング・ファイル
デフォルト・バインディングをオーバーライドするバインディング・ファイルを指定します。

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

デフォルト・バインディング生成プログラムのさまざまな局面をオーバーライドする方法の簡単な例は次のとおりです。

EJB JNDI 名の制御

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>helloEjb.jar</jar-name>
<!-- この名前は .ear ファイル内のモジュール名と一致しなければなりません -->
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
<!-- これは、EJB JAR DD 内の <ejb-name> エントリーと一致しなければなりません -->
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

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>
<!-- これは DD の 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>

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

WAR ファイルからリソース参照バインディングをオーバーライドするサンプル・コードは次のとおりです。 類似コードを使用して、 EJB JAR ファイルまたは J2EE クライアント 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>
          <!-- 以下は DD 内のリソース参照と一致しなければなりません -->
          <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>

MDB JMS リスナー・ポートのオーバーライド

<?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>

関連情報

管理コンソールのボタン