構成ジョブでの変数の使用
構成ジョブとは、1つまたは複数の管理対象インスタンスで実行できる構成コマンドのセットです。複数のインスタンスで同じ構成を実行する場合、構成で使用されるパラメータに異なる値を使用したい場合があります。これらのパラメータに異なる値を割り当てたり、複数のインスタンスでジョブを実行したりできる変数を定義できます。
たとえば、負荷分散仮想サーバーを追加し、2つのサービスを追加し、そのサービスを仮想サーバーにバインドする基本的な負荷分散構成を考えてみましょう。この場合、2つのインスタンスで同じ構成を持ちながら、仮想サーバーとサービスの名前およびIPアドレスに異なる値を使用したい場合があります。構成ジョブ機能を使用すると、変数を使用して仮想サーバーとサービスの名前およびIPアドレスを定義することで、これを実現できます。
この例では、次のコマンドと変数が使用されます。
add lb vserver <servername> HTTP <ipaddress> <portnumber>
add service <servicename1> <ipaddress1> HTTP 80
add service <servicename2> <ipaddress2> HTTP 80
bind lb vserver <servername> <servicename1>
bind lb vserver <servername> <servicename2>
NetScaler® ADM で変数を定義して構成ジョブを作成するには:
-
Infrastructure > Configuration Jobs に移動します。
-
[Create Job] をクリックします。
-
[Create Job] ページで、ジョブ名、インスタンスタイプ、構成タイプなどのカスタムジョブパラメータを選択します。
-
構成エディタで、負荷分散仮想サーバー、2つのサービスを追加し、そのサービスを仮想サーバーにバインドするコマンドを入力します。変数に変換する値をダブルクリックして選択し、[Convert to Variable] をクリックします。たとえば、次の図に示すように、負荷分散サーバーのIPアドレス
*ipaddress*を選択し、[Convert to Variable] をクリックします。
-
変数の値がドル記号で囲まれていることを確認したら、変数をクリックして、名前、表示名、タイプなどの変数の詳細を指定します。変数のデフォルト値をさらに指定する場合は、[Advanced] オプションをクリックすることもできます。[Save] をクリックし、次に [Next] をクリックします。
残りのコマンドを入力し、すべての変数を定義します。
-
構成ジョブの作成中または編集中に定義したすべての変数を、統合ビューで確認できます。
-
統合ビューですべての変数を確認するには、次のいずれかを実行します。
-
構成ジョブの作成中に、Infrastructure > Configuration Jobs に移動し、[Create Job] を選択します。[ジョブの作成] ページで、構成ジョブの作成中に追加したすべての変数を確認できます。
-
構成ジョブの編集中に、Network > Configuration Jobs に移動し、ジョブ名を選択して [Edit] をクリックします。[ジョブの構成] ページで、構成ジョブの作成中に追加されたすべての変数を確認できます。
-
-
次に、[Preview Variables] タブをクリックして、構成ジョブの作成中または編集中に定義した変数を統合ビューでプレビューできます。
-
新しいポップアップウィンドウが表示され、名前、表示名、タイプ、デフォルト値など、変数のすべてのパラメータが表形式で表示されます。これらのパラメータを編集および変更することもできます。いずれかのパラメータを編集または変更した後、[Done] ボタンをクリックします。
-
次に、構成エディタでコマンドを必要に応じて並べ替え、順序を変更できます。コマンド行をドラッグアンドドロップして、ある行から別の行にコマンドを移動できます。テキストボックスのコマンド行番号を変更するだけで、コマンド行をある行から任意のターゲット行に移動または並べ替えることもできます。
-
構成ジョブを実行するインスタンスを選択します。
-
[Specify Variable Values] タブで、[Upload input file for variable values] オプションを選択し、[Download Input Key File] をクリックします。この例では、各インスタンスでサーバー名、サーバーとサービスのIPアドレス、ポート番号、およびサービス名を指定する必要があります。ファイルを保存してアップロードします。値が正確に定義されていない場合、システムはエラーをスローする可能性があります。
-
入力キーファイルがローカルシステムにダウンロードされ、以前に選択した各NetScalerインスタンスの変数を指定して編集できます。[Upload] をクリックして入力キーファイルをNetScaler ADMにアップロードします。[Next] をクリックします。
注
入力キーファイルでは、変数は次の3つのレベルで定義されます。
- グローバルレベル
- インスタンスグループレベル
- インスタンスレベル
グローバル変数は、すべてのインスタンスに適用される変数値です。インスタンスグループレベルの変数値は、グループで定義されているすべてのインスタンスに適用されます。インスタンスレベルの変数値は、特定のインスタンスにのみ適用されます。
NetScaler ADMはインスタンスレベルの値を最優先します。個々のインスタンスの変数に値が指定されていない場合、NetScaler ADMはグループレベルで指定された値を使用します。グループレベルで値が指定されていない場合、NetScaler ADMはグローバルレベルで指定された変数値を使用します。3つのすべてのレベルで変数に入力を指定した場合、NetScaler ADMはインスタンスレベルの値をデフォルト値として使用します。
-
[Upload] をクリックして入力キーファイルをNetScaler ADMにアップロードします。[Next] をクリックします。
重要
MacからCSVファイルをアップロードすると、MacはCSVファイルをカンマではなくセミコロンで保存します。これにより、入力ファイルをアップロードしてジョブを実行すると、構成が失敗します。Macを使用している場合は、テキストエディタを使用して必要な変更を行い、ファイルをアップロードしてください。
-
すべてのインスタンスで共通の変数を指定し、[Upload] をクリックして入力キーファイルをNetScaler ADMにアップロードすることもできます。
変数値を含むキー入力ファイルは、構成ジョブに（同じファイル名で）永続化されます。構成ジョブの作成中または編集中に以前に使用およびアップロードしたこれらの入力ファイルを表示および編集できます。
構成ジョブの作成中に実行構成ジョブを表示するには、Network > Configuration Jobs に移動し、[Create Job] をクリックします。[ジョブの作成] ページで、[Specify Variable Values] タブの [Common Variable Values for all Instances] オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、編集してファイルをアップロードします（同じファイル名を維持します）。
構成ジョブの編集中にすでに実行された構成ジョブを表示するには、Network > Configuration Jobs に移動し、ジョブ名を選択して [Edit] をクリックします。[ジョブの構成] ページで、[Specify Variable Values] タブの [Common Variable Values for all Instances] オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、編集してファイルをアップロードします（同じファイル名を維持します）。
-
[Job Preview] タブで、各インスタンスまたはインスタンスグループで実行するコマンドを評価および検証できます。
-
[Execute] タブで、ジョブを今すぐ実行するか、後で実行するようにスケジュールするかを選択できます。コマンドが失敗した場合にNetScaler ADMが実行する必要があるアクションと、ジョブの成功または失敗に関する電子メール通知を他の詳細とともに送信するかどうかも選択できます。
ジョブを構成して実行した後、Infrastructure > Configuration Jobs に移動し、構成したばかりのジョブを選択することで、ジョブの詳細を確認できます。[Details] をクリックし、次に [Variable Details] をクリックして、ジョブに追加された変数のリストを表示します。
注
ステップ5で変数に指定した値は、ジョブを保存して終了したとき、または後で実行するようにジョブをスケジュールしたときに、NetScaler ADMによって保持されます。