名称
deploy - コンポーネントの配備
形式
deploy [ --user admin_user ] [ --password admin_password ]
[ --host host_name ] [ --port port_number ] [ --
protocol=rmi|jmxmp ] [ --passwordfile filename ] [ --
encrypted=true|false ] [ --terse=true|false ] [ --
echo=true|false ] [ --interactive=true|false ] [ --
secure=true|false ] [ --legacy=true|false ] [ --help ] [
--name component_name ] [ --force=true|false ] [ --
virtualservers virtual_servers ] [ --
precompilejsp=true|false ] [ --apgroup apg_name ] [ --
pgroup pg_name ] [ --upload=true|false ] [ --
enabled=true|false ] [ --contextroot context_root ] [ --
retrieve local_dirpath ] [ --dbvendorname dbvendorname ]
[ --createtables=true|false ] [ --
dropandcreatetables=true|false ] [ --
uniquetablenames=true|false ] [ --deploymentplan
deployment_plan ] [ --rmic=true|false ] [ --libraries
jar_file[,jar_file*] ] [ --methodid all|limit|none ] [ --
statechecktimeout timeout ] [ --bindtype
persistent|transient ] [ --bindiortojndi=true|false ] [
--keepstate=true|false ] [ --type pkg-type ] [ --
hotswapenabled=true|false ] [ --preprocessor preprocessor-
name ] filepath
説明
EJB、WAR、コネクタ等のコンポーネントを配備します。コンポーネ
ン トが既に配備されている場合、--forceオプションがtrueならば
再配備されます。
--createtablesオプションと--dropandcreatetablesオ プ ショ ン
は、 データベースにマッピングされていないCMPの配備の時のみ利
用されます。マッピングされていないとは、モジュールのディレク
トリMETA-INFにデスクリプタnec-cmp-mappings.xmlが存在しない場
合の事です。
--createtablesオプションと--dropandcreatetablesオプション は
互 い に排他的で、一方のみが使用できます。createtablesまたは
dropandcreatetablesが失敗した場合、配備は失敗せず、警告 メッ
セージがログファイルに出力されます。
WebOTX AS Foundation/Standard/EnterpriseにWAR/EJB/CORBAア プ
リケーションを配備する場合は、配備先のアプリケーショングルー
プとプロセスグループを指定するために--apgroup と --pgroup を
利用する必要があります。アプリケーショングループとプロセスグ
ループはアプリケーションを配備する前に作成しておく必要があり
ま す。 再 配 備 の 場 合 ( コ ン ポーネントが既に配備済みで
--force=trueを利用した場合)、--apgroup と --pgroup は無視 さ
れ、以前と同じアプリケーショングループとプロセスグループに配
備されます。
このコマンドはリモートモードでのみ使用できます。
オプション
-u --user
ドメインの運用管理エージェントの管理ユーザ名。
既にotxadmin loginコマンドでログインしている場 合 は、
--userオプションの指定は不要です。
-w --password
ドメインの運用管理エージェントの管理ユーザのパ ス ワー
ド。
-H --host
ドメインの運用管理エージェントが起動しているマシン名。
-p --port
ドメインの運用管理エージェントのポート番号。既定 値 は
6212です。
--protocol
ドメインの運用管理エージェントとの接続プロトコルを選択
します。指定できるプロトコルは、rmi、jmxmpです。既定値
はrmiです。
-W --passwordfile
ドメインの運用管理エージェントのパスワードを含むファイ
ル。
--encrypted
ドメインの運用管理エージェントのパスワードに暗号化され
た パスワードを利用する場合に指定します。既定値はfalse
です。暗号化されたパスワードの生成にはencryptコマン ド
を 使 用してください。このオプションはpasswordfileオプ
ションが指定されている場合のみ有効です。
-t --terse
trueを指定すると、出力データがスクリプトによる処理のた
めの簡潔なデータとなります。既定値はfalseです。
-e --echo
trueを指定すると、標準出力でコマンドライン文が表示され
ます。既定値はfalseです。
-I --interactive
true(既定値)を指定すると、パスワードオプション入力用の
プロンプトを表示します。
-s --secure
trueを指定すると、ドメインの運用管理エージェントとの通
信にSSL/TLSを利用します。既定値はfalseです。
--legacy
trueを指定すると、コマンドの接続先のサーバがV8か、V9か
確認します。確認後V8であれば旧互換動作を行い、V9であれ
ばV9の動作を行います。falseの場合は接続先のサーバを 確
認せずにV9の動作を行います。既定値はfalseです。
--help
コマンドのヘルプを表示します。
--name
コンポーネントの名前を指定します。
--force
指定されたコンポーネントが配備済みの場合、再配備を行い
ます。既定値はfalseです。
--virtualservers
リクエストを受け付ける仮想サーバ名を指定します。複数指
定する場合はコンマ区切りで列挙します。
--precompilejsp
配備時にJSPの事前コンパイルを行います。既定値 は false
で、JSPの事前コンパイルは行いません。この場合、JSPは初
回アクセス時にコンパイルされます。
--apgroup
配備先のアプリケーショングループを指定します。
--pgroup
配備先のプロセスグループを指定します。
--upload
trueを指定した場合、WebOTX ASにファイルをアップロー ド
します。配備対象のファイルがサーバマシンにある場合、こ
のオプションをfalseにすることでアップロードを抑止で き
ま す。falseを指定した場合は、オペランドにサーバマシン
でのファイルパスを指定してください。既定値はtrueです。
--enabled
配備完了後に、コンポーネントをコンテナにロードするかど
う か を 指定します。既定値(ただしCORBAを除く)はtrueで
す。falseを指定した場合、配備完了後のコンポーネント は
停止状態となります。
--contextroot
WARのコンテキストルートを指定します。コンポーネント が
WARの場合のみ有効です。デスクリプタWEB-INF/nec-web.xml
の<contextroot>よりも優先して利用されます。こ の オ プ
ショ ン の指定がなく、なおかつデスクリプタWEB-INF/nec-
web.xmlで<contextroot>の指定がない場合、拡張子な し の
ファイル名がデフォルトとなります。
--retrieve
クライアントスタブJARファイルを、サーバマシンから指 定
したディレクトリにダウンロードします。
--dbvendorname
使用するデータベースのベンダ名を指定します。デスクリプ
タ nec-ejb-jar.xmlのcmp-resourceでの設定よりも優先して
利用されます。既定値はSQL92で、この場合のDDLはSQL92 の
形式を利用します。
--createtables
マップされていないCMPに対してテーブルを作成します。 デ
ス クリプタnec-ejb-jar.xmlのcmp-resourceでの設定よりも
優先して利用されます。既定値はfalseです。
--dropandcreatetables
マップされていないCMPを配備する際にテーブルを再作成 し
ま す。デスクリプタnec-ejb-jar.xmlのcmp-resourceでの設
定よりも優先して利用されます。既定値はfalseです。
--uniquetablenames
全てのCMPに対してユニークとなるテーブル名を保 証 し ま
す。テーブル名にはハッシュコードが付加されます。このオ
プションは、大文字と小文字が異なるだけのCMPがある場 合
に役に立ちます。既定値はfalseです。
--deploymentplan
配備で利用するデプロイメントプランを指定します。デプロ
イメントプランとは、WebOTX AS固有のディスクリプタをJAR
でまとめたものです。このオプションは、コンポーネントが
WebOTX AS固有のディスクリプタを含まない場合に利用しま
す。
--rmic
RMI-IIOP用のスタブとタイを生成するかどうかを指定 し ま
す。 trueの場合はスタブとタイを生成し、falseの場合は生
成しません。既定値はfalseです。
--libraries
ライブラリJARファイルの絶対パス、相対パスを指 定 し ま
す。相対パスは、[ドメインディレクトリ]/lib/applibsから
の相対パスを指定します。複数のパスを指定する場合、コン
マを区切り文字として使用します。
--methodid
プロセスグループに配備するEJBについて、メソッドIDの 割
り 当て方法を指定します。limitの場合はビジネスメソッド
に対してのみ割り当てられます。allの場合はすべ て の リ
モートメソッドに対して割り当てられます。noneの場合は割
り当てを行いません。既定値はlimitです。
--statechecktimeout
プロセスグループに配備したコンポーネントについて、コン
ポーネント状態確認のタイムアウト値を指定します。単位は
秒です。
--bindtype
名前サーバの登録方式を設定します。永続的に扱う場合、名
前 サーバへのIOR登録をプロセス起動停止に関係なく行えま
す。このため、プロセス起動時の名前サーバアクセス負荷を
軽減することができます。一時的に扱う場合、プロセス起動
時に名前サーバへの登録を行います。このとき、ラウンドロ
ビン機能の設定もできます。
--bindiortojndi
IORをJNDIに登録するかどうかを指定します。trueの場合 は
IORをJNDIに登録し、falseの場合は登録しません。既定値は
trueです。
--keepstate
Webセッション、SFSBインスタンス、および永続的に作成 さ
れ たEJBタイマーを、再配備時に保持するかどうかを指定し
ます。trueの場合は再配備時に再配備前の値が保持 さ れ、
falseの場合は保持されません。既定値はfalseです。
--type
配備されるコンポーネントの種類を指定します。指定可能な
値はosgiのみです。OSGiバンドルを配備する際にosgiを指定
します。それ以外の種類のコンポーネントは自動的に判別さ
れます。
--hotswapenabled
アプリケーションでホットスワップ機能を有効にするかどう
かを指定します。アプリケーションサーバでホットスワップ
機能が有効になっている場合、trueを指定するとアプリケー
ション内のクラスファイルの更新を自動で検出し、変更され
たクラスの再定義を行います。falseの場合は、クラス ファ
イルの更新が検出されません。既定値はfalseです。
--preprocessor
配備前に実行するプリプロセッサを指定します。
オペランド
filepath
--uploadオプションがtrueの場合はローカルマシン上のファ
イルへのパス。falseの場合はサーバマシンへの絶対パス。
使用例
例1: WebOTX AS ExpressでWebアプリケーションを配備
Webアプリケーションhello.warを配備します。コンテキストルート
は/greetingです。
otxadmin> deploy --user admin --password adminadmin --contextroot /greeting hello.war
Command deploy executed successfully
例2: WebOTX AS ExpressでEJB(CMP)を配備
EJB(CMP)を配備し、CMPよって使用されるデータベースのテーブ ル
を作成します。
otxadmin> deploy --user admin --password adminadmin --createtables=true EmployeeEJB.jar
Command deploy executed successfully
例3: WebOTX AS EnterpriseでEARを配備
Cart.earを、アプリケーショングループmyapg、プロセスグルー プ
mypgに配備します。
otxadmin> deploy --user admin --password adminadmin --apgroup myapg --pgroup mypg Cart.ear
Command deploy executed successfully
例4: OSGiバンドルを配備
OSGiバンドルbundle.jarを配備します。
otxadmin> deploy --user admin --password adminadmin --type osgi bundle.jar
Command deploy executed successfully
終了ステータス
0 コマンド実行成功
1 コマンド実行失敗
関連事項
undeploy(1) replace(1) enable(1) disable(1) list-components(1)