C デプロイメント用のWebLogic Mavenプラグインの使用

Apache Mavenは、Javaベースのプロジェクトの構築および管理のためのツールです。WebLogic Server用のMavenプラグイン(weblogic-maven-plugin)を使用して、コマンドライン・ユーティリティweblogic.Deployerによるサポートと同様のデプロイメント・オペレーションを行うことができます。プラグインを使用して、デプロイ、再デプロイ、アップデートができます。これらアプリケーションがMaven環境上のWebLogic ServerにMavenを使用して構築されます。

サポートされているプラットフォームでMavenをダウンロードおよび構成するには、http://maven.apache.org/download.htmlを参照してください。セットアップの指示に従って、Mavenが環境で正しく動作することを確認してください。

アプリケーションとプロジェクトを構築するためのMavenの使用方法の詳細は、http://maven.apache.org/users/index.htmlのMavenユーザー・センターに関する項を参照してください。

次の項では、デプロイメント用のweblogic-maven-pluginの使用方法について説明します。

• WebLogic Mavenプラグインの構成と使用方法

• デプロイメントの目標

• トラブルシューティング

WebLogic Mavenプラグインの構成と使用方法

weblogic-maven-pluginを作成、インストール、および使用するには、次の手順を実行します。

注意: これらの手順を正常に終了するには、コンピュータをインターネットに接続して、settings.xmlファイル(通常は$HOME/.m2/settings.xml)では必要なプロキシ設定を正しく構成する必要があります。詳細は、http://maven.apache.org/guides/mini/guide-proxies.htmlを参照してください。

1. 次のコマンドで、MW_HOME/wlserver_10.3/server/lib/の下のWebLogic JarBuilderツール(wljarbuilder)を使用してプラグインJARファイルを作成します。

   java -jar wljarbuilder.jar -profile weblogic-maven-plugin
   

   weblogic-maven-plugin.jarには、weblogic-maven-plugin.jarのgroupId、artifactId、version、およびpackagingを指定するプロジェクト・オブジェクト・モデル(pom.xml)ファイルが含まれます。

   groupId=com.oracle.weblogic
   artifactId=weblogic-maven-plugin
   version=10.3.4
   packaging=maven-plugin
   

   これらのフィールドは、プラグインを認識して、Mavenプロジェクトのコーディネート・システムとして稼働するMavenリポジトリに、特定の場所をマークします。

2. MW_HOME/wlserver_10.3/server/libディレクトリの下のweblogic-maven-plugin.jarからpom.xmlファイルを抽出して、pom.xmlファイルをMW_HOME/wlserver_10.3/server/libにコピーします。

   例:

   jar xvf MW_HOME/wlserver_10.3/server/lib/weblogic-maven-plugin.jar 
   META-INF/maven/com.oracle.weblogic/weblogic-maven-plugin/pom.xml
   
   cp MW_HOME/wlserver_10.3/server/lib/META-INF/maven/com.oracle.weblogic/
   weblogic-maven-plugin/pom.xml MW_HOME/wlserver_10.3/server/lib
   

3. 次のコマンドで、ローカルMavenリポジトリにweblogic-maven-plugin.jarをプロビジョニングします。しかし、プラグインの短縮コマンドライン・ゴールの起動は、この手順を実行する前にステップ5の指示に従います。

   mvn install:install-file 
   -Dfile=MW_HOME/wlserver_10.3/server/lib/weblogic-maven-plugin.jar -DpomFile=pom.xml
   

   通常コマンド出力は次のとおりです。

   [INFO] Scanning for projects...
   [INFO] Searching repository for plugin with prefix: 'install'.
   [INFO] com.oracle.weblogic: checking for updates from central
   [INFO] org.apache.maven.plugins: checking for updates from central
   [INFO] org.codehaus.mojo: checking for updates from central
   Downloading:
   http://repo1.maven.org/maven2/org/apache/maven/plugins/
   maven-install-plugin/2.2/maven-install-plugin-2.2.pom
   Downloading:
   ...
   [INFO] ------------------------------------------------------------------------
   [INFO] Building Maven Mojo Archetype
   [INFO]    task-segment: [install:install-file] (aggregator-style)
   [INFO] ------------------------------------------------------------------------
   Downloading:
   ...
   [INFO] [install:install-file {execution: default-cli}]
   [INFO] Installing c:\oracle\Middleware\wlserver_10.3\
   server\lib\weblogic-maven-plugin.jar to 
   C:\DEMO\com\oracle\weblogic\weblogic-maven-plugin\10.3.4\
   weblogic-maven-plugin-10.3.4.jar
   [INFO] Installing C:\pom.xml to C:\DEMO\com\oracle\weblogic\weblogic-maven-plugin\10.3.4\
   weblogic-maven-plugin-10.3.4.pom
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESSFUL
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time: 1 minute 3 seconds
   [INFO] Finished at: Thu Jul 22 12:11:10 PDT 2010
   [INFO] Final Memory: 13M/64M
   [INFO] ------------------------------------------------------------------------
   C:\> 
   

   
   

   注意: mvn installコマンドで、Mavenゴールの実行を正常に行うために必要なMaven依存関係をインターネットからダウンロードするため、ローカル・マシンでmvn installを少なくとも一度実行する必要があります。

   
   

