2.6.21　start-instance

書式

asadmin [asadmin-options] start-instance [--help]
    [--debug={false|true}] [--sync={normal|full|none}] instance-name

格納先

Application Serverインストールディレクトリー/javaee/glassfish/bin

機能

start-instanceサブコマンドは、サーバインスタンスを起動します。ドメイン管理サーバにアクセスできる任意のマシンから、このサブコマンドを実行できます。このサブコマンドは、任意のサーバインスタンスを起動できます。インスタンスが作成された方法は関係ありません。

このサブコマンドはリモートモードだけサポートします。

ノードルートディレクトリー/ノード名/Java EEサーバ名/configに出力される次のファイルは、ログ識別子をデフォルトから変更した場合やstart-instanceコマンドに"--sync=full"オプションを指定した場合、Java EEサーバ再起動のときに削除されます。必要に応じてこのサブコマンドの実行前に退避しておいてください。

• サーバインスタンスのスレッドダンプログ（デフォルトのログ識別子 "javacore"）

• メモリーダンプ（デフォルトのログ識別子 "core"、".core"、"*.dmp"）

• エラーリポートファイル（デフォルトのログ識別子 "hs_err_pid"）

• コンパイラーリプレイファイル（デフォルトのログ識別子 "replay_pid"）

なお、このサブコマンドには、起動のタイムアウトがあります。ドメイン管理サーバのリクエストタイムアウトが発生した場合、起動処理は継続します。起動のタイムアウトまたはasadminリードタイムアウトが発生した場合、サブコマンドの実行は失敗しますが、起動処理は継続します。起動に成功したかどうかは、KDKD20031-IのログまたはGUIのサーバインスタンスの状態により確認できます。

前提条件

インスタンスが存在するリモートのノードがリモート通信に対して有効になっている必要があります。

ドメイン管理サーバは、稼働状態である必要があります。

引数

--help | -?

このサブコマンドのヘルプテキストを表示します。

--debug={false|true}

Java Platform Debugger Architecture（JPDA）デバッグを有効にしてインスタンスを起動するかどうかを指定します。

型：Boolean

指定できる値を次に示します。

• true

  JPDAデバッグを有効にしてインスタンスを起動し、JPDAデバッグのポート番号を表示します。

• false

  JPDAデバッグを無効にしてインスタンスを起動します。

デフォルト値：false

--sync={normal|full|none}

インスタンス起動時のドメイン管理サーバとインスタンスのファイル間の同期のタイプを指定します。

型：String

指定できる値を次に示します。

• none

  ドメイン管理サーバはインスタンスのファイルと変更を同期しません。このタイプの同期では、インスタンスを起動するのに必要な時間が最小限に抑えられます。

• normal

  ドメイン管理サーバは次のようにインスタンスと最後の同期以降の変更を同期します。

  configディレクトリーの場合、ドメイン管理サーバはインスタンスとすべての変更を同期します。

  applicationsディレクトリーおよびdocrootディレクトリーの場合、最上位のサブディレクトリーに対する変更があった場合だけ、ドメイン管理サーバはそのサブディレクトリー下のすべてのファイルを同期します。

  最上位のサブディレクトリー内のファイルには変更がなく、その最上位サブディレクトリーの下のファイルに変更があった場合、完全な同期が必要です。通常の操作では、これらのディレクトリーの最上位のサブディレクトリーの下のファイルは変更されません。アプリケーションのデプロイ後にアンデプロイする場合、変更に合わせてインスタンスを更新するための完全な同期は不要です。

• full

  ドメイン管理サーバは、インスタンスとすべてのインスタンスファイルを同期します。最後の同期以降ファイルが変更されているかどうかは関係ありません。このタイプの同期では、ドメイン管理サーバがインスタンスのディレクトリー内のすべてのファイルを更新している間、インスタンスの起動が遅くなることがあります。

デフォルト値：normal

instance-name

起動するサーバインスタンスの名称を指定します。

型：String

指定できる値を次に示します。

• サーバインスタンス名

デフォルト値：なし

asadmin start-instance pmdsa1

戻り値

戻り値	説明
0	サブコマンドの実行に成功しました。
1	サブコマンドの実行中にエラーが発生しました。