Citrix Application Delivery Management 服务

使用主配置模板

使用主配置模板是在多个 Citrix ADC 实例上创建和部署主配置的灵活选项。

作为管理员,您可能希望更改配置并将许可证、证书和其他文件保存在 Citrix ADC 实例上。您可以将新配置保存为主配置模板(.conf 文件)。

要从 Citrix ADC 实例保存主配置模板,可以执行以下操作之一:

  • 在命令提示符处,输入 save ns 配置。配置将保存在 /nsconfig/ns.conf 文件中的实例闪存内存中。
  • 从 Citrix ADC 实例的 GUI 中,导航到 “ 诊断 ” > “ 查看配置”。选择要保存的配置类型。例如,如果要保存 Citrix ADC 实例的保存配置,请选择 “ 保存的配置”。单击 将文本保存到文件 链接以将 “ns.conf” 文件保存到本地计算机。

当您在创建作业时使用 “DeploCitrix ADC MasterConfiguration” 配置模板部署主配置模板时,您可以通过添加其他命令、修改现有命令以及在输入文件。

例如,作为管理员,您可能希望除 ns.conf 文件外将证书密钥上传到 Citrix ADC 实例,并在这些实例上部署主配置。

重要

您无法在 Citrix ADC CPX 实例、群集中配置的 Citrix ADC 实例或分区的 Citrix ADC 实例上通过使用 DeployMasterConfiguration 模板来执行配置作业。

要使用 Citrix ADM 上的主配置配置模板创建配置作业,请执行以下操作:

  1. 在 Citrix Application Delivery Management (ADM) 中,导航到 “ 网络 ” > “ 配置作业”,然后单击 “ 创建作业”。

  2. 创建作业 页上的 选择配置 选项卡上,指定 作业名称 并从下拉列表中选择 实例类型

  3. 配置源下拉列表中选择主配置 。将 “部署主配置” 模板的命令拖到右窗格中。您也可以在右侧窗格中添加、修改或删除命令。单击下一步

    注意

    您可以添加 put 命令以将输入文件添加到模板中。在我们的示例中,除了配置模板文件和变量输入文件之外,我们还需要上传证书和密钥文件。

    主配置

  4. 您可以在单个合并视图中查看在创建或编辑配置作业时定义的所有变量。

  5. 执行以下操作之一以查看单个统一视图中的所有变量:

    • 创建配置作业时,导航到 “网络” > “配置作业”,选择 “ 创建作业”。在 创建作业 页面上,您可以查看创建配置作业时添加的所有变量。

    • 编辑配置作业时,导航到 “网络” > “配置作业”,选择 “作业名称”,然后单击 “ 编辑”。在 配置作业 页面上,您可以查看创建配置作业时添加的所有变量。

  6. 然后,可以单击 “ 预览变量 ” 选项卡,在创建或编辑配置作业时定义的单个合并视图中预览变量。

    配置预览示例

  7. 将出现一个新的弹出窗口,并以表格格式显示变量的所有参数,如名称、显示名称、类型和默认值。您还可以编辑和修改这些参数。在编辑或修改任何参数后,单击 成” 按钮。

    指定的变量

  8. 选择要在其上运行配置作业的实例,然后单击 下一步”。

  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>
    
    

    此处提供示例 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,,,,
    

    在微软 Excel 中显示相同的文件:

    Excel 上的示例 CSV

  10. 单击下一步

    选择文件

    包含变量值的输入文件将保留在配置作业中(具有相同的文件名)。您可以查看和编辑创建或编辑配置作业时先前使用和上传的这些输入文件。

    要在创建配置作业时查看已执行的配置作业,请导航到 网络 > 配置作业 ”,然后单击 创建作业。在 创建任务 页面中。在 指定变量值 选项卡上,选择 所有实例的公用变量值 选项以查看上传的文件。要编辑输入文件,请下载输入文件,然后编辑和上传文件(保持相同的文件名)。

    要在编辑配置作业时查看已执行的配置作业,请导航到 网络 > 配置作业 ”,选择 “作业名称”,然后单击 编辑。在 配置作业 页面的 指定变量值 选项卡上,选择 所有实例的公用变量值 选项以查看上传的文件。要编辑输入文件,请下载输入文件,然后编辑和上传文件(保持相同的文件名)。

  11. 在 “作 业预览 选项卡上,您可以评估和验证要在每个实例或实例组上运行的命令,然后单击 下一步

    本地化后的图片

  12. 在 “执行” ( Execute ) 选项卡上,您可以选择立即执行作业或计划稍后执行作业。您还可以选择在命令失败时 Citrix ADM 应采取的操作。

    您还可以选择允许授权用户在您的托管实例上执行作业,并可以选择是否发送有关作业成功或失败以及其他详细信息的电子邮件通知。

    本地化后的图片

    执行作业后,您可以通过导航到 网络 > “配置作业” 并选择刚刚 配置的作业 来查看作业详细信息。单击 详细信息 ,然后单击 执行摘要 查看工作的详细信息。单击实例可查看命 令日志 以查看在作业上执行的命令。

    本地化后的图片

使用主配置模板