4. 次のいすれかの方法で、Mavenプラグインを使用します。

   • コマンドライン: コマンドラインからゴールを起動します。

     たとえば、ゴールのフル・ネームを使用してデプロイします。

     mvn com.oracle.weblogic:weblogic-maven-plugin:deploy
     

     または、オプションで、短縮されたコマンドライン・ゴールの起動で構成した場合(ステップ5を参照してください) :

     mvn weblogic:deploy
     

   • POMファイル: アプリケーションのpom.xmlファイルに、Mavenプラグインを含めます。

     プロジェクトの任意ライフサイクル・フェーズにプラグインを追加します。オプションで、実行タグをpom.xmlファイルに追加することで、ゴールをデフォルトMavenライフサイクル・フェーズに追加できます。ゴールが、Mavenライフサイクルの特定のフェーズにバインドされます。たとえば、例C-1で示すように、ゴールがMavenライフサイクルの「インストール」フェーズにバインドされます。それにより、mvn installコマンドを実行するたびにデプロイメント・プラグインも呼び出されます。

     例C-1 Mavenプロジェクトpom.xmlファイル

     <build> 
       <plugins> 
        <plugin> 
           <groupId>com.oracle.weblogic</groupId> 
           <artifactId>weblogic-maven-plugin</artifactId> 
           <version>10.3.4</version> 
           <configuration> 
               <adminurl>t3://localhost:7001</adminurl>
               <user>weblogic</user> 
               <password>weblogic123</password> 
               <upload>true</upload> 
               <action>deploy</action> 
               <remote>false</remote> 
               <verbose>true</verbose> 
     <source>${project.build.directory}/${project.build.finalName}.${project.packaging}</source> 
              <name>${project.build.finalName}</name> 
           </configuration> 
           <!-- 
           <executions> 
              <execution> 
                 <phase>install</phase> 
                   <goals> 
                     <goal>deploy</goal> 
                   </goals> 
              </execution> 
            </executions> 
            --> 
       </plugin> 
         . 
         . 
         . 
      </plugins> 
     </build> 
     

5. オプションで、例C-2で示すように、pom.xmlファイルを指定し、プラグインをMavenリポジトリに指定する前に、$HOME/.m2ディレクトリにあるsettings.xmlファイルを変更することによって、プラグインの完全な起動を短縮できます。

   1. settings.xmlファイルを次のように変更します。

      <!-- pluginGroups
       | This is a list of additional group identifiers that will be searched 
       | when resolving plugins by their prefix, for example, when invoking a  
       | command line like "mvn prefix:goal". Maven will automatically add the 
       | group identifiers "org.apache.maven.plugins" and "org.codehaus.mojo"
       | if theses are not already contained in the list.
       | -->
      <pluginGroups>
         <!-- pluginGroup
            | Specifies a further group identifier to use for plugin lookup.
          -->
         <pluginGroup>com.oracle.weblogic</pluginGroup>
       </pluginGroups>
      

   2. MW_HOME/wlserver_10.3/server/lib/pom.xmlファイルを次に置き換えます。

      例C-2 pom.xmlファイル

      <project xmlns="http://maven.apache.org/POM/4.0.0" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
      http://maven.apache.org/maven-v4_0_0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <groupId>com.oracle.weblogic</groupId>
        <artifactId>weblogic-maven-plugin</artifactId>
        <packaging>maven-plugin</packaging>
        <version>10.3.4</version>
        <name>Maven Mojo Archetype</name>
        <url>http://maven.apache.org</url>
        <dependencies>
          <dependency>
            <groupId>org.apache.maven</groupId>
            <artifactId>maven-plugin-api</artifactId>
            <version>2.0</version>
          </dependency>
        </dependencies>
       
        <build>
         <plugins>
            <plugin>
             <artifactId>maven-plugin-plugin</artifactId>
             <version>2.3</version>
             <configuration>
               <goalPrefix>weblogic</goalPrefix>
             </configuration>
            </plugin>
          </plugins>
        </build>
       
      </project>
      

   3. MW_HOME/wlserver_10.3/server/lib/内から、次に示すようにローカルMavenリポジトリにweblogic-maven-plugin.jarを指定します。

      mvn install:install-file 
      -Dfile=MW_HOME/wlserver_10.3/server/lib/weblogic-maven-plugin.jar -DpomFile=pom.xml
      

   4. なお、短縮されたコマンドライン・ゴールの起動を使用できます。たとえば:

      mvn weblogic:deploy
      

