名称

undeploy - ドメインアプリケーションサーバのコンポーネント の 削除

形式

undeploy [ --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 ] [ --droptables=true|false ] [ --cascade=false ] [ --target target ] component_name

説明

undeployはドメインアプリケーションサーバの指定されたコンポー ネントを削除します。 --droptablesオプションはテーブルが配備によって作成されている CMP beanを削除するためにのみ使用されます。指定されない場合、 配備ディスクリプタのエントリーが使用されます。 このコマンドはリモートモードでのみ使用できます。

オプション

-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

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

--droptables

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

--cascade

trueの場合、コネクションプールと配備されていないリソー スアダプタと関連するコネクタリソース全てを削除します。 falseの場合、プールとリソースがリソースアダプタと関 連 しているなら削除は失敗します。そのとき、それらのプール とリソースは明示的に削除されているかオプションがtrueに 設 定されていなければいけません。オプションがfalseに設 定され、リソースアダプタに関連するプールやリソースがな い場合、リソースアダプタは削除されます。このオプション はコネクタ(リソースアダプタ)とアプリケーションに適用可 能です。既定値はfalseです。

--ejbunbind

falseの場合、配備解除対象のコンポーネントのJNDI名は ア ンバインドされません。

オペランド

component_name

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

使用例

例1: 簡単なundeployment
Cartという名前のアプリケーションを削除(アンインストール)しま す。
otxadmin> undeploy --user admin Cart
例2: container-managed persistence(CMP)を 持 つ enter- prise beanを削除する
myejbという名前のCMP beanを削除し、対応するデータベース テー ブルを削除します。生産環境で、データベーステーブルは価値のあ る情報を含むので、--droptablesオプションは注意して使用してく ださい。
otxadmin> undeploy --user admin --droptables=true myejb
例3: コネクタ(リソースアダプタ)の削除
jdbcraという名前のコネクタモジュールを削除し、関連するリソー スとコネクションプールを削除するために段階的な削除を実行しま す。
otxadmin> undeploy --user admin --cascade=true jdbcra

終了ステータス

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

関連事項

deploy(1) deploydir(1) list-components(1)