jaompwgrp(UNIX限定)
形式
jaompwgrp
機能
jaompwgrpコマンドは,グループ化されたエージェントホストを起動・終了するコマンドです。このコマンドを実行するには,JP1/Power Monitorデーモンが起動していることが必要です。
このコマンドは,自動運転ユーザーコマンドの自動運転開始時コマンド,電源投入時刻到達時コマンド,および自動システム終了前コマンドとして構成定義ファイルに設定します。このコマンドをコマンドラインから実行した場合,エラーになります。
実行権限
−(コマンドラインからは実行できません)
格納先ディレクトリ
/usr/bin/jp1_aom/
注意事項
-
JP1/Power Monitorデーモンが起動していない場合にこのコマンドを実行すると,エラーになります。
-
このコマンドは,グループに登録されているすべてのエージェントホストに対する処理が終わるまで終了しません。
-
jaompwgrpコマンドを自動運転ユーザーコマンドとして設定する場合,構成定義ファイルのコマンド実行打ち切り時間(rc_cancel_timeパラメーター)を指定しないでください。
-
jaompwgrpコマンドのほかに,自動運転ユーザーコマンドを設定している場合は,自動運転ユーザーコマンドのスクリプトにjaompwgrpコマンドを追加してください。追加する場合,パラメーター変数「$1」を引数として指定してください。jaompwgrpコマンドを追加する例を次に示します。
/usr/bin/jp1_aom/jaompwgrp $1
-
マネージャーホストの起動時にグループ化したエージェントホストを連動する設定をしている場合,マネージャーホストを手動または自動で起動すると,グループ化したエージェントホストは連動して起動します。
なお,グループ化したエージェントホストを起動する場合は,マネージャーホストから電源をオンにできる電源制御装置を,グループ化したエージェントホストに接続している必要があります。
-
マネージャーホストの終了時にグループ化したエージェントホストを連動する設定をしている場合,マネージャーホストを監視終了すると,グループ化したエージェントホストが連動して終了します。
そのため,マネージャーホストの終了後の処理としてシャットダウン,電源オフまたは再起動する場合,グループ化したすべてのエージェントホストは連動して電源オフします。また,マネージャーホストの終了時および起動時にグループ化したエージェントホストを連動する設定をしている場合は,マネージャーホストを再起動すると,エージェントホストはマネージャーホストの終了に連動して電源オフしたあと,マネージャーホストの起動に連動して起動します。
-
マネージャーホストを再起動する,または終了してから起動するまでの間隔が短い場合は,グループ化したエージェントホストの起動を実行できないことがあります。原因としては,エージェントホストの終了に長時間要していることや接続している電源制御装置のシャットダウン猶予時間が長いことが考えられます。
このような環境でグループ化する場合は,マネージャーホストを再起動しないで,マネージャーホストが終了したあとで十分な時間(グループ化するすべてのエージェントホストがシャットダウン完了する時間や,電源制御装置に設定している猶予時間以上の時間)をとってから起動するように設定してください。なお,電源制御装置のシャットダウン猶予時間については,電源制御装置のマニュアルを参照するか,または電源制御装置側へお問い合わせください。
戻り値
0 |
コマンドが正常終了しました。 |
0以外 |
エラーが発生しました。 |
使用例
- (例1)
-
マネージャーホストの起動時だけ,グループ化したエージェントホストを連動させたい場合,構成定義ファイルに次のように定義します。
aom_start_rc /usr/bin/jp1_aom/jaompwgrp
- (例2)
-
マネージャーホストの終了時だけ,グループ化したエージェントホストを連動させたい場合,構成定義ファイルに次のように定義します。
power_on_time_rc /usr/bin/jp1_aom/jaompwgrp system_terminate_rc /usr/bin/jp1_aom/jaompwgrp
- (例3)
-
マネージャーホストの起動・終了に連動してグループ化したエージェントホストを起動・終了させたい場合,構成定義ファイルに次のように定義します。
aom_start_rc /usr/bin/jp1_aom/jaompwgrp power_on_time_rc /usr/bin/jp1_aom/jaompwgrp system_terminate_rc /usr/bin/jp1_aom/jaompwgrp