Cosminexus アプリケーションサーバ V8 リファレンス コマンド編
cmx_start_target(Webシステムまたはサービスユニットの開始)
形式
- Webシステムを開始する場合
cmx_start_target [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -mode { ALL|READY } [-strict]
- Webシステムに関連づいていない論理サーバを含むシステムを開始する場合
cmx_start_target [共通引数] -ns
機能
システムの開始をします。Webシステムを開始する場合と,Webシステムに関連づいていない論理サーバを含むシステムを開始する場合で動作が異なります。それぞれの場合の動作について説明します。
- Webシステムを開始する場合
指定されたモードに応じて,開始対象のサービスユニットの状態を稼働状態または準備状態にします。稼働状態とは,サービスユニット中の全論理サーバが稼働中で負荷分散機からリクエストが振り分けられる状態です。準備状態とは,サービスユニット中の全論理サーバが稼働中で,負荷分散機からのリクエスト振り分けが抑止されている状態です。
コマンドのオプションで,サービスユニットが指定されていれば特定のサービスユニットが,省略されていればWebシステム中の全サービスユニットが,開始の対象となります。
サービスユニットの状態は,cmx_list_statusコマンドで参照できます。サービスユニットの状態の種類,およびサービスユニットの状態の参照方法については,「cmx_list_status」を参照してください。
- Webシステムに関連づいていない論理サーバを含むシステムを開始する場合
開始対象のシステムに含まれるすべての論理サーバを起動して,稼働状態にします。すでに稼働中の論理サーバは,引き続き稼働状態が保たれ,この操作によって再起動されることはありません。
運用管理ポータルで論理サーバの起動順序を設定している場合は,その順序に従って起動されます。
Webシステムに関連づいていない論理サーバの状態は,cmx_list_statusコマンドに-nsオプションを指定することで参照できます。論理サーバの状態の種類,および論理サーバの状態の参照方法については,「cmx_list_status」を参照してください。
引数
- -s <Webシステム名>
- Webシステム名を指定します。
- このオプションを省略した場合は,.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお,.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に,このオプションを省略してコマンドを実行したときは,エラーになります。
- -unit <サービスユニット名>
- サービスユニット名を指定します。
- -mode { ALL|READY }
- 開始モードを指定します。
- ALL
停止状態,閉塞状態,準備状態を稼働状態に引き上げます。
- READY
停止状態,閉塞状態を準備状態に引き上げます。
稼働状態のサービスユニットを準備状態に引き下げることはできません。
- -strict
- 論理サーバの起動に失敗した場合に,以降の論理サーバの起動を中断するときに指定します。
- このオプションを省略してコマンドを実行した場合,論理サーバの起動に失敗したとき,以降の論理サーバの起動を継続します。
- 論理サーバの起動に失敗した場合に,以降の論理サーバの起動を継続するか,中断するかの選択については,マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」のサービスユニットの起動の説明を参照してください。
- -ns
- Webシステムに関連づいていない論理サーバを含むシステムを起動する場合に指定します。
入力例
cmx_start_target -s sample-system -unit unit1 -mode ALL
戻り値
- 0:
- 正常終了しました。
- 1:
- 警告終了しました。
- 64:
- 異常終了しました。
戻り値の詳細を次の表に示します。
戻り値 |
サービスユニットが一つの場合 |
サービスユニットが複数の場合 |
0 |
すべての論理サーバの起動に成功しました。 |
すべてのサービスユニットの起動に成功※1しました。 |
1 |
− |
一部のサービスユニットの起動に失敗※2しました。 |
64 |
一部の論理サーバの起動に失敗しました。 |
すべてのサービスユニットの起動に失敗※2しました。 |
(凡例) −:なし。
注※1 サービスユニットの起動成功とは,サービスユニット中のすべての論理サーバの起動に成功したことです。
注※2 サービスユニットの起動失敗とは,サービスユニット中の一部の論理サーバの起動に失敗したことです。
注意事項
- -unitオプションでメモリセッションフェイルオーバ用,CTM用または統合ネーミングスケジューラサーバ用のサービスユニットを指定する場合,-modeオプションにREADYを指定したときはエラーになります。-unitオプションを省略している場合に,-modeオプションにREADYを指定した場合,Webシステムに属するメモリセッションフェイルオーバ用,CTM用および統合ネーミングスケジューラサーバ用のサービスユニットの状態は,稼働状態に引き上げられます。
- 開始対象のサービスユニットに含まれている論理ユーザサーバは,-modeオプションの指定に関係なく,起動されます。開始対象のサービスユニットに論理ユーザサーバが含まれている場合に,論理ユーザサーバの起動に失敗したときは,サービスユニットの開始も失敗したとみなされます。この場合,-unitオプションを指定したコマンドは異常終了し,-unitオプションを省略したコマンドは警告終了します。
- 複数のJ2EEサーバを配置したCTM用のサービスユニットを起動する場合,一部のJ2EEサーバで起動処理を失敗しても,すべてのJ2EEサーバに対して起動処理を実行します。この場合,コマンドは異常終了します。
All Rights Reserved. Copyright (C) 2008, 2010, Hitachi, Ltd.