Application Delivery Management

使用 StyleBooks 配置构建器迁移 NetScaler 应用程序配置

注意

此功能处于技术预览阶段。

StyleBooks 配置构建器用于从现有 NetScaler 配置创建应用程序配置 StyleBook。此功能还可自动将应用程序配置从一个 NetScaler 实例迁移到另一个实例。

使用配置构建器,您可以简化创建自定义 StyleBook 的要求。此功能使您无需深入了解 StyleBooks 语法和结构即可创建 StyleBook。否则,创建 StyleBook 需要了解 StyleBooks 语法和结构。

配置构建器还会创建一个 ConfigPack,用于在新 ADC 实例上反映相同的 ADC 配置。借助此 ConfigPack,可以将一个 ADC 实例的初始 ADC 配置复制到另一个 ADC 实例。初始配置源可以是以下之一:

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

    即使您未指定目标实例,配置构建器也会将 ADC 配置转换为 StyleBook 和 ConfigPack。您以后可以使用此 ConfigPack 将 ADC 配置迁移到其他 ADC 实例。

  • 一组 CLI 命令:ns.confApplication config 粘贴配置。

配置构建器会识别源配置中嵌入的独立应用程序列表。当您选择感兴趣的应用程序配置时,配置构建器会提取所选应用程序的 CLI 命令集。这些 CLI 命令是从源配置中提取的。它还会识别可能需要您输入的部署和配置属性。

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

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

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

StyleBooks Configuration Builder workflow

完成应用程序创建和迁移后,将在 NetScaler® ADM 中创建一个 ConfigPack 及其对应的 StyleBook。此 ConfigPack 表示目标 ADC 实例上的应用程序配置。要查看创建的 ConfigPack,请导航到 Applications > StyleBooks > Configurations

支持的 NetScaler 功能

StyleBook 配置构建器可识别并支持源配置中的以下 NetScaler 功能:

  • 内容切换
  • 负载平衡
  • 监视
  • SSL 卸载
  • 速率限制
  • 重写
  • 响应方
  • Web 应用程序防火墙 (WAF)

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

以下过程用于创建 StyleBook,以在 NetScaler ADM 中迁移 NetScaler 应用程序:

  1. 导航到 Applications > StyleBooks > Configurations

  2. 单击 Migrate ADC Configuration

  3. 单击 Get Started

  4. Specify Configuration 中,选择配置源:

    • Import from an ADC:此选项发现所选 ADC 实例上的活动应用程序。

    • Import using CLI Commands:此选项分析 CLI 命令并从 CLI 命令中提取应用程序。

  5. 指定要从中迁移或复制应用程序配置的 Source ADC Instance

  6. 指定要将应用程序配置迁移或复制到的 Target ADC Instance

  7. Define Application 中,

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

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

    3. 单击 Next

  8. Equivalent CLI Commands 中,查看命令并单击 Next

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

  9. Deployment Attributes 中,您可以查看和编辑虚拟服务器、服务和服务组成员的 IP 地址和端口。

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

    Edit the deployment attributes

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

    • 源实例和目标实例不同。
    • 使用 CLI 命令导入配置。
  10. Configuration Attributes 中,指定必要的详细信息,然后单击 Next

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

    注意

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

    Unsupported Configurations

    Unsupported Global Configurations

    要成功迁移这些配置,您必须在目标实例上单独应用缺失或不受支持的配置。然后,单击 Next

  11. Migrate 中,指定所需的 StyleBook 详细信息。单击 Migrate

限制

  • 源实例中提及的命名表达式和 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 版本中修复。

使用 StyleBooks 配置构建器迁移 NetScaler 应用程序配置