アダプタのデプロイ

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > WebLogic Integration > AI トピック > アダプタの開発 > アダプタのデプロイ

アダプタの開発

アダプタのデプロイ

アダプタを作成した後は、エンタープライズアーカイブ（EAR）ファイルを使用して、これをデプロイする必要があります。EAR ファイルを使用すると、すべてのアダプタコンポーネントを 1 度にデプロイできるため、このタスクを効率的に行えます。EAR ファイルのデプロイは、WebLogic Server Administration Console から実行できます。

この章の内容は以下のとおりです。

エンタープライズアーカイブ（EAR）ファイルの使用

各アダプタは、1 つのエンタープライズアーカイブ（EAR）ファイルを使用してデプロイされます。EAR ファイルには、デプロイに必要な設定時 Web アプリケーションの WAR ファイル、アダプタ RAR ファイル、アダプタ JAR ファイルおよび共有の JAR ファイルが含まれています。この EAR ファイルは、リスト9-1 のような構造にします。

コードリスト 9-1 EAR ファイル構造

adapter.ear
     application.xml
     sharedJar.jar
     adapter.jar
     adapter.rar
          META-INF
               ra.xml
               weblogic-ra.xml
               MANIFEST.MF
     designtime.war
          WEB-INF
               web.xml
          META-INF
               MANIFEST.MF

サンプルアダプタの EAR ファイルをリスト9-2 に示します。

コードリスト 9-2 サンプルアダプタの EAR ファイル

sample.ear
 application.xml
   adk.jar (shared .jar between .war and .rar)
   bea.jar (shared .jar between .war and .rar)
   BEA_WLS_SAMPLE_ADK.jar (shared .jar between .war and .rar)

    BEA_WLS_SAMPLE_ADK.war (Web application with
         META-INF/MANIFEST.MF entry Class-Path:
      BEA_WLS_SAMPLE_ADK.jar adk.jar bea.jar log4j.jar 
        logtoolkit.jar xcci.jar xmltoolkit.jar)

    BEA_WLS_SAMPLE_ADK.rar (Resource Adapter with
      META-INF/MANIFEST.MF entry Class-Path: 
       BEA_WLS_SAMPLE_ADK.jar adk.jar bea.jar log4j.jar
       logtoolkit.jar xcci.jar xmltoolkit.jar)

	log4j.jar (shared .jar between .war and .rar)
	logtoolkit.jar (shared .jar between .war and .rar)
	xcci.jar (shared .jar between .war and .rar)
	xmltoolkit.jar (shared .jar between .war and .rar)

RAR ファイルと WAR ファイルのいずれも共有 JAR ファイルは含んでおらず、< manifest.classpath> 属性を使用して共有 JAR ファイルを参照します。

EAR ファイルにおける共有 JAR ファイルの使い方

設計時アプリケーションは、アダプタの SPI クラスを非管理対象のシナリオで使用します。そのため、アダプタの SPI および CCI クラスは、EAR ファイルと同じディレクトリにある共有 JAR ファイルに含まれます。WAR および RAR クラスローダから共有JAR ファイル中のクラスにアクセスできるようにするには、MANIFEST.MF ファイルで、共有 EAR ファイルのインクルードを要求する必要があります。MANIFEST.FM の詳細については、Manifest ファイルまたは次の URL で参照してください。

http://developer.java.sun.com/developer/Books/JAR/basics/manifest.html

BEA_WLS_SAMPLE_ADK.rar および BEA_WLS_SAMPLE_ADK.war には、リスト9-3 のような META-INF/MANIFEST.MF が含まれています。

コードリスト 9-3 Manifest ファイルの例

Manifest-Version: 1.0

Created-By: BEA Systems, Inc.

Class-Path: BEA_WLS_SAMPLE_ADK.jar adk.jar wlai-core.jar
 wlai-client.jar

