样书配置

使用样书配置生成器迁移 NetScaler 应用程序配置

样书配置生成器用于将现有 NetScaler 配置迁移到样书。此功能还可以自动将应用程序配置从一个 NetScaler 实例迁移到另一个实例或 AutoScale 组。

配置生成器提供结构化应用样书,可用于 NetScaler 配置的任何变体。此功能可帮助您在没有深入了解样书语法和结构的情况下开始使用样书。否则,创建样书必须具备样书语法和构造的知识。

配置生成器还会创建一个配置包,该配置包在新的 NetScaler 实例上反映相同的 NetScaler 配置。使用此配置包,可以将一个 NetScaler 实例中的初始 NetScaler 配置复制到另一个 NetScaler 实例。初始配置源可以是以下之一:

  • NetScaler 实例: 指定托管要复制的应用程序配置的实例。

    即使您未指定目标实例,配置生成器也会将 NetScaler 配置转换为样书和配置包。以后您可以使用此配置包将 NetScaler 配置迁移到其他 NetScaler 实例。

    如果目标实例是 AutoScale 组,则配置包将显示在 网络 > AutoScale 组 页面中。在“配置”选项卡下。

  • 一组 CLI 命令:ns.conf 或粘贴配置 Application config

配置生成器可识别源配置中嵌入的不同应用程序的列表。当您选择所需的应用程序配置时,配置生成器会为所选应用程序提取一组 CLI 命令。这些 CLI 命令是从源配置中提取的。此外,它还标识可能需要输入的部署和配置属性。

  • IP 地址/端口 -您可以从原始配置中查看和编辑虚拟服务器、服务、服务组成员的 IP 地址和端口。

  • 配置文件/密 码-这些属性可以是源配置中指定的密码或证书。

指定必要信息后,开始在目标 NetScaler 实例上迁移或复制应用程序配置。

样书配置生成器工作流

应用创建和迁移后,将使用 adc_nitro_application 样书在 NetScaler 控制台中创建配置包。这本样书是基于 NetScaler NITRO 资源创建的。此配置包代表目标 NetScaler 实例上的应用配置。要查看创建的配置包,请导航到 应用程序 > 配置 > 配置包

支持的 NetScaler 功能

样书配置生成器可识别并支持源配置中的以下 NetScaler 功能:

  • 内容交换
  • 负载平衡
  • 监视
  • SSL 卸载
  • 速率限制
  • 重写
  • 响应方
  • Web 应用程序防火墙 (WAF)
  • 机器人管理
  • 压缩控制

创建样书以迁移 NetScaler 应用程序配置

以下过程是创建一本在 NetScaler 控制台中迁移 NetScaler 应用程序迁移的样书:

  1. 导航到 应用程序 > 配置 > 配置包

  2. 单击“迁移 NetScaler 配置”。

  3. 单击入门

  4. 在“指定配置”中,选择配置源:

    • 从 NetScaler 导入:此选项可发现所选 NetScaler 实例上的活动应用程序。

    • 使用 CLI 命令导入:此选项分析 CLI 命令并从 CLI 命令中提取应用程序。

  5. 指定要从中迁移或复制应用程序配置的 源 NetScaler 实例。

    要将应用程序配置迁移到 AutoScale 组,请确保源配置中未包含以下信息:

    • IPset
    • 设备简介
    • 协议
    • 端口
  6. 指定要迁移或复制应用程序配置的 目标 NetScaler 实例。

    要将应用程序配置迁移到 AutoScale 组,请从列表中选择自动缩放组。

  7. 定义应用程序中,

    1. 应用程序名称中,指定应用程序的名称。

      如果目标实例是 AutoScale 组,请指定以下 AutoScale 参数:

      • 访问类型 -您可以将 NetScaler 控制台自动扩展解决方案用于外部和内部应用程序。选择所需的应用程序访问类型。

      • 域名 -指定应用程序的域名。仅当您选择用户定义的 FQDN 类型时,此选项才适用。

      • 域的区域 -从列表中选择应用程序的区域名称。仅当您选择用户定义的 FQDN 类型时,此选项才适用。

        此域和区域名称将重定向到 Azure 中的虚拟服务器。例如,如果您在中托管应用程序 app.example.com,则 app 为域名和 example.com 区域名称。

    2. 选择要迁移的虚拟服务器。

    3. 单击下一步

  8. 在“等效 CLI 命令”中,查看命令并单击“下一步”。

    这些命令特定于所选应用程序配置。

    注意:

    如果需要,您也可以添加或编辑配置。

  9. 部署属性中,可以查看和编辑虚拟服务器、服务和服务组成员的 IP 地址和端口。

    要编辑 IP 地址和端口,请在流程图中单击虚拟服务器、服务或服务组成员上的编辑图标。

    编辑部署属性

    注意:

    如果目标实例是 Autoscale 组,则会禁用编辑前端 IP 地址。

    此选项卡仅在以下情况下显示:

    • 源实例和目标实例不同。

    • 使用 CLI 命令导入配置。

  10. 在“配置属性”中,指定必要的详细信息,然后单击“下一步”。

    此选项卡列出了密钥,例如用于解密密码和证书的密钥。

    注意:

    在开始迁移之前,遗漏或不支持的配置会显示在以下任何选项卡中:

    • 不支持的配置

    • 不支持的全局配置

    要成功迁移这些配置,您必须在目标实例上单独应用缺少或不支持的配置。然后,单击“下一步”。

  11. 迁移中,单击 迁移

限制

  • 源实例中提及的命名表达式和 responderhtmlpages 未被识别。确保在迁移之前在目标实例上配置命名表达式和 responderhtmlpages

  • 如果源具有如下所示的 servicegroup 配置和监视器绑定:

    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>

    出现以下错误:

     CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
     <!--NeedCopy-->
    

    之所以出现此错误,是因为 NetScaler 以无效格式保存服务组和监视器之间的绑定。从 NetScaler 12.1.52.15 版本中修复了此问题。

使用样书配置生成器迁移 NetScaler 应用程序配置