デプロイメントの目標

表C-1は、weblogic-maven-pluginデプロイメント・ゴールを示しています。

表C-1 Mavenプラグイン・デプロイメント・ゴール

ショート・ネーム	説明
weblogic:deploy	アプリケーションまたはモジュールをデプロイまたは再デプロイします。
weblogic:undeploy	デプロイメントを停止して、ステージングされているファイルをターゲット・サーバーから削除します。
weblogic:redeploy	実行中のアプリケーションまたは実行中のアプリケーションの一部を再デプロイします。
weblogic:start-app	アプリケーションを開始します。
weblogic:stop-app	アプリケーションを停止します。
weblogic:list-apps	ドメインにデプロイ、配布、またはインストールされているアプリケーションおよびスタンドアロン・モジュールのデプロイメント名をリストします。
weblogic:update-app	プラン・ファイルを再配布して、新しいプランの内容に基づいてアプリケーションを再構成することで、アプリケーションのデプロイメント・プランを更新します。
weblogic:help	すべてのデプロイメント・ゴールをリストします。

weblogic.deploy

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:deploy

ショート・ネーム

weblogic:deploy

説明

アプリケーションまたはモジュールをデプロイします。

属性

• Maven2.0プロジェクトが必要です。

• デプロイの準備完了のアプリケーションが必要です。

パラメータ

表C-2 weblogic:deployパラメータ

オプション	タイプ	デフォルト	説明
name	文字列	none	新規にデプロイされたアプリケーションまたはスタンドアロン・モジュールに指定するデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに割り当てます。
source	文字列	none	必須: デプロイするアーカイブされたファイルまたは展開されたアーカイブ・ディレクトリ。
plan	文字列	none	アプリケーションまたはモジュールをデプロイするときに使用するデプロイメント・プランを指定します。
targets	文字列	none	アプリケーションまたはモジュールを配布およびデプロイするターゲット。この属性の値は、ターゲット・サーバー、クラスタまたは仮想ホストのコンマ区切りのリストです。
upload	ブール	false	デプロイメント前に、管理サーバーのアップロード・ディレクトリをソース・ファイルにコピーします。
stage	ブール	false	デプロイメント・ファイルをターゲット・サーバーのステージング・ディレクトリにコピーします。
nostage	ブール	true	デプロイメント・ファイルをターゲット・サーバーにコピーしませんが、sourceオプションで指定した一定の場所に保持します。
external_stage	ブール	false	デプロイメント・ファイルをターゲット・サーバーにコピーしません。かわりに、デプロイメント・ファイルがターゲット・サーバーのステージング・ディレクトリの正しいサブディレクトリにコピーされたことを確認する必要があります。ファイルを手動でコピーしたり、サード・パーティのツールやスクリプトを使用したりできます。 stage、nostageまたはexternal_stageのいずれかの属性のみを指定できます。何も指定しない場合、管理ターゲット・サーバーに対するデフォルトのデプロイメント・モードはstage、単一のサーバーと管理サーバーに対するデフォルト・モードはnostageです。
retiretimeout	整数	-1	WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。
library	ブール	false	デプロイメントを共有J2EEライブラリまたはオプション・パッケージとして指定します。
libspecver	文字列	none	J2EEライブラリまたはオプション・パッケージの仕様のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに仕様のバージョンが含まれていない場合にのみ使用できます。libversionはlibrary属性と一緒にしか使用できません。
libimplver	文字列	none	J2EEライブラリまたはオプション・パッケージの実装のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに実装のバージョンが含まれていない場合にのみ使用できます。libimplversionはlibrary属性と一緒にしか使用できません。
usenonexclusivelock	ブール	false	同じユーザーがドメインですでに取得している既存のロックを、デプロイメント処理で使用することを指定します。複数のデプロイメント・ツールを同時に使用していて、いずれかのツールでドメイン構成のロックをすでに取得している場合に便利。
altappdd	文字列	none	デプロイメントに使用する代替J2EEデプロイメント記述子(application.xml)の名前。
altwlsappdd	文字列	none	デプロイメントに使用する代替WebLogic Serverデプロイメント記述子(weblogic-application.xml)の名前。
securityModel	文字列	none	このデプロイメントで使用するセキュリティ・モデル。デプロイメント記述子のみ、ロールのカスタマイズ、ロールとポリシーのカスタマイズ、セキュリティ・レルム構成(拡張モデル)などの指定可能なキュリティ・モデルがあります。この属性の実際の有効な値は、DDOnly、CustomRoles、CustomRolesAndPolicyまたはAdvancedです。
enableSecuirtyValidation	ブール	false	セキュリティ・データの検証を有効にします。
id	文字列	none	実行中のデプロイメント・タスクのタスク識別子。すべての実行中のデプロイメント・タスクで、識別子が一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。
submoduletargets	文字列	deploy	JMSサーバーは、JMSアプリケーション・モジュールで定義したリソースのターゲットです。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールを対象にしてSub-Moduleの使用およびJMSサーバーおよびJMSシステム・リソースを管理するためにWLSTの使用を参照してください。

