WebOTXでは、Apache Ant 1.6.5を提供しており、install-dir/bin ディレクトリに配置されるコマンド「asant」を使用してAntを起動することができます。 さらにWebOTXでは、配備などのWebOTX固有のタスクも提供しています。

Antに関する詳細については、Apache Software FoundationのWebサイト、http://ant.apache.org/ を参照してください。

asantコマンドは、WebOTX動作に必要な設定を加えてオリジナルのApache antコマンドを実行するラッパー・スクリプトです。 このスクリプトでは、WebOTX固有のタスクを実行するために必要なWebOTXのJARファイルをクラスパスに加えて、適切なJavaシステム・プロパティを設定しています。

WebOTXでは、モジュールやアプリケーションのアセンブリ、配備、配備解除や、サーバの構成を行うためのAntタスクを提供しています。 そのタスクには、次のものがあります。

• webotx-deploy
• webotx-undeploy
• webotx-component
• webotx-admin
• webotx-jspc
• webotx-update

このタスクは、以下のコンポーネントの配備を行います。

• J2EE Enterprise Application (EARファイル)
• Web Application (Web-WARファイル)
• Enterprise JavaBeans (EJB-JARファイル)
• J2EE Connector (RARファイル)
• Application Client (JARファイル)
• WebOTX CORBA モジュール (cpkファイル)
• WebOTX 共有コンポーネント (spkファイル)

次の表は、webotx-deployタスクのサブ要素を示しています。 これらは、タスクが作用する対象のものです。

これらは、以降の「再利用可能なサブ要素」で後述します。

次の表は、webotx-deployタスクの属性を示しています。

passwordfileに指定するファイルは、「OTX_ADMIN_PASSWORD=<パスワード>」を記述します。 例えば、パスワードが「adminadmin」の場合は「OTX_ADMIN_PASSWORD=adminadmin」と記述します。

最初の例は、多くの既定属性値にしたがった単純なアプリケーション配備のスクリプトです。

<webotx-deploy
        file="${appdir}/simple_app.ear"
        passwordfile="${passwordfile}" />

次の例は、ポート: 6212のドメインに対して配備を要求するスクリプトです。 WebOTXインストール時に作成されるdomain1ドメインは、このポートを設定しています。

<webotx-deploy
        file="${sppdir}/simple_app.ear"
        name="simple_app"
        force="true"
        precompilejsp="false"
        verify="false"
        upload="true"
        user="admin"
        password="adminadmin"
        host="localhost"
        port="6212"
        asinstalldir="${webotxinstalldir}" />

次は、リモートで動作するWebOTXに複数のコンポーネントを配備する例です。

<webotx-deploy passwordfile="${passwordfile}" host="webotx.nec.com"
        asinstalldir="/opt/WebOTX" >
    <component file="${appdir}/simple_app.ear"/>
    <component file="${appdir}/simple_web.war"
      contextroot="example"/>
    <component file="${appdir}/simple_ejb.jar"/>
</webotx-deploy>

最後の例は、filesetサブ要素を用いて相当するコンポーネントを配備するものです。 先の例と同じ働きをします。 ただし、nameやcontextrootのようなコンポーネントに固有の属性設定ができないことに注意してください。 この場合、それらは既定値が用いられます。

<webotx-deploy passwordfile="${passwordfile}" host="webotx.nec.com"
      asinstalldir="/opt/WebOTX" >
    <fileset dir="${appdirs}" includes="**/*.?ar" />
</webotx-deploy>

このタスクは、以下のコンポーネントの配備解除を行います。

• J2EE Enterprise Application (EARファイル)
• Web Application (Web-WARファイル)
• Enterprise JavaBeans (EJB-JARファイル)
• J2EE Connector (RARファイル)
• Application Client (JARファイル)
• WebOTX CORBA モジュール (cpkファイル)
• WebOTX 共有コンポーネント (spkファイル)

次の表は、webotx-undeployタスクのサブ要素を示しています。 これらは、タスクが作用する対象のものです。

これらは、以降の「再利用可能なサブ要素」で後述します。

次の表は、webotx-undeployタスクの属性を示しています。

