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

マスター構成テンプレートを使用すると、複数のNetScaler ADC インスタンスにマスター構成を作成して展開できます。

管理者は、構成を変更し、ライセンス、証明書、およびその他のファイルをNetScaler ADCインスタンスに保存することができます。新しい構成をマスター構成テンプレート(.confファイル)として保存できます。

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

  • コマンドプロンプトに対して、s ave ns configと入力します。設定は、インスタンスのフラッシュメモリに /nsconfig/ns.conf ファイルに保存されます。
  • NetScaler ADCインスタンスのGUIから、[ 診断 ]>[ 構成の表示]に移動します。保存したい構成の種類を選択します。たとえば、NetScaler ADCインスタンスの保存された構成を保存する場合は、[ 保存された構成]を選択します。 「 テキストをファイルに保存 」リンクをクリックして、「ns.conf」ファイルをローカルマシンに保存します。

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

たとえば、管理者は、ns.confファイルに加えてNetScaler ADCインスタンスに証明書キーをアップロードし、マスター構成も展開できます。

重要

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

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

  1. NetScaler Consoleで、[ インフラストラクチャ]>[構成]>[構成ジョブ]に移動し、[ ジョブ作成]をクリックします。

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

  3. 構成ソース」ドロップダウンリストから「マスター構成」を選択します。DeployMasterConfiguration テンプレートのコマンドを右側のペインにドラッグします。右側のペインでは、コマンドを追加、変更、削除することもできます。[次へ] をクリックします。

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

    マスター構成

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

  5. 次のいずれかの操作を行って、すべての変数を 1 つの統合ビューに表示します。

    • 構成ジョブの作成中に、[ インフラストラクチャー] > [構成ジョブ] に移動し、[ ジョブの作成] を選択します。[ Create Job ] ページでは、構成ジョブの作成時に追加したすべての変数を確認できます。

    • 構成ジョブの編集中に、[ インフラストラクチャ] > [構成] > [構成ジョブ] に移動し、ジョブ名を選択して [ 編集] をクリックします。[ ジョブの構成 ] ページでは、構成ジョブの作成時に追加されたすべての変数を確認できます。

  6. 次に、「 変数のプレビュー 」(Preview Variables) タブをクリックして、設定ジョブの作成または編集中に定義した 1 つの統合ビューで変数をプレビューできます。

    設定プレビューの例

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

    指定された変数

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

  9. [ 変数値の指定 ] タブで、次のファイルをアップロードします。

    • 構成テンプレートファイル(.conf) -NetScaler ADCインスタンスから抽出した.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-->
    

    ここでは、サンプルの csv ファイルが用意されています。

    #job-s_variable_input_key_file ,,,,
    ,,,,
    #Global,NSIP,HostName,LBSERVER,SNMPTrapDest
    Global Values,,,,
    #InstanceGroup,NSIP,HostName,LBSERVER,SNMPTrapDest
    example_doc,,,,
    #Instance(s),NSIP,HostName,LBSERVER,SNMPTrapDest
    10.xx.xx.xx,,,,
    <!--NeedCopy-->
    

    同じファイルがMicrosoft エクセルに表示されます。

    エクセルでのCSVの例

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

    ファイルを選択

    変数値を含む入力ファイルは、設定ジョブで (同じファイル名で) 保持されます。設定ジョブの作成または編集中に、以前に使用およびアップロードした入力ファイルを表示および編集できます。

    構成ジョブの作成中に実行構成ジョブを表示するには、[ ネットワーク ] > [ 構成ジョブ] に移動し、[ ジョブの作成] をクリックします。[ ジョブの作成 ] ページ。[ 変数値の指定 ] タブで、[ すべてのインスタンスに共通の変数値 ] オプションを選択し、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、ファイルを編集してアップロードします(同じファイル名を維持します)。

    構成ジョブの編集中にすでに実行されている構成ジョブを表示するには、[ ネットワーク ] > [ 構成ジョブ] に移動し、[ジョブ名] を選択して [ 編集] をクリックします。[ ジョブの設定 ] ページの [ 変数値の指定 ] タブで、[ すべてのインスタンスに共通変数値 ] オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、ファイルを編集してアップロードします(同じファイル名を維持します)。

  11. [ Job Preview ] タブでは、各インスタンスまたはインスタンスグループで実行するコマンドを評価して確認し、[ Next] をクリックします。

    確認コマンド

  12. [Execute] タブでは、ジョブを今すぐ実行するか、後で実行するようにスケジュールするかを選択できます。コマンドが失敗した場合にNetScaler Consoleが実行するアクションを選択することもできます。

    また、承認されたユーザーが管理対象インスタンスでジョブを実行できるようにすることもできます。また、ジョブの成功または失敗に関する電子メール通知を他の詳細とともに送信するかどうかを選択できます。

    権限のあるユーザーを許可

    ジョブを実行した後、[ インフラストラクチャ] > [構成] > [構成ジョブ ] に移動して、設定したジョブを選択すると、ジョブの詳細が表示されます。 [ 詳細 ] をクリックし、次に [ 実行の概要 ] をクリックしてジョブの詳細を表示します。インスタンスをクリックして Command Logs を表示して、ジョブで実行されたコマンドを確認します。

    ジョブで実行されるビューコマンド

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

この記事の概要