付録N.8　オートスケール連携スクリプト

(1)　ファイル構成

オートスケール連携スクリプトは，マネージャーまたはエージェントで実行する「スクリプトファイル」，スクリプトの実行に必要な変数を定義した「スクリプト定義ファイル」，スクリプトが内部処理で使用する「内部ファイル」で構成されます。

なお，スクリプトファイルは，Windowsの場合PowerShellスクリプト，Linuxの場合シェルスクリプトです。

表N‒3　スクリプトファイル

スクリプトファイル名	適用ホスト	説明
Windowsの場合 jbsas_setup_agent.ps1 jbsas_setup_agent.ps1.model Linuxの場合 jbsas_setup_agent.sh jbsas_setup_agent.sh.model	エージェント	スケールアウト時にエージェントホストで実行するスクリプトとそのモデルファイルです。エージェントの初期セットアップを実施して，マネージャーにJP1イベントでスケールアウトを通知します。
Windowsの場合 jbsas_add_agent.ps1 jbsas_add_agent.ps1.model Linuxの場合 jbsas_add_agent.sh jbsas_add_agent.sh.model	マネージャー	スケールアウト時にマネージャーホストで実行するスクリプトとそのモデルファイルです。追加されたホストをマネージャーの監視対象に追加します。
Windowsの場合 jbsas_del_agent.ps1 jbsas_del_agent.ps1.model Linuxの場合 jbsas_del_agent.sh jbsas_del_agent.sh.model	マネージャー	スケールイン時にマネージャーホストで実行するスクリプトとそのモデルファイルです。削除されたホストを，マネージャーの監視対象から削除します。

表N‒4　スクリプト定義ファイル

定義ファイル名	適用ホスト	説明
jbsas_setup_agent.ini jbsas_setup_agent.ini.model	エージェント	エージェントホストが実行するスクリプトファイル（jbsas_setup_agent）が使用するシェル変数を定義したファイルとそのモデルファイルです。
jbsas_setup_manager.ini jbsas_setup_manager.ini.model	マネージャー	マネージャーホストが実行するスクリプトファイル（jbsas_add_agentまたはjbsas_del_agent）が使用するシェル変数を定義したファイルとそのモデルファイルです。

表N‒5　内部ファイル

ファイル名	適用ホスト	説明
Windowsの場合 jbsas_util.ps1 jbsas_util.ps1.model Linuxの場合 jbsas_util.sh jbsas_util.sh.model	共通（マネージャーおよびエージェント）	スクリプトファイルが内部処理で使用する関数をまとめたファイルとそのモデルファイルです。
jbsas_hosts	マネージャー	監視中のエージェントホストの情報を管理するためのファイルです。

ページの先頭へ

(2)　格納先ディレクトリ

オートスケール連携スクリプトのファイルはすべて次のディレクトリに格納されます。

Windowsの場合

インストール先フォルダ\tools\cloud\

Linuxの場合

/opt/jp1base/tools/cloud/

ページの先頭へ

(3)　スクリプトファイル

スクリプトファイルの処理内容については，「付録N.3　スケールアウト時に監視対象に追加する」および「付録N.4　スケールイン時に監視を解除する」を参照してください。

スクリプトファイルは編集する必要はありません。任意にカスタマイズすることもできますが，追加・変更した処理部分に関しては，サポートサービスの対象外となるため注意してください。

JP1/Base 11-00から上書きインストールした場合，スクリプトファイル（jbsas_add_agent.ps1など）は上書きされません。モデルファイル（jbsas_add_agent.ps1.modelなど）をスクリプトファイル名でコピーして置き換えて使用してください。

ページの先頭へ

(4)　スクリプト定義ファイル

形式

変数名1=変数値1
[変数名2=変数値2]
：

記述内容

• 変数名，変数値，および「=」の前後にスペースおよびタブを入れないでください。

• Linuxの場合，変数値に空白を含む場合は「"」で囲んでください。

定義の反映時期

スクリプトファイル実行時に読み込まれます。

設定パラメーター

jbsas_setup_agent.iniファイルおよびjbsas_setup_manager.iniファイルで設定するパラメーターについて，次の表に示します。

表N‒6　jbsas_setup_agent.iniファイルの設定パラメーター

変数名	変数値（既定値）	設定要否	説明
ManagerHostName	Manager	○	マネージャーホスト名を指定します。 ホスト名に使用できる文字および文字数については，関連製品（JP1/IMまたはJP1/PFM）のマニュアルを参照してください。
JP1EventID	1011	△	マネージャーに送信するJP1イベントのイベントIDを指定します。 指定できる範囲は，0〜1FFF，7FFF8000〜7FFFFFFFです。
JP1EventMsg	Windowsの場合 Agent host ($AgentHostName) has scale-out. Linuxの場合 "Agent host ($AgentHostName) has scale-out."	△	マネージャーに送信するJP1イベントのメッセージを指定します。 メッセージは，1,023バイト以内の文字列で指定してください。 既定値の$AgentHostNameにはエージェントホスト名が出力されます。

（凡例）

○：設定が必須のパラメーター

△：必要に応じて設定を変更するパラメーター

表N‒7　jbsas_setup_manager.iniファイルの設定パラメーター

変数名	変数値（既定値）	設定要否	説明
JbsrtDistribByScaleIn	NO	△	スケールイン時に構成定義情報を更新するかどうかを指定します。 YESを指定した場合 構成定義ファイルから対象ホストを削除して，構成定義を配布します。対象ホストはすぐに構成定義情報の下位ホストから削除されます。 なお，通信の遅延によって監視が大幅に遅れるおそれがあるため，運用上の特別な理由がないかぎり，YESは指定しないでください。YESを指定する場合は，目安としてスケールインの対象となるホスト数が1時間当たり20台以下になるよう運用してください。 NOを指定した場合 処理性能を優先した指定です。構成定義ファイルから対象ホストを削除して，構成定義は配布しません。次回スケールアウト時に構成定義情報が更新されます。
JP1PFMAgentAlarmTableList_W	"PFM Windows Template Alarms [CPU] 09.00","PFM Windows Template Alarms [MEM] 09.00","PFM Windows Template Alarms [DSK] 09.00"	△	エージェントにバインドするWindows用のアラームテーブル名です。 複数指定する場合は，コンマ区切りで指定してください。
JP1PFMAgentAlarmTableList_L	"PFM UNIX Template Alarms [CPU] 09.00","PFM UNIX Template Alarms [MEM] 09.00","PFM UNIX Template Alarms [DSK] 09.00"	△	エージェントにバインドするLinux用のアラームテーブル名です。 複数指定する場合は，コンマ区切りで指定してください。
EC2_HOMEPath※	指定なし	○	Amazon EC2 API Toolsのインストール先パスを指定します。
JAVA_HOMEPath※	指定なし	○	Java（JRE）のインストール先パスを指定します。
EC2_URL※	指定なし	○	AWSのリージョンのURLを指定します。
AWS_ACCESS_KEY※	指定なし	○	AWSのアクセスキー文字列を指定します。
AWS_SECRET_KEY※	指定なし	○	AWSのシークレットアクセスキー文字列を指定します。

（凡例）

○：設定が必須のパラメーター

△：必要に応じて設定を変更するパラメーター

注※　Amazon EC2 API Toolsのツール実行環境の設定に必要な環境変数です。設定値の詳細については，Amazon Web Servicesの公式サイトを参照してください。

ページの先頭へ