名称

deploy - 指定されたコンポーネントの配備

形式

deploy [ --user admin_user ] [ --password admin_password ] [ --host host_name ] [ --port port_number ] [ --protocol=rmi|jmxmp ] [ --passwordfile filename ] [ --terse=true|false ] [ --echo=true|false ] [ --interactive=true|false ] [ --secure=true|false ] [ --help ] [ --virtualservers virtual_servers ] [ --contextroot context_root ] [ --force=true ] [ --precompilejsp=false ] [ --name component_name ] [ --upload=true ] [ --retrieve local_dirpath ] [ --dbvendorname dbvendorname ] [ --createtables=true|false | --dropandcreatetables=true|false ] [ --uniquetablenames=true|false ] [ --deploymentplan deployment_plan ] [ --enabled=true ] [ --rmic=false ] [ --libraries jar_file [(path_separator)jar_file*] ] filepath

説明

EJB、ウェブ、コネクタ、Java EEアプリケーションを配備します。 コ ン ポーネントが既に配備されている、もしくは存在する場合、 --forcedオプションがtrueならば強制的に再配備されます。 --createtablesオプションと--dropandcreatetablesオプション は boolean で あり、trueまたはfalseの値をとります。これらのオプ ションはデータベースへマップされていないCMP beanの配備の間の み 使用されます。(すなわちどんなnec-cmp-mappings.xmlディスク リプタもモジュールのMETA-INF ディレクトリに出力されません)さ もなければそれらは無視されます。 --createtablesオプションと--dropandcreatetablesオプション は 互 い に排他的で、一方のみが使用できます。createtablesまたは dropandcreatetablesが失敗した場合、配備は失敗せず、警告 メッ セージがログファイルに出力されます。 ダイナミックRMI-IIOPを有効にしてサーバを実行している場合( デ フォ ルト)、RMI-IIOP用のスタブとタイを生成する必要はありませ ん。ダイナミックRMI-IIOPが無効になっている場合は、--rmicを指 定してスタブとタイを生成する必要があります。 このコマンドはリモートモードでのみ使用できます。

オプション

-u --user

ドメインの運用管理エージェントの管理ユーザ名。 既にotxadmin loginコマンドでログインしている場 合 は、--userオプションの指定は不要です。

-w --password

ドメインの運用管理エージェントの管理ユーザのパ ス ワー ド。

-H --host

ドメインの運用管理エージェントが起動しているマシン名。

-p --port

ドメインの運用管理エージェントのポート番号。既定 値 は 6212です。

--protocol

ドメインの運用管理エージェントとの接続プロトコルを選択 します。指定できるプロトコルは、rmi、jmxmpです。既定値 はrmiです。

--passwordfile

ドメインの運用管理エージェントのパスワードを含むファイ ル。

-t --terse

trueを指定すると、出力データがスクリプトによる処理のた めの簡潔なデータとなります。既定値はfalseです。

-e --echo

trueを指定すると、標準出力でコマンドライン文が表示され ます。既定値はfalseです。

-I --interactive

true(既定値)を指定すると、パスワードオプション入力用の プロンプトを表示します。

-s --secure

trueを指定すると、ドメインの運用管理エージェントとの通 信にSSL/TLSを利用します。既定値はfalseです。

--help

コマンドのヘルプを表示します。

--virtualservers

仮想サーバ名のコンマ区切りの一覧

--contextroot

アーカイブがウェブモジュールの場合のみ有効。他のアーカ イブタイプの場合は無視され、拡張子なしのファイル名がデ フォルトとなります。

--force

指定されたコンポーネントが既に配備されているあるいは存 在する場合でも強制的にコンポーネントを(再)配備すること を保証します。既定値はfalseです。

--precompilejsp

既定値はfalseで、JSPは配備中に事前コンパイル出来 ま せ ん。代わりにJSPは動作中にコンパイルされます。

--name

配備可能なコンポーネントの名称

--upload

