Oracle® Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ 11g リリース1(10.3.5) B60988-03 |
|
![]() 前 |
Apache Mavenは、Javaベース・プロジェクトの構築および管理を行うためのソフトウェア・ツールです。WebLogic Server用のApache 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-plugin
を作成、インストール、および使用するには、次の手順を実行します。
注意: これらの手順を正常に終了するには、コンピュータをインターネットに接続して、settings.xml ファイル(通常は$HOME /.m2/settings.xml )では必要なプロキシ設定を正しく構成する必要があります。詳細は、http://maven.apache.org/guides/mini/guide-proxies.html を参照してください。 |
次のコマンドで、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リポジトリに、特定の場所をマークします。
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
次のコマンドで、ローカル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 を少なくとも一度実行する必要があります。 |
次のいすれかの方法で、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>
オプションで、例C-2で示すように、pom.xml
ファイルを指定し、プラグインをMavenリポジトリに指定する前に、$HOME
/.m2
ディレクトリにあるsettings.xml
ファイルを変更することによって、プラグインの完全な起動を短縮できます。
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>
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>
MW_HOME
/wlserver_10.3/server/lib/
からmvn install
コマンドを実行します。
mvn install
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
なお、短縮されたコマンドライン・ゴールの起動を使用できます。たとえば:
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 |
すべてのデプロイメント・ゴールをリストします。 |
フル・ネーム
com.oracle.weblogic:weblogic-maven-plugin:deploy
ショート・ネーム
weblogic:deploy
説明
アプリケーションまたはモジュールをデプロイします。
属性
Maven2.0プロジェクトが必要です。
デプロイメントの準備完了のアプリケーションが必要です。
パラメータ
表C-2 weblogic:deployパラメータ
オプション | タイプ | デフォルト | 説明 |
---|---|---|---|
|
文字列 |
|
新規にデプロイされたアプリケーションまたはスタンドアロン・モジュールに指定するデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに割り当てます。 |
|
文字列 |
|
必須。デプロイするアーカイブ・ファイルまたは展開されたアーカイブ・ディレクトリ。 |
|
文字列 |
|
アプリケーションまたはモジュールをデプロイするときに使用するデプロイメント・プラン。 |
|
文字列 |
|
アプリケーションまたはモジュールを配布およびデプロイするターゲット。この属性の値は、ターゲット・サーバー、クラスタまたは仮想ホストのコンマ区切りのリストです。 |
|
ブール |
|
デプロイメント前に、管理サーバーのアップロード・ディレクトリをソース・ファイルにコピーします。 |
|
ブール |
|
デプロイメント・ファイルをターゲット・サーバーのステージング・ディレクトリにコピーします。 |
|
ブール |
|
デプロイメント・ファイルをターゲット・サーバーにコピーしませんが、 |
|
ブール |
|
デプロイメント・ファイルをターゲット・サーバーにコピーしません; かわりに、デプロイメント・ファイルがターゲット・サーバーのステージング・ディレクトリの正しいサブディレクトリにコピーされたことを確認する必要があります。ファイルを手動でコピーしたり、サード・パーティのツールやスクリプトを使用したりできます。
|
|
整数 |
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。 |
|
ブール |
|
デプロイメントを共有J2EEライブラリまたはオプション・パッケージとして指定します。 |
|
文字列 |
|
J2EEライブラリまたはオプション・パッケージの仕様のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに仕様のバージョンが含まれていない場合にのみ使用できます。 |
|
文字列 |
|
J2EEライブラリまたはオプション・パッケージの実装のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに実装のバージョンが含まれていない場合にのみ使用できます。 |
|
ブール |
|
同じユーザーがドメインですでに取得している既存のロックを、デプロイメント処理で使用することを指定します。複数のデプロイメント・ツールを同時に使用していて、いずれかのツールでドメイン構成のロックをすでに取得している場合に便利。 |
|
文字列 |
|
デプロイメントに使用する代替J2EEデプロイメント記述子( |
|
文字列 |
|
デプロイメントに使用する代替WebLogic Serverデプロイメント記述子( |
|
文字列 |
|
このデプロイメントで使用するセキュリティ・モデル。デプロイメント記述子のみ、ロールのカスタマイズ、ロールとポリシーのカスタマイズ、セキュリティ・レルム構成(拡張モデル)などの指定可能なキュリティ・モデルがあります。この属性の実際の有効な値は、 |
|
ブール |
|
セキュリティ・データの検証を有効にします。 |
|
文字列 |
|
実行中のデプロイメント・タスクのタスク識別子。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。 |
|
文字列 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
例
例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コマンド・ライン・リファレンスを参照してください。
フル・ネーム
com.oracle.weblogic:weblogic-maven-plugin:undeploy
ショート・ネーム
weblogic:undeploy
説明
アプリケーションまたはモジュールをアンデプロイします。
属性
Maven2.0プロジェクトが必要です。
すでにデプロイされたアプリケーションが必要です。
パラメータ
表C-3 weblogic:undeployのパラメータ
オプション | タイプ | デフォルト | 説明 |
---|---|---|---|
|
文字列 |
|
必須。デプロイされたアプリケーションまたはモジュールのデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに指定します。 |
|
文字列 |
|
デプロイされているアプリケーションのバージョン識別子。 |
|
文字列 |
|
デプロイメント・プランのバージョン識別子。 |
|
文字列 |
|
アンデプロイするときに使用するデプロイメント・プラン。 |
|
文字列 |
|
アプリケーションまたはモジュールがアンデプロイされるターゲット。この属性の値は、ターゲット・サーバー、クラスタ、または仮想ホストのコンマ区切りのリストです。 |
|
整数 |
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。 |
|
文字列 |
|
既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。 |
|
文字列 |
|
現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに管理モードにします。 |
|
文字列 |
|
実行中のデプロイメント・タスクのタスク識別子。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。 |
|
文字列 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
例
例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コマンド・ライン・リファレンスを参照してください。
フル・ネーム
com.oracle.weblogic:weblogic-maven-plugin:redeploy
ショート・ネーム
weblogic:redeploy
説明
アプリケーションまたはモジュールをデプロイします。
属性
Maven2.0プロジェクトが必要です。
デプロイメントの準備完了のアプリケーションが必要です。
パラメータ
表C-4 weblogic:redeployのパラメータ
オプション | タイプ | デフォルト | 説明 |
---|---|---|---|
|
文字列 |
|
必須。デプロイされたアプリケーションまたはモジュールのデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに指定します。
|
|
文字列 |
|
再デプロイするための、アーカイブ・ファイルまたは展開されたアーカーブ・ディレクトリ。 |
|
文字列 |
|
再デプロイで使用するデプロイメント・プラン。 |
|
文字列 |
|
アプリケーションまたはモジュールを再デプロイするターゲット。この属性の値は、ターゲット・サーバー、クラスタ、または仮想ホストのコンマ区切りのリストです。 |
|
文字列 |
|
再デプロイメント前に、管理サーバーのアップロード・ディレクトリをソース・ファイルにコピーします。 |
|
文字列 |
|
サーバーのステージング・ディレクトリから静的ファイルを削除します。この属性は、アーカイブされていないデプロイメント、および |
|
整数 |
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。 |
|
文字列 |
|
再デプロイする1つ以上のファイル。 |
|
文字列 |
|
実行中のデプロイメント・タスクのタスク識別子。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。 |
|
文字列 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
例
例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コマンド・ライン・リファレンスを参照してください。
フル・ネーム
com.oracle.weblogic:weblogic-maven-plugin:start-app
ショート・ネーム
weblogic:start-app
説明
アプリケーションを開始します。
属性
Maven2.0プロジェクトが必要です。
すでにデプロイされたアプリケーションが必要です。
パラメータ
表C-5 weblogic:start-appパラメータ
オプション | タイプ | デフォルト | 説明 |
---|---|---|---|
|
ブール |
|
アプリケーションを本番モード(デフォルト)ではなく管理モードで起動します。管理モードでは、管理チャンネルを構成するアプリケーションへのアクセスを規制します。 |
|
文字列 |
|
必須。起動するデプロイ済アプリケーションまたはモジュールのデプロイメント名。 |
|
文字列 |
|
起動するアプリケーションのバージョン。 |
|
文字列 |
|
アプリケーションの起動時に使用するデプロイメント・プランのバージョン。 |
|
文字列 |
|
アプリケーションまたはモジュールを開始するターゲット。この属性の値は、ターゲット・サーバー、クラスタ、または仮想ホストのコンマ区切りのリストです。 |
|
整数 |
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。 |
|
文字列 |
|
実行中のデプロイメント・タスクのタスク識別子。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。 |
|
文字列 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
例
例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コマンド・ライン・リファレンスを参照してください。
フル・ネーム
com.oracle.weblogic:weblogic-maven-plugin:stop-app
ショート・ネーム
weblogic:stop-app
説明
アプリケーションを停止します。
属性
Maven2.0プロジェクトが必要です。
すでにデプロイされたアプリケーションが必要です。
パラメータ
表C-6 weblogic:stop-appパラメータ
オプション | タイプ | デフォルト | 説明 |
---|---|---|---|
|
ブール |
|
実行中のアプリケーションを管理モードに切り替えて、構成済みの管理チャネル経由で管理リクエストのみを受け付けることを指定します。このオプションを指定しない場合、実行中のアプリケーションは停止されて、再起動するまで管理リクエストもクライアント・リクエストも受け付けなくなります。 |
|
文字列 |
|
必須。停止するデプロイ済アプリケーションまたはモジュールのデプロイメント名。 |
|
文字列 |
|
デプロイされているアプリケーションのバージョン識別子。 |
|
文字列 |
|
デプロイメント・プランのバージョン識別子。 |
|
文字列 |
|
アプリケーションまたはモジュールを停止するターゲット。この属性の値は、ターゲット・サーバー、クラスタ、または仮想ホストのコンマ区切りのリストです。 |
|
ブール |
|
既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。 |
|
ブール |
|
現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに管理モードにします。 |
|
整数 |
|
|
|
整数 |
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをアンデプロイし、クライアントが新しいバージョンで開始できるようになるまでの秒数を指定します。 |
|
文字列 |
|
実行中のデプロイメント・タスクのタスク識別子。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。 |
|
文字列 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
例
例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コマンド・ライン・リファレンスを参照してください。
フル・ネーム
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コマンド・ライン・リファレンスを参照してください。
フル・ネーム
com.oracle.weblogic:weblogic-maven-plugin:update-app
ショート・ネーム
weblogic:update-app
説明
プラン・ファイルを再配布して、新しいプランの内容に基づいてアプリケーションを再構成することで、アプリケーションのデプロイメント・プランを更新します。
属性
Maven2.0プロジェクトが必要です。
すでにアプリケーションをデプロイされている場合があります。
パラメータ
表C-7 weblogic:update-appパラメータ
オプション | タイプ | デフォルト | 説明 |
---|---|---|---|
|
文字列 |
|
必須。デプロイされたアプリケーションまたはモジュールのデプロイメント名。この属性を指定しない場合、WebLogic Serverは、アーカイブ・ファイルまたは展開されたディレクトリに基づいて、デプロイメント名をアプリケーションに指定します。 |
|
文字列 |
|
必須。アプリケーションの構成の更新に使用するデプロイメント・プラン。指定されたデプロイメント・プランはアプリケーションのターゲット・サーバーで有効でなければなりません。たとえば、リソースが関連する記述子で以前に定義されていないかぎり、プランでは必要なリソースにnullの変数を指定できません。 更新処理では、デプロイメント・プランで変更されている(nullではない)値に対応する記述子のみを更新します。更新処理に使用されるプランにnull変数が含まれている場合、対応する記述子の現在の値は更新されません。 |
|
文字列 |
|
デプロイメント・プランのバージョン識別子。 |
|
文字列 |
|
アプリケーションまたはモジュールをアップデートするターゲット。この属性の値は、ターゲット・サーバー、クラスタ、または仮想ホストのコンマ区切りのリストです。 |
|
ブール |
|
アプリケーションの更新前に、新規デプロイメント・プランを管理サーバーに転送します。 |
|
文字列 |
|
デプロイされているアプリケーションのバージョン識別子。 |
|
文字列 |
|
実行中のデプロイメント・タスクのタスク識別子。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。識別子を指定しない場合、システムは自動的に一意な識別子を作成します。 |
|
文字列 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。この属性の値は、JMSサーバー名のカンマ区切りリストです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
例
例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コマンド・ライン・リファレンスを参照してください。
フル・ネーム
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 |
|
|
ステップ2: |
|
|
ステップ3: Mavenリポジトリに、 成功した場合、 |
|
考えられる問題:
|
ステップ4: Mavenゴールを実行します。 成功した場合、 |
|
考えられる問題:
|