Citrix Application Delivery Management 13.0

在配置作业中使用变量

配置作业是可以在一个或多个托管实例上执行的一组配置命令。在多个实例上执行相同配置时,您可能希望配置中所用参数使用不同的值。您可以定义变量,以便您可以为这些参数分配不同的值或在多个实例上执行某个作业。

例如,假定一个基本的负载平衡配置,在该配置中,您添加一个负载平衡虚拟服务器、添加两个服务以及将服务绑定到虚拟服务器。现在,您可能希望两个实例上的配置相同,但虚拟服务器和服务名称和 IP 地址的值不同。您可以使用配置作业功能来实现这一点,即使有变量来定义虚拟服务器和服务名称和 IP 地址。

在此示例中,使用了以下命令和变量:

添加 lb 虚拟服务 器服务器名称 HTTP IP 地址 端口号

添加 服务服务名称 1 IP 地址 1 HTTP 80

添加 服务服务名称 2 IP 地址 2 HTTP 80

绑定 lb 虚拟服务 器服务器名称 服务名 1

绑定 lb 虚拟服务 器服务器名称 服务名称 2

要通过在 Citrix ADM 中定义变量来创建配置作业,请执行以下操作:

  1. 导航到 “ 网络 ” > “ 配置作业”。

  2. 单击 创建作业

  3. 在 “ 创建作业 ” 页上,选择自定义作业参数,如作业的名称、实例类型和配置类型。

  4. 在“Configuration Editor”(配置编辑器)中,键入命令以添加一个负载平衡虚拟服务器、两个服务以及将服务绑定到虚拟服务器。双击以选择要转换为变量的值,然后单击 转换为变量。例如,选择负载平衡服务器 ipaddress,然后单击转换为变量,如下图所示。

    本地化后的图片

  5. 看到美元符号括住变量值后,单击变量以进一步指定变量的详细信息,例如,名称、显示名称和类型。如果要进一步为变量指定默认值,也可以单击 级” 选项。单击 保存 ,然后单击 下一步

    本地化后的图片

    键入命令的其余部分,并定义所有变量。

    本地化后的图片

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

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

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

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

  8. 然后,您可以单击 预览变量 选项卡以在创建或编辑配置作业时定义的单个统一视图中预览变量。

    本地化后的图片

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

    本地化后的图片

  10. 然后,您可以根据需要在配置编辑器中重新排列和重新排序命令。您可以通过拖放命令行将命令从一行移动到另一行。您也可以通过简单地更改文本框中的命令行号,将命令行从一行移动或重新排列到任何目标行。

  11. 选择要对其运行配置作业的实例。

  12. 在 “ 指定变量值 ” 选项卡中,选择 “ 上载变量值的输入文件” 选项,然后单击 “ 下载输入密钥文件”。在我们的示例中,您将需要指定每个实例上的服务器名称、服务器和服务的 IP 地址、端口号以及服务名称。保存文件并将其上载。如果未准确定义您的值,系统可能会抛出错误。

  13. 输入密钥文件将下载到本地系统中,您可以通过为之前选择的每个 Citrix ADC 实例指定变量值进行编辑,然后单击 “ 上传 ” 将输入密钥文件上载到 Citrix ADM。单击 “ 下一步”。输入密钥文件将下载到本地系统,您可以通过为之前选择的每个 Citrix ADC 实例指定变量值来对其进行编辑。

    注意 在输入密钥文件中,变量定义在三个级别:

    • 全局级别
    • 实例组级别
    • 实例级别

    全局变量是应用于所有实例的变量值。实例组级别变量值应用于组中定义的所有实例。实例级别变量值仅应用于特定实例。

    Citrix ADM 给予实例级别值的第一优先级。如果没有为单个实例的变量提供任何值,Citrix ADM 将使用在组级别提供的值。如果在组级别没有提供任何值,Citrix ADM 将使用在全局级别提供的可变值。如果为所有三个级别的变量提供输入,Citrix ADM 将使用实例级别值作为默认值。

  14. 单击 “ 载” 将输入密钥文件上载到 Citrix ADM。单击 “ 下一步”。

    本地化后的图片

    重要

    当您从 Mac 上传 CSV 文件时,Mac 会使用分号而不是逗号存储 CSV 文件。这将导致配置失败,当您上传输入文件并运行作业。如果您使用的是 Mac,请使用文本编辑器进行必要的更改,然后上传文件。

  15. 您还可以为所有实例提供公用变量值,然后单击 “上传” 将输入密钥文件上传到 Citrix ADM。

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

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

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

  16. 在 “作 业预览 选项卡上,您可以评估和验证要在每个实例或实例组上运行的命令。

  17. 行” 选项卡中,您可以选择立即执行作业,或者将其安排在以后执行。您还可以选择在命令失败以及是否希望发送有关作业成功或失败的电子邮件通知以及其他详细信息时 Citrix ADM 应采取的操作。

    本地化后的图片

配置并执行作业后,您可以通过导航到 网络 > “配置作业” 并选择刚刚 配置的作业 来查看作业详细信息。单击 详细信息 ,然后单击 变量详细信息 以查看添加到作业的变量列表。

本地化后的图片

注意

当您保存作业并退出时,或者安排作业在稍后时间点运行时,Citrix ADM 将保留为 STE P 5 中的变量提供的值。

在配置作业中使用变量