trueの場合、管理サーバに配備可能なファイルをアップロー ドします。サーバマシンに配備可能なファイルへのファイル パスがマウントされている場合、もしくは管理サーバがロー カ ルで動作している場合、uploadオプションをfalseに設定 してください。既定値はtrueです。

--retrieve

ローカルディレクトリへサーバマシンからクライアントスタ ブJARファイルを検索します。

--dbvendorname

使用されているデータベースベンダの名称。既定値 は nec- ejb-jar.xml ファイルのcmp-resource()設定の中で対応する エントリーです。指定されない場合、既定値はSQL92で す。 し たがってテーブルを作成及び削除するためのDDLファイル はSQL92フォーマットで作成されます。

--createtables

マップされていないCMP beansのアプリケーションの配備 で テーブルを作成します。既定値はnec-ejb-jar.xml ファイル のcmp-resource設定の中で対応するエントリーです。指定さ れない場合、既定値は配備ディスクリプタで指定されたエン トリーです。既定値はfalseです。

--dropandcreatetables

マップされていないCMP beansの既に配備されたアプリ ケー ショ ン の再配備でテーブルを削除します。指定されない場 合、nec-ejb-jar.xmlのcmp-resource 設 定 の 中 の drop- tables-at-undeployエントリーがtrueならばテーブルは削除 されます。nec-ejb-jar.xml のcmp-resource設 定 の 中 の create-tables-at-deploy エ ン トリーがtrueならば新しい テーブルが作成されます。再配備の時、以前の配備で作成さ れたテーブルは新しいテーブルが作成される前に削除されま す。既定値はfalseです。

--uniquetablenames

全beanに対して唯一のテーブル名を保証し、ハッシュコード を テーブル名に付加します。case-sensitive bean名のアプ リケーションがある場合に役に立ちます。既定値はfalse で す。

--deploymentplan

WebOTX固有のディスクリプタを含むJARで あ る deployment plan を取り、それを配備します。これはピュアEARファイル を配備するときに使われます。ピュアEAR ファ イ ル と は WebOTX固有のディスクリプタなしのEARです。

--enabled

配備中にアプリケーションを有効化するかどうかを指定しま す。 true(既定値。ただしCORBAを除く)の場合、アプリケー ションが有効な（利用可能な）状態で配備が終了されます。 false の場合、アプリケーションは無効な状態で配備が終了 されます。

--rmic

RMI-IIOP用のスタブとタイを生成するためのフラグ。このフ ラグがtrueの場合スタブとタイが生成されます。このフラグ がfalseの場合スタブとタイは生成されず、そのためサー バ はダイナミックRMI-IIOPが有効である必要があります。

オペランド

filepath

--uploadオプションがtrueの場合、ローカルマシン上の配備 可能なファイルへのパス。さもなければサーバマシンへの絶 対パス。

使用例

例1: デフォルトコンテキストルートを持つウェブ ア プ リ ケーションを配備
helloコンテキストルートにhello.warファイル内のウェブア プ リ ケーションを配備します。
otxadmin> deploy --user admin hello.war
Command deploy executed successfully
例2: Standard-J Editionでenterprise bean(EJBコンポーネ ント)を配備
container-managed persistence(CMP)を持つenterprise beanを配 備し、beanによって使用されるデータベースを作成します。
otxadmin> deploy --user admin --createtables=true EmployeeEJB.jar
Command deploy executed successfully
例3: Standard-J EditionでJava EEアプリケーションを配備
Cart.earファイルにパッケージされたJava EEアプリケーション を 配備(インストール)します。
otxadmin> deploy --user admin --password adminadmin --host bluestar --port 6212 Cart.ear
Command deploy executed successfully
例4: コネクタモジュール(リソースアダプタ)を配備
RARファイルにパッケージされたコネクタモジュールを配 備 し ま す。
otxadmin> deploy --user admin jdbcra.rar
Command deploy executed successfully

終了ステータス

0 :	コマンド実行成功
1 :	コマンド実行失敗

関連事項

undeploy(1) list-components(1)