Application Delivery Management

在配置作业中使用变量

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

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

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

add lb vserver servername HTTP ipaddress portnumber

add service servicename1 ipaddress1 HTTP 80

add service servicename2 ipaddress2 HTTP 80

bind lb vserver servername servicename1

bind lb vserver servername servicename2

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

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

  2. 点击 创建任务

  3. 在 C reat e Job 页面上,选择自定义作业参数,例如任务名称、实例类型和配置类型。

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

    本地化后的图片

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

    本地化后的图片

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

    本地化后的图片

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

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

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

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

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

    本地化后的图片

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

    本地化后的图片

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

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

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

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

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

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

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

    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 将保留为步骤 5 中的变量提供的值。

在配置作业中使用变量