startServer コマンドは、指定されたアプリケーション・サーバーの構成ファイルを読み取り、そのサーバーを始動します。
Windows プラットフォームを使用していて、アプリケーション・サーバーを Windows サービスとして実行している場合は、
startServer コマンドは、関連した Windows サービスを開始し、
アプリケーション・サーバーの開始も行います。
startServer コマンドはサーバー処理を起動しますが、MBean メソッドを呼び出さないため、このコマンドでユーザー名およびパスワードを使用する必要はありません。
このコマンドをどこで実行するかについて詳しくは、コマンド行ツールの使用の項目を参照してください。
構文
コマンド構文は次のようになります。
startServer <server> [options]
ここで、
server は、開始するアプリケーション・サーバーの名前になります。
この引数は必須です。
パラメーター
startServer コマンドで使用可能なオプションは、以下のとおりです。
- -?
- 使用法ステートメントを印刷します。
- -help
- 使用法ステートメントを印刷します。
- -logfile <fileName>
- トレース情報を書き込むログ・ファイルのロケーションを指定します。デフォルトでは、ログ・ファイルは startServer.log という名前で、logs ディレクトリーに作成されます。
- -nowait
- startServer コマンドに対して、
立ち上げられたサーバー・プロセスが正常に初期化されるまで待たないように指示します。
- -profileName
- マルチプロファイル・システムで、アプリケーション・サーバー・プロセスのプロファイルを定義します。
-profileName オプションは、単一プロファイル環境で実行する場合は必要ありません。 このオプションのデフォルトは、
デフォルト・プロファイルです。
- -quiet
-
startServer コマンドが通常モードで印刷する進行情報を抑止します。
- -replacelog
- 現行ログに追加する代わりに、ログ・ファイルを置き換えます。
- -recovery
- サーバーがリカバリー・モードで始動し、トランザクションのリカバリーを実行し、シャットダウンすることを指定します。
サーバーは、リカバリー・モード中は新しいトランザクションを受け入れません。
サーバーを再始動する場合は、問題のあるトランザクションのために使用不可であったリソースが使用可能になります。
サーバーに障害が起こり、リカバリー・プロセス中に新しいトランザクションを受け入れたくない場合は、このオプションを使ってください。
- -statusport <portNumber>
- サーバー状況のコールバック用のポート番号を管理者が設定できるように指定します。
- -script [<script fileName>] -background
-
サーバー・プロセスを直接立ち上げる代わりに、startServer コマンドを用いて
立ち上げスクリプトを生成します。
立ち上げスクリプト名は、オプションの引数です。
立ち上げスクリプト名を指定しない場合、デフォルトのスクリプト・ファイル名は、最初の引数として startServer コマンドに渡される <server> 名に基づき、start_<server> になります。-background パラメーターは、生成したスクリプトを実行時にバックグラウンドで実行するよう指定するオプション・パラメーターです。
注: startserver.sh スクリプトは app_server_root ディレクトリーから新規プロセスを起動して、
アプリケーション・サーバーを初期化します。
start_server1.sh スクリプトは、スクリプトが配置されているディレクトリーからアプリケーション・サーバーを起動します。
このため、startserver.sh スクリプトを使用して起動したプロセスのディレクトリーは app_server_root ディレクトリーであり、start_server1.sh スクリプトを使用して起動したプロセスのディレクトリーは app_server_root/bin ディレクトリーです。
user.dir などのプロセス・ディレクトリーに依存するすべてのシステム・プロパティーは、startserver.sh および start_server1.sh スクリプトを使用して起動したプロセスでは異なる可能性があります。
- -trace
- デバッグのために、ログ・ファイルにトレース情報を生成します。
- -timeout <seconds>
- サーバーの初期化がタイムアウトになり、エラーが戻されるまでの待機時間を指定します。
使用シナリオ
以下は、正しい構文の例です。
startServer server1
startServer server1 -script (produces the start_server1.sh or .bat files)
startServer server1 -trace (produces the startserver.log file)