例

例C-3は、weblogic:deployゴールの使用方法を説明します。

例C-3 weblogic:deploy

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:deploy  
-Dadminurl=t3://myhost:7001 -Duser=weblogic
 -Dpassword=mypassword -Dtargets=AdminServer -Dsource=c:\apps\sample.war
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype
[INFO]    task-segment: [com.oracle.weblogic:weblogic-maven-plugin:deploy]
[INFO] ------------------------------------------------------------------------
[INFO] [weblogic:deploy {execution: default-cli}]
weblogic.Deployer invoked with options:  -noexit -adminurl t3://myhost:7001
-user weblogic -deploy -source c:\apps\sample.war -targets AdminServer
<Aug 9, 2010 5:54:22 PM PDT> <Info> <J2EE Deployment SPI> <BEA-260121> 
<Initiating deploy operation for application, 
sample.war [archive: c:\apps\sample.war], to Admin Server .>

Task 0 initiated: [Deployer:149026]deploy application sample.war on AdminServer.
 
Task 0 completed: [Deployer:149026]deploy application sample.war on AdminServer.
 
Target state: deploy completed on Server AdminServer
 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Mon Aug 09 17:54:23 PDT 2010
[INFO] Final Memory: 4M/15M
[INFO] ------------------------------------------------------------------------

使用方法の詳細は、weblogic.Deployerコマンド・ライン・リファレンスを参照してください。

weblogic:undeploy

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:undeploy

ショート・ネーム

weblogic:undeploy

説明

アプリケーションまたはモジュールをアンデプロイします。

属性

• Maven2.0プロジェクトが必要です。

• すでにデプロイされたアプリケーションが必要です。

パラメータ

表C-3 weblogic:undeployのパラメータ

オプション	タイプ	デフォルト	説明
name	文字列	none	必須。デプロイされたアプリケーションまたはモジュールのデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに指定します。
appversion	文字列	none	デプロイされているアプリケーションのバージョン識別子。
planversion	文字列	none	デプロイメント・プランのバージョン識別子。
source	文字列	none	アンデプロイするためのアーカイブされたファイルまたは展開されたアーカイブ・ディレクトリ。
plan	文字列	none	アンデプロイするときに使用するデプロイ・プラン。
targets	文字列	none	アプリケーションまたはモジュールがアンデプロイされるターゲット。この属性の値は、ターゲット・サーバー、クラスタ、またはバーチャル・ホストのコンマ区切りのリストです。
retiretimeout	整数	-1	WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。
graceful	文字列	false	既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。gracefulオプションを指定しない場合、WebLogic Serverはアプリケーションまたはモジュールをただちに停止します。
ignoresessions	文字列	false	現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに管理モードにします。
id	文字列	none	実行中のデプロイメント・タスクのタスク識別子。すべての実行中のデプロイメント・タスクで、識別子が一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。
submoduletargets	文字列	deploy	JMSサーバーは、JMSアプリケーション・モジュールで定義したリソースのターゲットです。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールを対象にしてSub-Moduleの使用およびJMSサーバーおよびJMSシステム・リソースを管理するためにWLSTの使用を参照してください。

例

例C-4は、weblogic:undeployゴールの使用方法を説明します。

