Cosminexus アプリケーションサーバ V8 リファレンス コマンド編
cmx_build_system(Webシステムの構築)
形式
- Webシステムの構築
- 簡易構築定義ファイルからWebシステムを構築する場合
cmx_build_system [共通引数] -f <簡易構築定義ファイル>
[-lb {keepvs|deletevs}]
- 登録済みの情報モデルを基にWebシステムを構築する場合
cmx_build_system [共通引数] [-s <Webシステム名>]
[-lb {keepvs|deletevs}]
- Webシステムに関連づいていない論理サーバを含むシステムを構築する場合
cmx_build_system [共通引数] -ns
- 構築済みのシステムのパラメタ変更
- 構築済みのシステムのパラメタを簡易構築定義ファイルで変更する場合
cmx_build_system [共通引数] -f <簡易構築定義ファイル> -change
機能
Webシステムを構築します。また,構築済みのシステムのパラメタを変更します。
- Webシステムの構築
登録済みのWebシステムの情報モデルに従って,Webシステムを構築します。または,簡易構築定義ファイルの内容に従って,Webシステムの情報モデルを生成し,その情報モデルに従ってWebシステムを構築します。
cmx_build_systemコマンドは,各ホストのWebサーバとJ2EEサーバのセットアップ,および各論理サーバの環境を設定します。また,必要に応じて負荷分散機に仮想サーバや実サーバを作成します。
登録済みの情報モデルを基にWebシステムを構築する場合,簡易構築定義ファイルからWebシステムを構築する場合,またはWebシステムに関連づいていない論理サーバを含むシステムを構築する場合で,構築のしかたが異なります。
- 簡易構築定義ファイルからWebシステムを構築する場合
指定した簡易構築定義ファイルの内容に従って,Webシステムの情報モデルを構築します。さらに,その情報モデルに従って,Webシステムを構築します。あらかじめcmx_build_modelでモデルを登録しないで,Webシステムの構築ができます。
- 登録済みの情報モデルを基にWebシステムを構築する場合
cmx_build_modelコマンド,またはcmx_change_modelコマンドで登録したWebシステムの情報モデルに従って,Webシステムを構築します。
- Webシステムに関連づいていない論理サーバを含むシステムを構築する場合
cmx_build_modelコマンド,またはcmx_change_modelコマンドで登録したWebシステムの情報モデルに従って,Webシステムに関連づいていない論理サーバを含むシステムを構築します。
- 構築済みのシステムのパラメタ変更
-changeオプションを指定することで,構築済みのシステムのパラメタを,-fオプションで指定した簡易構築定義ファイルに定義されたパラメタに変更します。
- -changeオプションを指定して構築済みのシステムのパラメタを変更する場合
-fオプションにパラメタ変更済みの簡易構築定義ファイルを指定して,-changeオプションを指定します。-fオプションで指定した簡易構築定義ファイルの内容に従って,Webシステムの情報モデルを,パラメタを変更した状態で再生成します。さらに,その情報モデルを基にして,Webシステムを再構築します。ただし,構成変更はできません。
Webシステムの構築時に,論理サーバ名を簡易構築定義ファイルで定義していない場合,Management Server上に論理サーバ名が定義されます。なお,登録済みの情報モデルに従ってWebシステムを構築する場合,論理サーバ名はcmx_build_modelコマンド実行時に定義されます。Management Server上に論理サーバ名が定義されるときのルールを次に示します。
- 論理サーバ名の定義ルール
- 論理サーバ名は次の形式で定義されます。
- 形式
cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>
- <種別>は,論理サーバの種類によって異なります。論理サーバの種類と<種別>との対応を次の表に示します。
表8-10 論理サーバの種類と<種別>との対応
論理サーバの種類 |
<種別> |
論理Webサーバ |
HTTP |
論理J2EEサーバ |
J2EE |
論理パフォーマンストレーサ |
PRF |
論理SFOサーバ |
SFO |
論理CTMドメインマネジャ |
CTMDM |
論理CTM |
CTM |
論理スマートエージェント |
SA |
論理ユーザサーバ |
USER |
- <通番>は,基本的に「01」が設定されます。ただし,CTMを使用するシステムのように論理サーバを複数配置する場合は,重複しない番号が割り振られます。
引数
- -s <Webシステム名>
- Webシステム名を指定します。
- 登録済みの情報モデルから,指定したWebシステムが構築されます。
- このオプションを省略した場合は,.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお,.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に,このオプションを省略してコマンドを実行したときは,エラーになります。
- -fオプションを指定している場合には指定が無効になります。
- -lb
- この引数は使用する負荷分散機の種類がBIG-IPv9の場合だけ有効になります。
- 負荷分散機の仮想サーバを初期化するかどうかを指定します。JP1/SC/DPMを使用しないで,ホスト単位管理モデルで構築した負荷分散機を使用するWebシステムをスケールアウトする場合に指定します。
- keepvs
負荷分散機の仮想サーバは初期化しません。複数のホストで負荷分散機の仮想サーバを共有する場合に指定します。
- deletevs
負荷分散機の仮想サーバを初期化します。
- このオプションを省略した場合は,.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.lbキーで設定した値が仮定されます。なお,.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.lbキーを省略している場合に,このオプションを省略したときはdeletevsが仮定されます。.cmxrcファイルおよびcmxclient.propertiesファイルの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の.cmxrc(クライアント設定プロパティファイル)およびcmxclient.properties(クライアント共通設定プロパティファイル)の説明を参照してください。
- -f <簡易構築定義ファイル>
- 簡易構築定義ファイルのパスを指定します。
- 簡易構築定義ファイルの内容に従って,Webシステムの情報モデルが生成されます。さらに,その情報モデルを基にしてWebシステムが構築されます。
- -change
- パラメタを変更する場合に指定します。
- -fオプションで指定した簡易構築定義ファイルの内容に従って,Webシステムの情報モデルが再生成されます。さらに,その情報モデルを基にしてWebシステムが再構築されます。
- -ns
- 登録済みの情報モデルから,Webシステムに関連づいていない論理サーバを含むシステムを構築する場合に指定します。
- このオプションを指定する場合,cmx_build_modelコマンドを使用して,情報モデルを登録しておく必要があります。cmx_build_modelコマンドについては,「cmx_build_model」を参照してください。
入力例
- 簡易構築定義ファイルからWebシステムを構築する場合
cmx_build_system -f MyWebSystemDef.xml
- 登録済みの情報モデルを基にWebシステムを構築する場合
cmx_build_system -s sample-system
- Webシステムに関連づいていない論理サーバを含むシステムを構築する場合
cmx_build_system -ns
- 構築済みのシステムのパラメタを簡易構築定義ファイルで変更する場合
cmx_build_system -f MyWebSystemDef2.xml -change
戻り値
- 0:
- 正常終了しました。
- 1:
- 警告終了しました。
- 64:
- 異常終了しました。
注意事項
-changeオプションを指定する場合,次のことに注意してください。
- 構築済みのWebシステムに対してパラメタ変更以外の変更をしようとした場合はエラーになります。
- -fオプションで指定した簡易構築定義ファイルのスキーマのバージョンが,構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンより古いときは,動作が保証されません。
- 構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンが2.1以前の場合,-fオプションで指定する簡易構築定義ファイルのホストの定義の<host-ref>タグは次のように指定します。
- <host-ref>タグに指定する値
- 構築済みのシステムの構築時に使用した簡易構築定義ファイルのホストの定義の<operational-ip>タグで指定している値
All Rights Reserved. Copyright (C) 2008, 2010, Hitachi, Ltd.