以下の節では、開発ビルド スクリプトに含めることができる WebLogic Ant タスクを使用して、WebLogic Server インスタンスの起動と停止、および WebLogic Server ドメインのコンフィグレーションを行う方法について説明します。
WebLogic Server には、開発環境で一般的なコンフィグレーション タスクを実行するのに役立つ Ant タスクが 2 つあります。コンフィグレーション タスクでは、WebLogic Server インスタンスの起動と停止、WebLogic Server ドメインの作成とコンフィグレーションを行うことができます。
他の WebLogic Ant タスクと組み合わせると、カスタム ドメインでアプリケーションの実証やテストを行うための強力なビルド スクリプトを作成できます。たとえば、単一の Ant ビルド スクリプトでは、以下のことを実行できます。
wlcompile
、wlappc
、および Web サービス Ant タスクを使用して、アプリケーションをコンパイルする。
wlserver
Ant タスクを使用して、新しい単一サーバ ドメインを作成し、管理サーバを起動する。
wlconfig
Ant タスクを使用して、必要なアプリケーション リソースを備えた新しいドメインをコンフィグレーションする。
wldeploy
Ant タスクを使用して、アプリケーションをデプロイする。
コンパイル済みのクライアント アプリケーションを自動的に起動して、製品の機能を実証またはテストする。
以下の節では、コンフィグレーション用 Ant タスクの wlserver
および wlconfig
の使い方について説明します。
wlserver
Ant タスクを使用すると、WebLogic Server インスタンスを起動、再起動、および停止したり、WebLogic Server インスタンスへ接続したりできます。サーバ インスタンスは、コンフィグレーション済みの WebLogic Server ドメインにすでに存在している場合もあります。または、generateconfig=true
属性を使用して、開発用の新しい単一サーバ ドメインを作成することができます。
Ant スクリプトで wlserver
タスクを使用する場合、指定したサーバが使用可能になり接続をリスンするまで、タスクは制御を返しません。wlserver を使用してサーバ インスタンスを起動すると、サーバ プロセスは Ant VM の終了後に自動的に終了します。wlserver
タスクを使用して、現在動作中のサーバにのみ接続する場合、サーバ プロセスは Ant の完了後も実行し続けます。
wlserver
WebLogic Server Ant タスクは、標準 java
Ant タスク (org.apache.tools.ant.taskdefs.Java
) を拡張します。つまり、java
Ant タスクのすべての属性も wlserver
Ant タスクに適用されます。たとえば、output
属性と error
属性を使用すると、wlserver
Ant タスクの出力が書き込まれるファイルと標準エラーが書き込まれるファイルの名前を指定できます。標準 java Antタスクの属性の完全なリストについては、Apache Ant サイトの Java を参照 (http://ant.apache.org/manual/CoreTasks/java.html
)。
wlserver Ant タスクを使用するには、次の手順に従います。
環境を設定します。
Windows NT では、WL_HOME
\server\bin
ディレクトリにある setWLSEnv.cmd
コマンドを実行します。WL_HOME
は、インストールされている WebLogic Server の最上位ディレクトリです。
Unix では、WL_HOME
/server/bin
ディレクトリにある setWLSEnv.sh
コマンドを実行します。WL_HOME
は、インストールされている WebLogic Server の最上位ディレクトリです。
注意 : wlserver タスクは、WebLogic Server に付属しているバージョンの Ant であらかじめ定義されています。独自にインストールした Ant でこのタスクを使用する場合は、ビルド ファイルに次のタスク定義を追加します。
prompt> java weblogic.DDConverter [options] archive_file_or_directory |
サーバの起動、停止、再起動、または接続を行うためのビルド スクリプトに、wlserver
タスクの呼び出しを追加します。wlserver
の属性とデフォルトの動作については、「wlserver Ant タスク リファレンス」を参照してください。
ステージング ディレクトリで ant
と入力し、必要であればこのコマンドにターゲットの引数を渡して、build.xml
ファイルで指定された Ant タスク (1 つまたは複数) を実行します。
prompt> java weblogic.DDConverter [options] archive_file_or_directory
wlserver
タスクからより詳細なメッセージを取得するには、ant -verbose
を使用します。
以下に、すべてのデフォルト値を使用してカレント ディレクトリ内のサーバを起動する、最小限の wlserver
ターゲットを示します。
<target name="wlserver-default"> <wlserver/> </target>
次のターゲットは、指定された接続パラメータ、およびユーザ名とパスワードの組み合わせを使用して、既存の動作中サーバに接続します。
<target name="connect-server"> <wlserver host="127.0.0.1" port="7001" username="weblogic" password="weblogic" action="connect"/> </target>
次のターゲットは、config
サブディレクトリにコンフィグレーションされた WebLogic Server インスタンスを起動します。
<target name="start-server"> <wlserver dir="./config" host="127.0.0.1" port="7001" action="start"/> </target>
次のターゲットは、空のディレクトリに新しい単一サーバ ドメインを作成し、ドメインのサーバ インスタンスを起動します。
<target name="new-server"> <delete dir="./tmp"/> <mkdir dir="./tmp"/> <wlserver dir="./tmp" host="127.0.0.1" port="7001" generateConfig="true" username="weblogic" password="weblogic" action="start"/> </target>
次の表では、wlserver
Ant タスクの属性について説明します。
表 2-1 Wlserver ant タスクの属性
属性 | 説明 | データ型 | 必須/省略可能 |
---|---|---|---|
policy |
WebLogic Server ドメインのセキュリティ ポリシー ファイルのパス。この属性は、サーバ インスタンスを起動する場合にのみ使用する。 |
ファイル |
省略可能 |
dir |
ドメイン コンフィグレーションを保持するパス ( |
ファイル |
省略可能 |
beahome |
Middleware ホーム ディレクトリのパス ( |
ファイル |
省略可能 |
weblogichome |
WebLogic Server のインストール ディレクトリのパス ( |
ファイル |
省略可能 |
servername |
起動、終了、再起動、または接続するサーバの名前。 WebLogic Server インスタンスは、そのプロトコル、ホスト、ポートの値によってユニークに識別されるので、一連の属性を使用して起動、終了、再起動するサーバを指定する場合、 この属性のデフォルト値は |
String |
管理サーバを終了する場合にのみ必須 |
domainname |
サーバがコンフィグレーションされる WebLogic Server ドメインの名前。 |
String |
省略可能 |
adminserverurl |
ドメインの管理サーバにアクセスするための URL。この属性は、ドメインの管理対象サーバを起動する場合に必須。 |
String |
管理対象サーバを起動する場合は必須 |
username |
管理者アカウントのユーザ名。 |
String |
省略可能 |
password |
管理者アカウントのパスワード。 |
String |
省略可能 |
pkpassword |
SSL プライベート キー ファイルを復号化するためのプライベート キー パスワード。 |
String |
省略可能 |
timeout |
この属性のデフォルト値は |
long |
省略可能 |
timeoutSeconds |
この属性のデフォルト値は |
long |
省略可能 |
productionmodeenabled |
サーバ インスタンスを開発モードとプロダクション モードのどちらで起動するかを指定する。 開発モードでは、WebLogic Server インスタンスは この属性の有効な値は、 注意 : この属性を |
boolean |
省略可能 |
host |
サーバ インスタンスがリスンする DNS 名または IP アドレス。 この属性のデフォルト値は |
String |
省略可能 |
port |
サーバ インスタンスがリスンする TCP ポート番号。 この属性のデフォルト値は |
int |
省略可能 |
generateconfig |
この属性の有効な値は、 |
boolean |
省略可能 |
action |
この属性のデフォルト値は |
String |
省略可能 |
failonerror |
WebLogic Server Ant タスクで使用されるグローバル属性。ビルド中にエラーが発生した場合、タスクを失敗させるかどうかを指定する。 この属性の有効な値は、 |
Boolean |
省略可能 |
forceshutdown |
この省略可能な属性は、強制停止を実行するために
|
Boolean |
省略可能 |
noExit |
(省略可能) ant が終了した後もサーバ プロセスを実行したままにする。有効な値は、 |
Boolean |
省略可能 |
protocol |
有効な値は、 |
String |
省略可能 |
forceImplicitUpgrade |
8.1 以前のドメインで実行されている 有効な値は、 ドメインのアップグレードの詳細については、『Oracle Fusion Middleware Oracle WebLogic Server アップグレード ガイド』を参照。 |
Boolean |
省略可能 |
configFile |
ドメインのコンフィグレーション ファイルを指定する。 この属性の値は、 XML ファイルは、ドメインの管理サーバのルート ディレクトリに存在する必要がある。ルート ディレクトリは、カレント ディレクトリか、または この属性を指定しない場合のデフォルトは、 |
String |
省略可能 |
useBootProperties |
WebLogic Server インスタンスの起動時に 注意 :WebLogic Server インスタンスの終了時と再起動時にも |
Boolean |
省略可能 |
verbose |
Ant タスクが、アクションの実行中に追加情報を出力するかどうかを指定する。 この属性の有効な値は、 |
Boolean |
省略可能 |
以下の節では、wlconfig
Ant タスクを使用して WebLogic Server ドメインをコンフィグレーションする方法について説明します。
注意 :: wlconfig Ant タスクは、MBean サーバと互換性のある MBean に対してのみ機能します。この Ant タスクは WebLogic Server 9.0 以降では非推奨になりました。具体的には、wlconfig Ant タスクが非推奨の独自 API weblogic.management.MBeanHome を使用して WebLogic MBean にアクセスします。そのため、wlconfig が MBean を探す際に標準の JMX インタフェース (javax.management.MBeanServerConnection ) が使用されません。つまり、wlconfig を使用してアクセスできる MBean は、『Oracle Fusion Middleware Oracle WebLogic Server MBean リファレンス』に非推奨になった MBean としてリストされている MBean のみということになります。
同等の機能を実現するには、WebLogic Scripting Tool (WLST) を使用する必要があります。『Oracle Fusion Middleware Oracle WebLogic Scripting Tool ガイド』を参照してください。 |
wlconfig
Ant タスクを使用すると、動作中の管理サーバ インスタンス上で MBean の作成、クエリ、変更を行うことで、WebLogic Server ドメインをコンフィグレーションできます。特に、wlconfig
では以下のことを実行できます。
新しい MBean を作成し、必要に応じて新しい MBean オブジェクト名を Ant プロパティに格納する。
管理サーバ上で使用可能な、指定した MBean に属性値を設定する。
MBean を作成するコマンドの内部に属性を設定するコマンドをネストすることで、MBean の作成と属性の設定を 1 回の手順で行う。
MBean のクエリを実行し、必要に応じてクエリの結果を Ant プロパティ参照内に格納する。
MBean のクエリを実行し、一致するすべての結果に対して属性を設定する。
作成コマンドを他の作成コマンドの内部にネストすることで、MBean 間の親子関係を確立する。
コマンド シェルで環境を設定します。詳細については、「wlserver を使用する基本的な手順」を参照してください。
注意 : wlconfig タスクは、WebLogic Server に付属しているバージョンの Ant であらかじめ定義されています。独自にインストールした Ant でこのタスクを使用する場合は、ビルド ファイルに次のタスク定義を追加します。
prompt> java weblogic.DDConverter [options] archive_file_or_directory |
Ant タスクのコンテキストで作成された新しい WebLogic Server ドメインをコンフィグレーションするには、通常 wlconfig
を wlserver
と組み合わせて使用します。wlconfig
を使用してそのようなドメインをコンフィグレーションする場合は、最初に wlserver
属性を使用して新しいドメインを作成し、WebLogic Server インスタンスを起動します。
wlconfig
タスクの最初の呼び出しを追加して、ドメインの管理サーバに接続します。次に例を示します。
<target name="doconfig"> <wlconfig url="t3://localhost:7001" username="weblogic" password="weblogic"> </target>
ネストされた create
、delete
、get
、set
、および query
要素を追加して、ドメインをコンフィグレーションします。
ステージング ディレクトリで ant
と入力し、必要であればこのコマンドにターゲットの引数を渡して、build.xml
ファイルで指定された Ant タスク (1 つまたは複数) を実行します。
prompt> java weblogic.DDConverter [options] archive_file_or_directory
wlconfig
タスクからより詳細なメッセージを取得するには、ant -verbose
を使用します。
注意 : ドメイン作成スクリプトとしては WLST をお勧めします。ソフトウェアとともにインストールされているオフラインの WLST サンプル スクリプトを参照してください。これらのスクリプトを参照すると、ドメイン テンプレートを使用してドメインを作成する方法が理解できます。オフライン スクリプトは、WL_HOME \common\templates\scripts\wlst ディレクトリにあります。WL_HOME は、WebLogic Server の最上位のインストール ディレクトリを表します。たとえば、basicWLSDomain.py スクリプトを実行すると、単純な WebLogic ドメインが作成されます。一方、sampleMedRecDomain.py を実行すると、Avitek MedRec サンプルで使用するようなリソースを定義したドメインが作成されます。『Oracle Fusion Middleware Oracle WebLogic Scripting Tool ガイド』を参照してください。 |
次の表では、wlconfig
Ant タスクの主な属性について説明します。
表 2-2 wlconfig Ant タスクの主な属性
属性 | 説明 | データ型 | 必須/省略可能 |
---|---|---|---|
url |
ドメインの管理サーバの URL。 |
String |
必須 |
username |
管理者アカウントのユーザ名。 |
String |
省略可能 |
password |
管理者アカウントのパスワード。 ビルド ファイルまたは デフォルト以外のコンフィグレーション ファイルとキー ファイルからユーザ名およびパスワードを取得する場合は、 パスワードの格納と暗号化の詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』にある |
String |
省略可能 |
failonerror |
WebLogic Server Ant タスクで使用されるグローバル属性。ビルド中にエラーが発生した場合、タスクを失敗させるかどうかを指定する。この属性は、デフォルトで true に設定される。 |
Boolean |
省略可能 |
userconfigfile |
管理ユーザ名および管理パスワードを取得するために使用するユーザ コンフィグレーション ファイルの場所を指定する。このオプションは、プレーン テキストのパスワードをインラインに表示したくない場合はビルド ファイルで、または
|
ファイル |
省略可能 |
userkeyfile |
ユーザ コンフィグレーション ファイル (
|
ファイル |
省略可能 |
wlconfig
には、コンフィグレーション オプションを指定するためにネストできる要素もあります。
create
要素は、WebLogic Server ドメインで新しい MBean を作成します。wlconfig
タスクには create
要素をいくつでも指定できます。
create
要素には、ネストされた set
要素をいくつでも指定できます。この要素では、新しく作成される MBean の属性を設定します。create
要素にはネストされた create
要素を追加することもできます。この要素は子 MBean を作成します。
create
要素には次の属性があります。
delete
要素は、WebLogic Server ドメインから既存の MBean を削除します。delete
要素には属性が 1 つあります。
set
要素は、指定された MBean、新しく作成された MBean、またはクエリの一部として取得された MBean に対して、MBean 属性を設定します。set
要素は、wlconfig
タスクの直接の子として、または create
要素や query
要素の内部にネストして指定することができます。
set
要素には次の属性があります。
表 2-5 set 要素の属性
属性 | 説明 | データ型 | 必須/省略可能 |
---|---|---|---|
attribute |
設定する MBean 属性の名前。 |
String |
必須 |
value |
指定された MBean 属性に設定する値。 値のリスト全体を引用符で囲み、オブジェクト名をセミコロンで区切ることによって、(Ant プロパティに格納されている) 複数のオブジェクト名を 1 つの値として指定できる。 |
String |
必須 |
mbean |
値を設定する MBean のオブジェクト名。この属性は、 |
String |
|
domain |
この属性は、セキュリティ MBean またはサード パーティ SPI MBean の JMX ドメイン名を指定する。ドメインは WebLogic Server ドメインに相当するため、管理 MBean の場合は省略可能。 注意 : |
String |
省略可能 |
get
要素は、WebLogic Server ドメインの MBean から属性値を取得します。wlconfig
タスクには get
要素をいくつでも指定できます。
get
要素には次の属性があります。
query
要素は検索パターンに一致する MBean を見つけます。
query 要素では、以下のネストされた子要素を使用できます。
set
- 結果セット内のすべての MBean に対して set 操作を実行します。
get
- 結果セット内のすべての MBean に対して get 操作を実行します。
create
- 結果セット内の各 MBean が、新しい MBean の親として使用されます。
delete
- 結果セット内のすべての MBean に対して delete 操作を実行します。
invoke
- 結果セット内で一致する MBean をすべて呼び出します。
wlconfig
タスクには、ネストされた query
要素をいくつでも指定できます。
query
には次の属性があります。
表 2-7 query 要素の属性
属性 | 説明 | データ型 | 必須/省略可能 |
---|---|---|---|
domain |
MBean を検索する WebLogic Server ドメインの名前。 |
String |
省略可能 |
type |
クエリを実行する MBean のタイプ |
String |
省略可能 |
name |
クエリを実行する MBean の名前。 |
String |
省略可能 |
pattern |
JMX クエリ パターン。 |
String |
省略可能 |
property |
クエリ結果を格納するオプションの Ant プロパティの名前。 |
String |
省略可能 |
domain |
この属性は、セキュリティ MBean またはサード パーティ SPI MBean の JMX ドメイン名を指定する。ドメインは WebLogic Server ドメインに相当するため、管理 MBean の場合は省略可能。 |
String |
省略可能 |
invoke
要素は、1 つまたは複数の MBean の管理操作を呼び出します。WebLogic Server Mbean の場合、通常このコマンドを使用して、ほとんどの WebLogic Server MBean が備えている get
Attribute
と set
Attribute
以外の操作を呼び出します。
invoke
要素には次の属性があります。
libclasspath
Ant タスクは、アプリケーション ライブラリや Web ライブラリなどのライブラリを使用しているアプリケーションをビルドするために使用します。
独自にインストールした Ant でこのタスクを使用するには、ビルド ファイルに次のタスク定義を追加します。
<taskdef name="libclasspath" classname="weblogic.ant.taskdefs.build.LibClasspathTask"/>
次の表では、libclasspath
Ant タスクの主な属性について説明します。
表 2-9 libclasspath Ant タスクの属性
属性 | 説明 | 必須 |
---|---|---|
basedir |
抽出元の . |
|
basewar |
抽出元の .war ファイルの名前。 |
|
tmpdir |
ライブラリの抽出に使用されるディレクトリの完全修飾名。 |
必須 |
classpathproperty |
参照されるライブラリのクラスパスを指定する。 たとえば、 また、 |
2 つの属性のうち少なくとも 1 つが必須 |
resourcepathproperty |
クラスではないライブラリ リソースを指定する。 たとえば、 |
libclasspath
には、コンフィグレーション オプションを指定するためにネストできる 2 つの要素があります。libclasspath
Ant タスクを使用する場合は、少なくともこのうちの 1 つの要素が必要です。
この要素を使用する場合は次の属性が必須です。
dir
- このディレクトリのすべてのファイルが使用可能なライブラリとして登録されることを指定します。
この節では、libclasspath
Ant タスクのサンプル コードを示します。
コード リスト 2-1 libclasspath Ant タスクのサンプル コード
.
.
.
<taskdef name="libclasspath" classname="weblogic.ant.taskdefs.build.LibClasspathTask"/>
<!-- weblogic-application.xml で定義されたライブラリに基づいてクラスパスをビルドする。-->
<target name="init.app.libs">
<libclasspath basedir="${src.dir}" tmpdir="${tmp.dir}" classpathproperty
="app.lib.classpath">
<librarydir dir="${weblogic.home}/common/deployable-libraries/"/>
</libclasspath>
<echo message="app.lib.claspath is ${app.lib.classpath}" level="info"/>
</target>
.
.
.