注意: ファイル名 MANIFEST.MF は、すべて大文字で表記します。正しく表記されていない場合、UNIX システムでは認識されず、エラーが発生します。

EAR ファイルのデプロイメント記述子

リスト9-4 に、EAR ファイルのコンポーネントを宣言するデプロイメント記述子を示します。この場合、これらのコンポーネントには設計時 WAR およびアダプタ RAR モジュールが含まれます。

コードリスト 9-4 EAR ファイルのデプロイメント記述子

<!DOCTYPE application PUBLIC '-//Sun Microsystems, Inc.//DTD J2EE Application 1.3//EN'
'http://java.sun.com/dtd/application_1_3.dtd'>

<application>
   <display-name>BEA_WLS_SAMPLE_ADK</display-name>
   <description>This is a J2EE application that contains a sample
      connector and Web application for configuring 
      application views for the adapter.</description>
   <module>
      <connector>BEA_WLS_SAMPLE_ADK.rar</connector>
   </module>
   <module>
      <web>
        <web-uri>BEA_WLS_SAMPLE_ADK.war</web-uri>
        <context-root>BEA_WLS_SAMPLE_ADK_Web</context-root>
      </web>
   </module>
   </application>

アダプタのデプロイは、WebLogic Server Administration Console から実行できます。この手順については、WebLogic Server Administration Console を使用したアダプタのデプロイで説明しています。

WebLogic Server Administration Console を使用したアダプタのデプロイ

WebLogic Server Administration Console を使用して、アダプタをコンフィグレーションまたはデプロイする手順は次のとおりです。

WebLogic Server Administration Console を起動します。
ナビゲーションツリー（左ペイン）で、[デプロイメント｜アプリケーション] を選択します。

[アプリケーション] ページが表示されます。
[新しい Application のコンフィグレーション] を選択します。

[新しい Application のコンフィグレーション] ページが表示されます。
以下のフィールドに値を入力します。
[適用] をクリックして、新しいエントリを作成します。
[コンポーネントの構成] を選択します。
各コンポーネントに個別のターゲットを設定します。

WebLogic Server Administration Console からアプリケーション（またはアプリケーションコンポーネント）をインストールすると、該当するドメインのコンフィグレーションファイル（/config/DOMAIN_NAME/config.xml －ここで DOMAIN_NAME はドメイン名）にもそのアプリケーションまたはコンポーネントのエントリが作成されます。また、アプリケーションとアプリケーションコンポーネントをコンフィグレーションしモニタするための JMX Management Beans (MBeans) も生成されます。

アダプタの自動登録

WebLogic Integration では、アダプタのデプロイ時に、自動登録プロセスが実行されます。自動登録は、アダプタのデプロイメントフェーズ中に実行されます。このプロセスは、以下の 2 つのうちいずれかの方法で呼び出せます。

命名規約の使用

設計時 Web アプリケーションとコネクタのデプロイメントには、命名規約を使用することをお勧めします。

EAR ファイルを WebLogic Integration 環境でデプロイする際、アダプタの論理名をファイル名として使用し、config.xml でファイルを定義します。リスト9-5 で、その例を示します。

コードリスト 9-5 config.xml ファイルにアダプタの論理名を追加

<Application Deployed="true" Name="ALN"
      Path="WLI_HOME/adapters/ADAPTER/lib/ALN.ear">
    <ConnectorComponent Name="ALN" Targets="myserver"
     URI="ALN.rar"/>
   <WebAppComponent Name="ALN_EventRouter" Targets="myserver"
      URI="ALN_EventRouter.war"/>
   <WebAppComponent Name="ALN_Web" Targets="myserver"
      URI="ALN_Web.war"/>
</Application>

リストでは、ALN フィールドにアダプタの論理名を入力します。この名前を、<ConnectorComponent> 要素の Name 属性の値として使用してください。

