| ドキュメントのダウンロード | サイト マップ | Glossary | |
|
|||
| BEA ホーム | 製品 | dev2dev | support | askBEA |
|
|
|
|||||||
 |
| e-docs > WebLogic Server > 管理者ガイド > Ant タスクを使用した WebLogic Server ドメインのコンフィグレーション |
|
管理者ガイド
|
Ant タスクを使用した WebLogic Server ドメインのコンフィグレーション
以下の節では、WebLogic Ant タスクを使用した WebLogic Server インスタンスの起動と停止の方法、および WebLogic Server ドメインのコンフィグレーション方法を説明します。
Ant タスクを使用したドメインのコンフィグレーションと起動の概要
WebLogic Server は、開発環境で一般的なコンフィグレーション作業を実行する手助けとなる一連のタスクを提供します。 それらのコンフィグレーション タスクでは、WebLogic Server インスタンスの起動と停止、および WebLogic Server ドメインの作成とコンフィグレーションを行うことができます。
注意: WebLogic Server Ant タスクは、1.5 より前の Ant バージョンとは互換性がありません。 また、WebLogic Server に含まれていない Ant のバージョンを使用する場合は、以降の節の説明に従って build.xml ファイルで適切なタスク定義を指定する必要があります。
他の WebLogic Ant タスクと組み合わせると、カスタム ドメインのあるアプリケーションをデモンストレーションまたはテストする優れた構築スクリプトを作成できます。 たとえば、1 つの Ant 構築スクリプトで以下のことができます。
以降の節では、コンフィグレーション Ant タスク wlserver および wlconfig の使い方を説明します。 wldeploy タスクの詳細については、『WebLogic Server アプリケーションの開発』の「wldeploy Ant タスク」を参照してください。
wlserver Ant タスクを使用したサーバの起動とドメインの作成
wlserver Ant タスクを使用すると、WebLogic Server インスタンスの起動、再起動、停止、または接続を行うことができます。 そのサーバ インスタンスはコンフィグレーション済み WebLogic Server ドメインにすでに存在している場合もありますが、generateconfig=true 属性を使用して開発用の新しい単一サーバ ドメインを作成することもできます。
Ant スクリプトで使用する場合、wlserver タスクは指定のサーバが利用可能で接続をリスンするようになるまで制御を返しません。 wlserver を使用してサーバ インスタンスを起動した場合、そのサーバ プロセスは Ant VM が終了した後に自動的に終了します。 wlserver タスクを使用して動作中のサーバに接続するだけの場合、サーバ プロセスは Ant が完了した後も動作を続けます。
wlserver Ant タスクを使用するには、次の手順を行います。
prompt> ant
次に、すべてデフォルト値を使用してカレント ディレクトリでサーバを起動する最小限の 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 タスクの属性について説明します。
wlconfig Ant タスクを使用した WebLogic Server ドメインのコンフィグレーション
wlconfig Ant タスクを使用すると、動作中の管理サーバ インスタンス上でコンフィグレーション MBean の作成、クエリ、変更を行うことで、WebLogic Server ドメインをコンフィグレーションできます。 特に、wlconfig では以下のことを実行できます。
<target name=”doconfig”>
<wlconfig url="t3://localhost:7001" username="weblogic"
password="weblogic">
</target>
prompt> ant doconfig
この例は、wlserver を使用して新しいドメインを作成し、wlconfig でさまざまなドメイン コンフィグレーション タスクを実行する 1 つの build.xml ファイルを示しています。
<target name="sample.config">
mkdir dir="config"/>
<wlserver username="a" password="a" servername="SampleServer"
domainname="sample" dir="config" host="localhost" port="7000"
generateconfig="true"/>
次に、新しいサーバにアクセスして wlconfig タスクを開始します。
<wlconfig url="t3://localhost:7000" username="a" password="a">
wlconfig タスクの中では、query 要素がクエリを実行してサーバ MBean のオブジェクト名を取得し、その MBean を ${sampleserver} Ant プロパティに格納します。
<query domain="sample" type="Server" name="SampleServer"
property="sampleserver"/>
create 要素を使用してドメインに新しい JDBC 接続プールが作成され、そのオブジェクト名が ${samplepool} Ant プロパティに格納されます。 create にネストされている set 要素は、新しく作成された Mbean の属性を設定します。 新しいプールは、前のクエリで設定された ${sampleserver} Ant プロパティを使用してサーバに割り当てられます。
<create type="JDBCConnectionPool" name="SamplePool"
property="samplepool">
<set attribute="CapacityIncrement" value="1"/>
<set attribute="DriverName"
value="com.pointbase.jdbc.jdbcUniversalDriver"/>
<set attribute="InitialCapacity" value="1"/>
<set attribute="MaxCapacity" value="10"/>
<set attribute="Password" value="samplename"/>
<set attribute="Properties" value="user=samplepwd"/>
<set attribute="RefreshMinutes" value="0"/>
<set attribute="ShrinkPeriodMinutes" value="15"/>
<set attribute="ShrinkingEnabled" value="true"/>
<set attribute="TestConnectionsOnRelease" value="false"/>
<set attribute="TestConnectionsOnReserve" value="false"/>
<set attribute="URL"
value="jdbc:pointbase:server://localhost/demo"/>
<set attribute="Targets" value="${sampleserver}"/>
</create>
次に、上で作成された JDBC 接続プールを使用して JDBC TX データソースが作成されます。
<create type="JDBCTxDataSource" name="Medical Records Tx DataSource">
<set attribute="JNDIName" value="SampleTxDataSource"/>
<set attribute="PoolName" value="SamplePool"/>
<set attribute="Targets" value="${sampleserver}"/>
</create>
ネストされた set 要素を使用して、新しい JMS 接続ファクトリが作成されます。
<create type="JMSConnectionFactory" name="Queue">
<set attribute="JNDIName" value="jms/QueueConnectionFactory"/>
<set attribute="XAServerEnabled" value="true"/>
<set attribute="Targets" value="${sampleserver}"/>
</create>
新しい JMS JDBC ストアが、SamplePool を使用して作成されます。
<create type="JMSJDBCStore" name="SampleJDBCStore"
property="samplejdbcstore">
<set attribute="ConnectionPool" value="${samplepool}"/>
<set attribute="PrefixName" value="Sample"/>
</create>
新しい JMS サーバを作成するときには、ネストされた create 要素を使用して JMS キュー (JMS サーバの子) を作成します。
<create type="JMSServer" name="SampleJMSServer">
<set attribute="Store" value="${samplejdbcstore}"/>
<set attribute="Targets" value="${sampleserver}"/>
<create type="JMSQueue" name="Registration Queue">
<set attribute="JNDIName" value="jms/REGISTRATION_MDB_QUEUE"/>
</create>
</create>
このスクリプトは、新しいメール セッションと起動クラスを作成します。
<create type="MailSession" name="Medical Records Mail Session">
<set attribute="JNDIName" value="mail/SampleMailSession"/>
<set attribute="Properties"
value="mail.user=joe;mail.host=mail.mycompany.com"/>
<set attribute="Targets" value="${sampleserver}"/>
</create>
<create type="StartupClass" name="StartBrowser">
<set attribute="Arguments" value="port=${listenport}"/>
<set attribute="ClassName"
value="com.bea.sample.startup.StartBrowser"/>
<set attribute="FailureIsFatal" value="false"/>
<set attribute="Notes" value="Automatically starts a browser on server boot."/>
<set attribute="Targets" value="${sampleserver}"/></create>
最後に、WebServer MBean が取得され、ネストされた set 要素を使用してログ ファイル名が設定されます。
<query domain="sample" type="WebServer" name="SampleServer">
<set attribute="LogFileName" value="logs/access.log"/>
</query>
</wlconfig>
</target>
query 要素の内部にネストされる場合、その query 要素では MBean 名を指定する必要はありません。
<target name="queryDelete">
<wlconfig url="${adminurl}" username="${user}" password="${pass}"
failonerror="false">
<query query="${wlsdomain}:Name=MyNewServer2,*"
property="deleteQuery">
<delete/>
</query>
</wlconfig>
</target>
set 要素では、属性値を Ant プロパティに格納された複数のオブジェクト名に設定できます。 たとえば、次のターゲットは 2 つのサーバのオブジェクト名を別々の Ant プロパティに格納し、それらのプロパティを使用して両方のサーバを新しい JDBC 接続プールのターゲット属性に割り当てます。
<target name="multipleJDBCTargets">
<wlconfig url="${adminurl}" username="${user}" password="${pass}">
<query domain="mydomain" type="Server" name="MyServer"
property="myserver"/>
<query domain="mydomain" type="Server" name="OtherServer"
property="otherserver"/>
<create type="JDBCConnectionPool" name="sqlpool" property="sqlpool">
<set attribute="CapacityIncrement" value="1"/>
[.....]
<set attribute="Targets" value="${myserver};${otherserver}"/>
</create>
</wlconfig>
</target>
次の表では、wlconfig Ant タスクの主な属性について説明します。
wlconfig にも、コンフィグレーション オプションを指定するためにネストできる要素があります。
create 要素は、WebLogic Server ドメインで新しい MBean を作成します。 wlconfig タスクでは、create 要素をいくつでも使用できます。
create 要素では、新しく作成された MBean の属性を設定する set 要素をいくつでもネストできます。 create 要素では、子 MBean を作成する追加の create 要素をネストすることもできます。
delete 要素は、WebLogic Server ドメインから既存の MBean を削除します。 delete の属性は 1 つです。
set 要素は、指定された MBean、新しく作成された MBean、またはクエリで取得された MBean の MBean 属性を設定します。 set 要素は、wlconfig タスクの直接の子として使用するか、create または query 要素にネストすることができます。
|
引用符で値のリスト全体を区切って、セミコロンでオブジェクト名を分ければ、Ant プロパティに格納された複数のオブジェクト名を値として指定できる。 複数の属性値の設定例を参照。 |
|||
|
値が設定される MBean のオブジェクト名。 set 要素が wlconfig タスクの直接の子である場合のみ必須。create または query 要素のコンテキストに set 要素がネストされている場合は省略可能。 |
|||
|
この属性は、セキュリティ MBean およびサードパーティ SPI MBean の JMX ドメイン名を指定する。 ドメインが WebLogic Server ドメインに対応しているため、管理 MBean では省略可能。 |
get 要素は、WebLogic Server ドメインの MBean から属性値を取得します。 wlconfig タスクでは、get 要素をいくつでも使用できます。
query 要素は、検索パターンに一致する MBean を見つけます。 query をネストした set 要素または delete 要素と一緒に使用すると、結果セットのすべての MBean で設定または削除操作を行うことができます。
wlconfig では、query 要素をいくつでもネストできます。
|
この属性は、セキュリティ MBean およびサードパーティ SPI MBean の JMX ドメイン名を指定する。 ドメインが WebLogic Server ドメインに対応しているため、管理 MBean では省略可能。 |
|
|
|
|
||
 |
|
|
 |
 |
 |
|
||