例C-4 weblogic:undeploy

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:undeploy  
-Dadminurl=t3://myhost:7001 -Duser=weblogic
 -Dpassword=mypassword -Dtargets=AdminServer -Dname=sample.war
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype
[INFO]    task-segment: [com.oracle.weblogic:weblogic-maven-plugin:undeploy]
[INFO] ------------------------------------------------------------------------
[INFO] [weblogic:undeploy {execution: default-cli}]
weblogic.Deployer invoked with options:  -noexit -adminurl t3://myhost:7001
-user weblogic -undeploy -name sample.war -targets AdminServer
<Aug 9, 2010 10:41:16 PM PDT> <Info> <J2EE Deployment SPI> <BEA-260121> <Initiat
ing undeploy operation for application, sample.war [archive: null], 
to AdminServer .>

Task 3 initiated: [Deployer:149026]remove application sample.war on AdminServer.
 
Task 3 completed: [Deployer:149026]remove application sample.war on AdminServer.
 
Target state: undeploy completed on Server AdminServer
 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Mon Aug 09 22:41:16 PDT 2010
[INFO] Final Memory: 4M/15M
[INFO] ------------------------------------------------------------------------

使用方法の詳細は、weblogic.Deployerコマンド・ライン・リファレンスを参照してください。

weblogic:redeploy

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:redeploy

ショート・ネーム

weblogic:redeploy

説明

アプリケーションまたはモジュールをデプロイします。

属性

• Maven2.0プロジェクトが必要です。

• デプロイの準備完了のアプリケーションが必要です。

パラメータ

表C-4 weblogic:redeployのパラメータ

オプション	タイプ	デフォルト	説明
name	文字列	none	必須。デプロイされたアプリケーションまたはモジュールのデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに指定します。 name属性を指定しない場合、ソースを指定する必要があります。
source	文字列	none	再デプロイするための、アーカイブ・ファイルまたは展開されたアーカーブ・ディレクトリ。
plan	文字列	none	再デプロイで使用するデプロイメント・プラン。
targets	文字列	none	アプリケーションまたはモジュールを再デプロイするターゲット。この属性の値は、ターゲット・サーバー、クラスタ、またはバーチャル・ホストのコンマ区切りのリストです。
upload	文字列	false	再デプロイメント前に、管理サーバーのアップロード・ディレクトリをソース・ファイルにコピーします。
delete_files	文字列	false	サーバーのステージング・ディレクトリから静的ファイルを削除します。この属性は、アーカイブされていないデプロイメント、およびstageモードを使用してデプロイされたアプリケーションでのみ有効です。この属性を使用するときには、次の例のようにターゲット・サーバーを指定する必要があります。
retiretimeout	整数	-1	WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。
filelist	文字列	none	再デプロイする1つ以上のファイル。
id	文字列	none	実行中のデプロイメント・タスクのタスク識別子。すべての実行中のデプロイメント・タスクで、識別子が一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。
submoduletargets	文字列	deploy	JMSサーバーは、JMSアプリケーション・モジュールで定義したリソースのターゲットです。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールを対象にしてSub-Moduleの使用およびJMSサーバーおよびJMSシステム・リソースを管理するためにWLSTの使用を参照してください。

例

例C-5は、weblogic:redeployゴールの使用方法を説明します。

例C-5 weblogic:redeploy

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:redeploy  
-Dadminurl=t3://myhost:7001 -Duser=weblogic
 -Dpassword=mypassword -Dtargets=AdminServer -Dname=sample.war
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype
[INFO]    task-segment: [com.oracle.weblogic:weblogic-maven-plugin:redeploy]
[INFO] ------------------------------------------------------------------------
[INFO] [weblogic:redeploy {execution: default-cli}]
weblogic.Deployer invoked with options:  -noexit -adminurl t3://myhost:7001
-user weblogic -redeploy -name sample.war
<Sep 9, 2010 10:12:27 PM PDT> <Info> <J2EE Deployment SPI> <BEA-260121> <Initiat
ing redeploy operation for application, sample.war [archive: null], to to configurd targets.>

Task 1 initiated: [Deployer:149026]redeploy application sample.war on AdminServer.
 
Task 1 completed: [Deployer:149026]redeploy application sample.war on AdminServer.
 
Target state: redeploy completed on ServervE AdminServer
 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Thu Sep 09 22:12:27 PDT 2010
[INFO] Final Memory: 4M/15M
[INFO] ------------------------------------------------------------------------

使用方法の詳細は、weblogic.Deployerコマンド・ライン・リファレンスを参照してください。

weblogic:start-app

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:start-app

ショート・ネーム

weblogic:start-app

説明

アプリケーションを開始します。

属性

• Maven2.0プロジェクトが必要です。

• すでにデプロイされたアプリケーションが必要です。

パラメータ

表C-5 weblogic:start-appパラメータ

