Citrix Application Delivery Management 服务

使用主配置模板

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

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

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

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

当您在创建作业时使用 “DeploMasterConfiguration” 配置模板部署主配置模板时,可以通过添加更多命令、修改现有命令以及在输入文件中提供不同的变量值,为每个特定 Citrix ADC 实例进一步自定义该模板。

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

重要

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

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

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

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

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

    注意

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

    主配置

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

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

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

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

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

    配置预览示例

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

    指定的变量

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

  9. 指定变量值选项卡上,上传以下内容:

    • 配置模板文件 (.conf)-上传从 Citrix ADC 实例中提取的 .conf 文件。
    • 上传输入文件 (.xml/csv)-上传输入文件,其中包含您在命令中定义的变量的值。

    这里提供了一个示例 xml 文件供您使用。确保 xml 文件包含与您正在使用的 ADC 实例相对应的详细信息。

    name="BLR_DEVS">name="10.106.101.209">name="IP"value="10.106.101.209"/>

    此处提供示例 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. 在 “行” 选项卡上,您可以选择立即运行作业或计划稍后运行作业。您还可以选择如果命令失败,Citrix ADM 必须采取的操作。

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

    允许授权用户

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

    查看在作业上运行的命令

使用主配置模板