Application Delivery Management

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

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

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

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

  • コマンドプロンプトに対して、s ave ns configと入力します。構成は、インスタンスのフラッシュメモリ内の/nsconfig/ns.confファイルに保存されます。

  • インスタンスの GUI から、[ 診断 ] > [ 設定の表示] に移動します。保存する構成の種類を選択します。たとえば、インスタンスの保存済み設定を保存する場合は、[ Saved configuration n] を選択します。「 ファイルにテキストを保存 」リンクをクリックして、’ns.conf’ファイルをローカルマシンに保存します。

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

たとえば、管理者として、さらに ns.conf ファイルに ADC インスタンスに証明書キーをアップロードし、マスター設定もデプロイできます。

重要

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

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

  1. Citrix ADM で、[ネットワーク ]>[ 構成ジョブ]に移動し 、[ジョブの作成]をクリック します。

  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) -ADC インスタンスから抽出した.conf ファイルをアップロードします。

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

    ここでは、使用例としてサンプルの xml ファイルを用意しています。xml ファイルに、使用している ADC インスタンスに対応する詳細が含まれていることを確認します。

    
    <?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. [次へ] をクリックします。

ファイルをアップロード

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

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

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

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

    ジョブプレビュー

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

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

    ジョブを実行する

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

コマンドログを表示する

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

この記事の概要