オプション	タイプ	デフォルト	説明
adminmode	ブール	false	アプリケーションは、本番モードではなく(デフォルト・モードです)管理モードで開始します。管理モードでは、管理チャンネルを構成するアプリケーションへのアクセスを規制します。
name	文字列	none	必須: デプロイされたアプリケーションまたは開始モジュールのデプロイメント名。
appversion	文字列	none	起動するアプリケーションのバージョン。
planversion	文字列	none	アプリケーションの起動時に使用するデプロイメント・プランのバージョン。
targets	文字列	none	アプリケーションまたはモジュールを開始するターゲット。この属性の値は、ターゲット・サーバー、クラスタ、または仮想ホストのコンマ区切りのリストです。
retiretimeout	整数	-1	WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。
id	文字列	none	実行中のデプロイメント・タスクのタスク識別子。すべての実行中のデプロイメント・タスクで、識別子が一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。
submoduletargets	文字列	deploy	JMSサーバーは、JMSアプリケーション・モジュールで定義したリソースのターゲットです。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールを対象にしてSub-Moduleの使用およびJMSサーバーおよびJMSシステム・リソースを管理するためにWLSTの使用を参照してください。

例

例C-6は、weblogic:start-appゴールの使用方法を説明します。

例C-6 weblogic:start-app

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:start-app  
-Dadminurl=t3://myhost:7001 -Duser=weblogic
 -Dpassword=mypassword -Dtargets=AdminServer -Dname=sample.war
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype
[INFO]    task-segment: [com.oracle.weblogic:weblogic-maven-plugin:start-app]
[INFO] ------------------------------------------------------------------------
[INFO] [weblogic:start-app {execution: default-cli}]
weblogic.Deployer invoked with options:  -noexit -adminurl t3://myhost:7001
-user weblogic -start -name sample.war -targets AdminServer
<Aug 9, 2010 10:54:51 PM PDT> <Info> <J2EE Deployment SPI> <BEA-260121> <Initiat
ing start operation for application, sample.war [archive: null], to AdminServer
.>

Task 6 initiated: [Deployer:149026]start application sample.war on AdminServer.
Task 6 completed: [Deployer:149026]start application sample.war on AdminServer.
Target state: start completed on Server AdminServer
 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Mon Aug 09 22:54:52 PDT 2010
[INFO] Final Memory: 4M/15M
[INFO] ------------------------------------------------------------------------

使用方法の詳細は、weblogic.Deployerコマンド・ライン・リファレンスを参照してください。

weblogic:stop-app

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:stop-app

ショート・ネーム

weblogic:stop-app

説明

アプリケーションを停止します。

属性

• Maven2.0プロジェクトが必要です。

• すでにデプロイされたアプリケーションが必要です。

パラメータ

表C-6 weblogic:stop-appパラメータ

オプション	タイプ	デフォルト	説明
adminmode	ブール	false	実行中のアプリケーションを管理モードに切り替えて、構成済みの管理チャネル経由で管理リクエストのみを受け付けることを指定します。このオプションを指定しない場合、実行中のアプリケーションは停止されて、再起動するまで管理リクエストもクライアント・リクエストも受け付けなくなります。
name	文字列	none	必須: デプロイされたアプリケーションまたは停止モジュールのデプロイメント名。
appversion	文字列	none	デプロイされているアプリケーションのバージョン識別子。
planversion	文字列	none	デプロイメント・プランのバージョン識別子。
targets	文字列	none	アプリケーションまたはモジュールを停止するターゲット。この属性の値は、ターゲット・サーバー、クラスタ、またはバーチャル・ホストのコンマ区切りのリストです。
graceful	ブール	false	既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。gracefulオプションを指定しない場合、WebLogic Serverはアプリケーションまたはモジュールをただちに停止します。
ignoresessions	ブール	false	現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに管理モードにします。
rmiGraceperiod	整数	-1	正常停止または廃止の際にRMIの猶予期間内でRMIリクエストの受信がなくなるまで、ワーク・マネージャがRMI呼出しを受け付けてスケジューリングする時間(秒単位)。
retiretimeout	整数	-1	WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。
id	文字列	none	実行中のデプロイメント・タスクのタスク識別子。すべての実行中のデプロイメント・タスクで、識別子が一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。
submoduletargets	文字列	deploy	JMSサーバーは、JMSアプリケーション・モジュールで定義したリソースのターゲットです。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールを対象にしてSub-Moduleの使用およびJMSサーバーおよびJMSシステム・リソースを管理するためにWLSTの使用を参照してください。

例

例C-7は、weblogic:stop-appゴールの使用方法を説明します。

