Citrix Application Delivery Managementサービス

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

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

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

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

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

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

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

重要

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

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

  1. Citrix Application Delivery Management(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) -Citrix 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-->
    

    ここでは、サンプルの 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 Excelに表示されます。

    エクセルでのCSVの例

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

    ファイルを選択

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

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

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

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

    確認コマンド

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

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

    許可されたユーザーを許可する

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

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

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