名称
stop-domain - 指定されたドメインの停止
形式
stop-domain [ --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 ] [
--domaindir install_dir/domains ] [ --force=true|false ] [
--adminport=portnumber ] [ --remote=false ] [ --
wait_timeout=time ] domain_name
説明
stop-domainは指定されたドメインを停止します。既定のドメイ ン
ディ レ クトリ(install_dir/domains)にドメインが1つしかない場
合、ドメインを停止するためにオペランドは必要ありません。しか
し 2つ以上ドメインがある場合、ドメインオペランドを指定しなけ
ればいけません。このコマンドはローカルモードでのみ使用できま
す。
--remoteオプションが指定された場合、管理ドメインに接続し、指
定されたドメインの停止を行います。このオプションを使用するた
めに、管理ドメインが起動している必要があります。--remoteオプ
ションを指定した場合、管理ドメインの停止は行えません。
オプション
-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
コマンドのヘルプを表示します。
--domaindir
ドメインが停止されるディレクトリです。指定された場合、
パスはファイルシステムにアクセス可能でなければいけませ
ん。指定されない場合、デフォルトの install_dir/domains
ディレクトリのドメインが停止されます。
--force
ドメインの強制停止を行います。強制停止処理は通常停止を
wait_timeoutオプションで指定した時間試みた後、通常停止
できない場合に関連プロセスの強制停止を行います。既定値
はfalseです。
--adminport
強制停止するドメインの管理ポート番号を指定します。
--remote
指定したホストの管理ドメインに対し、ネットワーク経由で
接続するためのオプションです。--user --password --port
--hostの指定が必要です。既定値はfalseです。
--wait_timeout
通常停止処理を試みる時間[秒]を指定します。このオプショ
ン はforceオプションが指定されている場合のみ有効です。
既定値は1800[秒]です。
オペランド
domain_name
ドメイン名。唯一の名称でなければいけません。
使用例
例1: stop-domainコマンドの使用法
otxadmin> stop-domain domain1
Stopping Domain domain1, please wait
Domain domain1 stopped
Command stop-domain executed successfully
既定のドメインディレクトリのdomain1ドメインを停止します。
例2: --forceオプションの使用法
otxadmin> stop-domain --force=true --wait_timeout 180
domain1 PID fed to killserv is = [xxxx]
Exit value is = 0
強制停止スクリプトの起動に成功しました。ログは<INSTALL_RO
OT>\WebOTX\domains\domain1\logs\agent\webotx_prcstop.log
に書き換えられます。
例3: --remoteオプションの使用法
otxadmin> stop-domain --user admin --password adminadmin
--host remotehost --port 6202 --remote domain1
domain1ドメインを停止します。
終了ステータス
0 コマンド実行成功
1 コマンド実行失敗
関連事項
start-domain(1) list-domains(1)