マスター構成テンプレートの使用

メイン構成テンプレートを使用することは、複数のNetScalerインスタンスにマスター構成を作成および展開するための柔軟なオプションです。

管理者として、NetScalerインスタンスで構成変更を行い、ライセンス、証明書、その他のファイルを保存したい場合があります。新しい構成は、マスター構成テンプレート（.confファイル）として保存できます。

NetScalerインスタンスからマスター構成テンプレートを保存するには、次のいずれかの操作を行います。

• コマンドプロンプトで「save ns config」と入力します。構成はインスタンスのFLASHメモリ内の/nsconfig/ns.confファイルに保存されます。

• インスタンスのGUIから、[Diagnostics] > [View Configuration] に移動します。保存する構成の種類を選択します。たとえば、インスタンスの保存済み構成を保存する場合は、[Saved configuration] を選択します。[Save text to a file] リンクをクリックして、ns.confファイルをローカルマシンに保存します。

ジョブの作成時に「DeployMasterConfiguration」構成テンプレートを使用してマスター構成テンプレートを展開する場合、コマンドを追加したり、既存のコマンドを変更したり、入力ファイルに異なる変数値を指定したりすることで、特定のNetScalerインスタンスごとにさらにカスタマイズできます。

たとえば、管理者として、ns.confファイルに加えて証明書キーをNetScalerインスタンスにアップロードし、それらにマスター構成を展開したい場合があります。

重要

NetScaler CPXインスタンス、クラスターで構成されたインスタンス、またはパーティション化されたNetScalerインスタンスでは、DeployMasterConfigurationテンプレートを使用して構成ジョブを実行することはできません。

NetScaler Consoleでマスター構成テンプレートを使用して構成ジョブを作成する手順:

1. NetScaler Consoleで、[Infrastructure] > [Configuration Jobs] に移動し、[Create Job] をクリックします。

2. [Create Job] ページで、[Select Configuration] タブの [Job Name] を指定し、ドロップダウンリストから [Instance Type] を選択します。

3. [Configuration Source] ドロップダウンリストから [Master Configuration] を選択します。DeployMasterConfigurationテンプレートのコマンドを右ペインにドラッグします。右ペインでコマンドを追加、変更、または削除することもできます。[Next] をクリックします。

   注

   テンプレートに入力ファイルを追加するには、put コマンドを追加できます。この例では、構成テンプレートファイルと変数入力ファイルに加えて、証明書ファイルとキーファイルをアップロードする必要があります。

   

4. 構成ジョブの作成または編集時に定義したすべての変数を、統合された単一ビューで確認できます。

5. 統合された単一ビューですべての変数を表示するには、次のいずれかの操作を行います。

   • 構成ジョブの作成中に、[Infrastructure] > [Configuration Jobs] に移動し、[Create Job] を選択します。[Create Job] ページで、構成ジョブの作成中に追加したすべての変数を確認できます。

   • 構成ジョブの編集中に、[Network] > [Configuration Jobs] に移動し、ジョブ名を選択して [Edit] をクリックします。[Configure Job] ページで、構成ジョブの作成中に追加されたすべての変数を確認できます。

6. 次に、[Preview Variables] タブをクリックして、構成ジョブの作成または編集時に定義した変数を統合された単一ビューでプレビューできます。

   

7. 新しいポップアップウィンドウが表示され、Name、Display Name、Type、デフォルト値などの変数のすべてのパラメーターが表形式で表示されます。これらのパラメーターを編集および変更することもできます。いずれかのパラメーターを編集または変更した後、[Done] ボタンをクリックします。

   

8. 構成ジョブを実行するインスタンスを選択し、[Next] をクリックします。

9. [Specify Variable Values] タブで、以下をアップロードします。

   • [構成テンプレートファイル (.conf)] - NetScalerインスタンスから抽出した.confファイルをアップロードします。

   • [入力ファイルのアップロード (.xml/csv)] - コマンドで定義した変数の値を含む入力ファイルをアップロードします。

   使用例として、サンプルXMLファイルをここに示します。XMLファイルには、使用しているNetScalerインスタンスに対応する詳細が含まれていることを確認してください。

   
   <?xml version="1.0" encoding="UTF-8" ?>
   
   <properties>
   
   <!-- 
   
   Provide inputs for all the parameters defined in the master config file.
   
   -  global. This tag contains all the common parameters and value.
   
   -  devicegroup. This tag contains all the instance group specific parameters and values.
   
   If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence over the instance group. The instance group specific parameters value will take precedence over global parameters in the execution.       
   
   -  name. This attribute represents the name of the instance group.
   
   -  device. This tag contains all the instance specific parameters and value. 
   
   If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence in the execution.
   
   -  name. This attribute represents the IP Address of the instance. Host name is not supported for the attibute.
   
   HA pair should be represented as <primaryip>-<secondaryip>. Example 10.102.2.1-10.102.2.2
   
   In the template file, the parameter name must be specified within the dollar sign,Example: $NSIP$, $CC_Trap_Dest$ and parameters names are case sensitive.
   -->
   
   <global>
   
   </global>
   <devicegroup name="BLR_DEVS">
   </devicegroup>
   <device name="10.106.101.209">
   <param name="IP" value="10.106.101.209"/>
   </device>
   
   <!-- HA PAIR-->
   <!--<device name="10.102.43.154-10.102.43.155">
   <param name="NSIP" value="10.102.43.154"/>
   <param name="HostName" value="NS43HA"/>
   <param name="LBSERVER" value="haserver43http"/>
   <param name="SNMPTrapDest" value="10.102.43.130"/>
   </device>-->
   </properties>
   
   <!--NeedCopy-->
   

10. [Next] をクリックします。

変数値を含む入力ファイルは、構成ジョブに（同じファイル名で）永続化されます。構成ジョブの作成または編集時に以前に使用およびアップロードしたこれらの入力ファイルを表示および編集できます。

構成ジョブの作成中に実行構成ジョブを表示するには、[Network] > [Configuration Jobs] に移動し、[Create Job] をクリックします。[Create Job] ページで、[Specify Variable Values] タブの [Common Variable Values for all Instances] オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、編集してから（同じファイル名を維持して）ファイルをアップロードします。

構成ジョブの編集中に既に実行された構成ジョブを表示するには、[Network] > [Configuration Jobs] に移動し、ジョブ名を選択して [Edit] をクリックします。[Configure Job] ページで、[Specify Variable Values] タブの [Common Variable Values for all Instances] オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、編集してから（同じファイル名を維持して）ファイルをアップロードします。

1. [Job Preview] タブで、各インスタンスまたはインスタンスグループで実行されるコマンドを評価および検証し、[Next] をクリックします。

   

2. [Execute] タブで、ジョブを今すぐ実行するか、後で実行するようにスケジュールするかを選択できます。コマンドが失敗した場合にNetScaler Consoleが実行するアクションを選択することもできます。 また、承認されたユーザーが管理対象インスタンスでジョブを実行することを許可するかどうか、およびジョブの成功または失敗に関する電子メール通知を他の詳細とともに送信するかどうかを選択できます。

   

ジョブを実行した後、[Infrastructure] > [Configuration Jobs] に移動し、構成したジョブを選択することで、ジョブの詳細を確認できます。[Details] をクリックし、次に [Execution Summary] をクリックしてジョブの詳細を確認します。インスタンスをクリックして [Command Logs] を表示し、ジョブで実行されたコマンドを確認します。