12.1.3 コマンドの使用について

ここでは,コマンドを使用するときの注意点について説明します。

<この項の構成>
(1) コマンドを同時に複数実行した場合の動作
(2) 注意事項

(1) コマンドを同時に複数実行した場合の動作

Smart Composer機能のコマンドを同時に複数実行した場合,コマンドによっては,あとから実行したコマンドが排他制御されるものと,排他制御されないものがあります。

Smart Composer機能のコマンドについて,排他制御の対象となるかどうかを次の表に示します。

表12-1 排他制御の対象/対象外のコマンド

コマンドの種類コマンド名排他制御の対象
Webシステム全体に対するコマンドcmx_add_serverref
cmx_build_model
cmx_change_model
cmx_delete_serverref
cmx_register_application
cmx_register_resource
cmx_scaleout_host
cmx_unregister_application
cmx_unregister_resource
Webシステムに対するコマンドcmx_admin_passwd×
cmx_build_system
cmx_define_application
cmx_define_resource
cmx_delete_system
cmx_deploy_application
cmx_deploy_resource
cmx_export_model×
cmx_list_model×
cmx_list_status×
cmx_resume_lb
cmx_start_application
cmx_start_resource
cmx_start_target
cmx_stop_application
cmx_stop_resource
cmx_stop_target
cmx_test_lb
cmx_trans_param×
cmx_undefine_application
cmx_undefine_resource
cmx_undeploy_application
cmx_undeploy_resource
(凡例)
○:排他制御の対象です。これらのコマンドは,「12.3 コマンドの詳細」の共通引数にある,-wait/-nowaitオプションが指定できるコマンドです。
×:排他制御の対象外です。実行中のコマンドがある場合でも実行できます。

排他制御の対象となるコマンドでは,コマンドの共通引数の-wait/-nowaitオプションの指定によって,複数のコマンドを同時に実行したときの動作が変わります。また,コマンドの種類や,どのWebシステムを対象としてコマンドを実行するかの組み合わせで,排他制御される場合とされない場合があります。

次の表に,複数のコマンドを同時に実行したときの排他制御のルールを示します。なお,表中の「Webシステム全体に対するコマンド」および「Webシステムに対するコマンド」に分類されるコマンドの種類については,表12-1を参照してください。

表12-2 排他制御のルール

あとから実行するコマンド実行中のコマンド
コマンドの種類対象となるシステム共通引数の指定コマンドの種類
Webシステム全体に対するコマンドWebシステムに対するコマンド
Webシステム全体に対するコマンド-wait
-nowait××
Webシステムに対するコマンド同じWebシステム-wait
-nowait××
異なるWebシステム-wait
-nowait×
(凡例)
×:あとから実行するコマンドは排他エラーが返ります。
△:あとから実行するコマンドは実行中のコマンドが終了するまで待ちます。
○:あとから実行するコマンドを実行します。
-:該当しません。

(2) 注意事項