例C-7 weblogic:stop-app

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:stop-app  
-Dadminurl=t3://myhost:7001 -Duser=weblogic
 -Dpassword=mypassword -Dtargets=AdminServer -Dname=sample.war
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype
[INFO]    task-segment: [com.oracle.weblogic:weblogic-maven-plugin:stop-app]
[INFO] ------------------------------------------------------------------------
[INFO] [weblogic:stop-app {execution: default-cli}]
weblogic.Deployer invoked with options:  -noexit -adminurl t3://myhost:7001
-user weblogic -stop -name sample.war -targets AdminServer
<Aug 9, 2010 10:53:39 PM PDT> <Info> <J2EE Deployment SPI> <BEA-260121> <Initiat
ing stop operation for application, sample.war [archive: null], to AdminServer .
>

Task 5 initiated: [Deployer:149026]stop application sample.war on AdminServer.
Task 5 completed: [Deployer:149026]stop application sample.war on AdminServer.
Target state: stop completed on Server AdminServer
 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Mon Aug 09 22:53:39 PDT 2010
[INFO] Final Memory: 4M/15M
[INFO] ------------------------------------------------------------------------

使用方法の詳細は、weblogic.Deployerコマンド・ライン・リファレンスを参照してください。

weblogic:list-apps

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:list-apps

ショート・ネーム

weblogic:list-apps

説明

ドメインにデプロイ、配布、またはインストールされているアプリケーションおよびスタンドアロン・モジュールのデプロイメント名をリストします。

属性

Maven2.0プロジェクトが必要です。

パラメータ

このゴールでは、パラメータの要求や、オプションでパラメータの採用などはありません。

例

例C-8は、weblogic:list-appsゴールの使用方法を説明します。

例C-8 weblogic:list-apps

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:list-apps  
-Dadminurl=t3://myhost:7001 -Duser=weblogic
 -Dpassword=mypassword -Dtargets=AdminServer
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype
[INFO]    task-segment: [com.oracle.weblogic:weblogic-maven-plugin:list-apps]
[INFO] ------------------------------------------------------------------------
[INFO] [weblogic:list-apps {execution: default-cli}]
weblogic.Deployer invoked with options:  -noexit -adminurl t3://myhost:7001
-user weblogic -listapps
 sample.war
Number of Applications Found : 1
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Mon Aug 09 22:52:07 PDT 2010
[INFO] Final Memory: 4M/15M
[INFO] ------------------------------------------------------------------------

使用方法の詳細は、weblogic.Deployerコマンド・ライン・リファレンスを参照してください。

weblogic:update-app

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:update-app

ショート・ネーム

weblogic:update-app

説明

プラン・ファイルを再配布して、新しいプランの内容に基づいてアプリケーションを再構成することで、アプリケーションのデプロイメント・プランを更新します。

属性

• Maven2.0プロジェクトが必要です。

• すでにアプリケーションをデプロイされている場合があります。

パラメータ

表C-7 weblogic:update-appパラメータ

オプション	タイプ	デフォルト	説明
name	文字列	none	必須。デプロイされたアプリケーションまたはモジュールのデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに指定します。
plan	文字列	none	必須のパラメータです。アプリケーションの構成の更新に使用するデプロイメント・プラン。指定されたデプロイメント・プランはアプリケーションのターゲット・サーバーで有効でなければなりません。たとえば、リソースが関連する記述子で以前に定義されていないかぎり、プランでは必要なリソースにnullの変数を指定できません。 更新処理では、デプロイメント・プランで変更されている(nullではない)値に対応する記述子のみを更新します。更新処理に使用されるプランにnull変数が含まれている場合、対応する記述子の現在の値は更新されません。
planversion	文字列	none	デプロイメント・プランのバージョン識別子。
targets	文字列	none	アプリケーションまたはモジュールをアップデートするターゲット。この属性の値は、ターゲット・サーバー、クラスタ、またはバーチャル・ホストのコンマ区切りのリストです。
upload	ブール	false	アプリケーションの更新前に、新規デプロイメント・プランを管理サーバーに転送します。
appversion	文字列	none	デプロイされているアプリケーションのバージョン識別子。
id	文字列	none	実行中のデプロイメント・タスクのタスク識別子。すべての実行中のデプロイメント・タスクで、識別子が一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。
submoduletargets	文字列	deploy	JMSサーバーは、JMSアプリケーション・モジュールで定義したリソースのターゲットです。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールを対象にしてSub-Moduleの使用およびJMSサーバーおよびJMSシステム・リソースを管理するためにWLSTの使用を参照してください。

例

例C-9は、weblogic:update-appゴールの使用方法を説明します。