最初の例は、単純なアプリケーション配備解除のスクリプトです。

<webotx-undeploy
        name="simple_app"
        user="admin"
        password="adminadmin"
        host="localhost"
        port="6212"
        asinstalldir="${webotxinstalldir}" />

次の例は、配備解除するJ2EEアプリケーション(EAR)とWebアプリケーション(WAR)のアーカイブ・ファイルと、配備解除するEJBコンポーネントの名前を用いて、複数のコンポーネントを配備解除するものです。

<webotx-undeploy passwordfile="${passwordfile}">
    <component file="${appdir}/simple_app.ear"/>
    <component file="${appdir}/simple_web.war"/>
    <component name="simple_ejb" />
</webotx-undeploy>

WebOTXに配備された下記のコンポーネント・タイプを有効化(起動)、無効化(停止)します。

• J2EE Enterprise Application (EARファイル)
• Web Application (Web-WARファイル)
• Enterprise JavaBeans (EJB-JARファイル)
• J2EE Connector (RARファイル)
• Application Client (JARファイル)
• WebOTX CORBA モジュール (cpkファイル)

コンポーネント名が指定された場合は、コンポーネントの有効化/無効化のためにアーカイブ・ファイルを指定する必要はありません。 しかし、アーカイブ・ファイルが暗黙にコンポーネント名を特定するので、アーカイブ・ファイルを指定しても構いません。

次の表は、webotx-componentタスクのサブ要素を示しています。 これらは、タスクが作用する対象のものです。

これらは、以降の「再利用可能なサブ要素」で後述します。

次の表は、webotx-componentタスクの属性を示しています。

最初の例は、コンポーネントを無効化にする単純なものです。

<webotx-component
        action="disable"
        name="simple_app"
        passwordfile="${passwordfile}" />

次の例は、コンポーネントを有効化にする単純なものです。

<webotx-component
        action="enable"
        name="simple_app"
        passwordfile="${passwordfile}" />

この例では、いくつかの既定属性値を明示的に与えながら、WebOTXインストール時に作成されるdomain1ドメイン (ポート: 6212) に対してコンポーネントを有効化にする、上の例と同等なスクリプトです。

<webotx-component
        action="enable"
        name="simple_app"
        user="admin"
        passwordfile="${passwordfile}"
        host="localhost"
        port="6212"
        asinstalldir="${webotxinstalldir}" />

最後の例は、J2EEアプリケーション(EAR)とWebアプリケーション(WAR)のアーカイブ・ファイルと、EJBコンポーネントの名前を用いて、無効化にする複数のコンポーネントを定義するものです。

<webotx-component action="disable" passwordfile="${passwordfile}">
    <component file="${appdir}/simple_app.ear"/>
    <component file="${appdir}/simple_web.war"/>
    <component name="simple_ejb" />
</webotx-component>

任意の運用管理コマンドやスクリプトからWebOTXアプリケーション・サーバの制御を実行できます。 特定のAntタスクを作っていなかったり、関連するコマンドの組み合わせが単一のスクリプトで構築される場合に役立ちます。

なし

次の表は、webotx-adminタスクの属性を示しています。

最初の例は、コネクタ・リソースの生成コマンドを実行するものです。

<webotx-admin command="create-connector-resource --poolname acos eis/vis" />

次の例は、コネクタ・リソースの生成コマンドを実行するために、commandfileを使用したものです。

<webotx-admin commandfile="create_connector_resource.txt" />

この例でのcreate_connector_resource.txtファイルは、以下の内容を含みます。

create-connector-resource --user admin --passwordfile "${passwordfile}" --host localhost --port 6212 --poolname acos eis/vis

最後の例は、コマンドを実行するために、explicitcommandを使用したものです。

<webotx-admin command="create-connector-resource --user admin --passwordfile "${passwordfile}" --host localhost --port 6212 --poolname acos eis/vis" />

WebOTXによるJSPの初回呼び出し時に生成する、JSPソース・コードからWebコンテナ用のサーブレットJavaコードへの変換と同じ処理を、このタスクでJSPのソース・コードの事前コンパイルとして実行します。 このタスクは、JSPファイルへのアクセス性能向上のためや、JSPソース・コードの構文チェックのために使用します。 JSPファイルからクラスファイルを生成するために、そこで出力しJavaコードをjavacタスクに与えることができます。