設計時 Web アプリケーションのデプロイメントに ALN_Web という名前を割り当てると、デプロイメントの際に、設計時 Web アプリケーションが自動的に Application View Management Console に登録されます。この命名規約は、DBMS およびサンプルアダプタで使用されます。

テキストファイルの使用

あるいは、webcontext.txt という名前のテキストファイルを EAR ファイルのパス名のルートディレクトリにインクルードできます。webcontext.txt ファイルには、アダプタの設計時 Web アプリケーションのコンテキストが含まれます。このファイルは、UTF-8 でエンコーディングする必要があります。

Web アプリケーションのデプロイメント記述子の編集

いくつかのアダプタに対し、イベントルータの Web アプリケーションで使用されるデプロイメントパラメータを変更しなければならない場合があります。たとえば、DBMS アダプタの場合、対応するイベントジェネレータで使用されるデータソースの変更が必要になります。

この節では、WebLogic Server Administration Console の Deployment Descriptor Editor を使用して、以下の Web アプリケーションデプロイメント記述子を編集する方法について説明します。

web.xml
weblogic.xml

デプロイメントパラメータ

イベントルータサーブレットのパラメータは、どれでも変更できます。以下のパラメータがあります。

eventGeneratorClassName
userID
password
dataSource
jdbcDriverClassName
dbURL
dbAccessFlag
eventCatalog
eventSchema
RootLogContext
AdditionalLogContext
LogConfigFile
LogLevel
MessageBundleBase
LanguageCode
CountryCode
sleepCount

デプロイメント記述子の編集

Web アプリケーションのデプロイメント記述子を編集する手順は次のとおりです。

次の URL にアクセスして、ブラウザから WebLogic Server Administration Console を開きます。
http://host:port/console
この URL で、host は WebLogic Server が稼動するコンピュータ名、port はWebLogic Server のリスンポート番号に置き換えます。例 :
http://localhost:7001/console
左ペインで、[デプロイメント] ノードおよびその下の [Web アプリケーション] ノードを展開します。
デプロイメント記述子を編集する Web アプリケーションの名前を右クリックします。ドロップダウンメニューから、［Web アプリケーションデプロイメント記述子の編集］を選択します。WebLogic Server Administration Console が、新しいブラウザに表示されます。

Console は、2 つのペインで構成されています。左ペインには、2 つの Web アプリケーションデプロイメント記述子のすべての要素で構成されたナビゲーションツリーが含まれます。右ペインには、web.xml ファイルの説明要素のフォームが含まれます。
Web アプリケーションデプロイメント記述子の要素の編集、削除、または追加には、左ペインで編集対象のデプロイメント記述子に対応するノードを展開します。以下のノードがあります。
- Web App Descriptor ノードには、web.xml デプロイメント記述子の要素があります。
- WebApp Ext ノードには、weblogic.xml デプロイメント記述子の要素があります。
Web アプリケーションデプロイメント記述子の既存の要素を編集する手順は次のとおりです。
Web アプリケーションデプロイメント記述子に新しい要素を追加する手順は次のとおりです。
Web アプリケーションデプロイメント記述子から既存の要素を削除する手順は次のとおりです。
Web アプリケーションデプロイメント記述子の変更がすべて完了したら、左側のペインでツリーのルート要素をクリックします。ルート要素は、Web アプリケーションの *.war アーカイブファイルの名前または Web アプリケーションの表示名です。
Web アプリケーションデプロイメント記述子のエントリが有効かどうかを確認する場合は、[検証] をクリックします。
[永続化] をクリックして、編集したデプロイメント記述子ファイルを WebLogic Server のメモリだけでなく、ディスクに書き込みます。

WebLogic Integrator クラスタでのアダプタのデプロイメント

アダプタは、WebLogic Integration クラスタにデプロイできます。クラスタ化 WebLogic Integration 環境におけるアダプタのデプロイの詳細については、『WebLogic Integration ソリューションのデプロイメント』の「WebLogic Integration クラスタについて」を参照してください。