例C-9 weblogic:update-app

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:update-app  
-Dadminurl=t3://myhost:7001 -Duser=weblogic
 -Dpassword=mypassword -Dname=sample.war -Dremote=true
-Dupload=true -Dplan=c:\apps\sampleWar.plan

[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype 10.3.4
[INFO] ------------------------------------------------------------------------
[INFO] --- weblogic-maven-plugin:10.3.4:update-app (default-cli) 
@ weblogic-maven-plugin ---

weblogic.Deployer invoked with options:  -noexit -adminurl t3://myhost:7001
-user weblogic -update -plan c:\apps\sampleWar.plan sample.war -name sample.war -upload -remote
<Oct 18, 2010 10:30:47 AM PDT> <Info> <J2EE Deployment SPI> <BEA-260121> <Initia
ting update operation for application, sample.war [archive: null], to configured
targets.>

Task 8 initiated: [Deployer:149026]update application sample.war on AdminServer.
Task 8 completed: [Deployer:149026]update application sample.war on AdminServer.
Target state: update completed on Server AdminServer
 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 6.188s
[INFO] Finished at: Mon Oct 18 10:30:49 PDT 2010
[INFO] Final Memory: 3M/15M
[INFO] ------------------------------------------------------------------------

使用方法の詳細は、weblogic.Deployerコマンド・ライン・リファレンスを参照してください。

weblogic:help

フル・ネーム

com.oracle.weblogic:weblogic-maven-plugin:help

ショート・ネーム

weblogic:help

説明

サポートするすべてのデプロイメント・ゴールのリストを表示します。

属性

• Maven2.0プロジェクトが必要です。

例

例C-10は、weblogic:helpゴールの使用方法を説明します。

例C-10 weblogic:help

C:\>mvn  com.oracle.weblogic:weblogic-maven-plugin:help  
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Mojo Archetype 10.3.4
[INFO] ------------------------------------------------------------------------
[INFO] --- weblogic-maven-plugin:10.3.4:help (default-cli) @ weblogic-maven-plugin ---

The following are the goals available currently in Maven
deploy
list-apps
redeploy
start-app
stop-app
undeploy
update-app
 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.344s
[INFO] Finished at: Fri Oct 15 11:01:28 PDT 2010
[INFO] Final Memory: 2M/15M
[INFO] ------------------------------------------------------------------------

トラブルシューティング

表C-8に、共通のMavenプラグイン・エラーとそれを解決する方法を示します。

表C-8 Mavenプラグイン・エラー

構成ステップ	エラー・メッセージ	解決
ステップ1: プラグインを作成します。 java –jar wljarbuilder.jar –profile weblogic-maven-plugin	wljarbuilder.jarファイルにアクセスできません	MW_HOME/wlserver_10.3/server/lib/ディレクトリ内からコマンドを発行したかどうか確認してください。
ステップ2: weblogic-maven-pluginから、pom.xmlファイルを抽出します。		pom.xmlファイルは、MW_HOME/wlserver_10.3/server/lib/META-INF/maven/com.oracle.weblogic/weblogic-maven-plugin/pom.xmlに作成されます。この場所から、pom.xmlファイルをMW_HOME/wlserver_10.3/server/lib/にコピーします。(WebLogic Mavenプラグインの構成と使用方法のステップ2を参照してください)。
ステップ3: Mavenリポジトリに、weblogic-maven-plugin.jarを提供します。 成功した場合、ビルドに成功したメッセージが表示されます。	ビルド・エラー	考えられる問題: weblogic-maven-plugin.jarを作成していません。(WebLogic Mavenプラグインの構成と使用方法のステップ1を参照してください)。 pom.xmlをMW_HOME/wlserver_10.3/server/libに抽出していません。(WebLogic Mavenプラグインの構成と使用方法のステップ2を参照してください)。 Mavenを正しくインストールしていないか、またはリポジトリを提供していません。(http://maven.apache.org/guides/development/guide-building-m2.html参照してください)。
ステップ4: Mavenゴールを実行します。 成功した場合、ビルドに成功したメッセージが表示されます。	アーティファクトの解決に失敗しました	考えられる問題: mvn weblogic:goalを呼び出す前に、少なくとも1回は、mvn installコマンドを実行する必要があります。これは、インターネットから読み出す必要がないMaven依存関係があるため必要となります。(WebLogic Mavenプラグインの構成および使用方法)のステップ3の「ノート」参照してください)。 mvn installコマンドをMW_HOME/wlserver_10.3/server/lib/以外の場所から実行しました。 MW_HOME/wlserver_10.3/server/lib/にpom.xmlファイルはありません。