なし

この例は、JSPファイルからJavaソース・ファイルを生成するために、webapp属性を使用するものです。 javacタスクはwebotx-jspcタスクに従って動作し、実装クラスのファイルとして生成されたJavaファイルをコンパイルします。 javacタスクの中のclasspath値は、スペースを含まない1行に全てを記述しなければなりません。

<webotx-jspc
        destdir="${appdir.war}/generated"
        webapp="${appdir.war}"
        classpath="${appdir.war}/WEB-INF/classes"
        asinstalldir="${webotxinstalldir}" />
<javac
        srcdir="${appdir.war}/WEB-INF/generated"
        destdir="${appdir.war}/WEB-INF/generated"
        debug="on"
        classpath="${appdir.war}/WEB-INF/classes:
                ${webotxinstalldir}/lib/wosv-rt.jar:
                ${webotxinstalldir}/lib/wosv-ext.jar">
    <include name="**/*.java"/>
</javac>

開発、配備、実行のサイクルを素早く繰り返すための用途として、配備済みJ2EEアプリケーション(EAR)やモジュール(WAR、EJB-JAR、RAR)を更新、再読み込みできます。 このタスクは、修正したクラス・ファイルやXMLファイル、その他、アーカイブ・ファイルの中身を、domain-dir/applicationsディレクトリの対応するサブ・ディレクトリにコピーし、次に、それらをダイナミック・リローディングによって反映させるために.reloadファイルを更新します。

これはローカル・マシン上で利用できるタスク、すなわちWebOTXサーバと同じマシン上で実行されなければなりません。

なし

次の例は、デフォルトのドメイン、domain1に配備されているJ2EEアプリケーション (simple.ear) を更新します。

<webotx-update file="simple.ear"/>

WebOTX用のAntタスクにおける再利用可能なサブ要素は次のとおりです。 これらは、Antタスクが作用する対象のものです。

• component
• fileset

コンポーネントを指定します。 1つのタスクで複数のコンポーネントを操作できます。 component属性は、親のタスクの相当する属性をオーバーライドします。 したがって、親タスクの属性は既定値として機能します。

なし

単一のタスクを使用して複数のコンポーネントを配備できます。 この例は、リモート・サーバ上で作動する同じアプリケーションサーバに各コンポーネントを配備します。

<webotx-deploy passwordfile="${passwordfile}" host="webotx.nec.com"
        asinstalldir="/opt/WebOTX" >
    <component file="${appdir}/simple_app.ear"/>
    <component file="${appdir}/simple_web.war"
      contextroot="test"/>
    <component file="${appdir}/simple_ejb.jar"/>
</webotx-deploy>

単一のタスクを使用して複数のコンポーネントを配備解除できます。 この例は、アーカイブ・ファイル (この場合、J2EEアプリケーション(EAR)とWebアプリケーション(WAR)) と、(EJBコンポーネントの) コンポーネント名を用いています。

<webotx-undeploy passwordfile="${passwordfile}">
    <component file="${appdir}/simple_app.ear"/>
    <component file="${appdir}/simple_web.war"/>
    <component name="simple_ejb" />
</webotx-undeploy>

複数のコンポーネントを有効化・無効化できます。 最後の例は、アーカイブ・ファイル (この場合、J2EEアプリケーション(EAR)とWebアプリケーション(WAR)) と、(EJBコンポーネントの) コンポーネント名を用いて複数のコンポーネントを無効化しています。

<webotx-component action="disable" passwordfile="${passwordfile}">
    <component file="${appdir}/simple_app.ear"/>
    <component file="${appdir}/simple_web.war"/>
    <component name="simple_ejb" />
</webotx-component>

指定したパラメータに対応するコンポーネントのファイルを選択します。 filesetがサブ要素として含まれる場合、そこに含まれる要素のnameとcontextroot属性は、filesetの中でそれらの既定値を各ファイルに対して使用されなければなりません。