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

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

使用配置生成器，您可以简化创建自定义样本的过程，即使您对样本语法和结构缺乏深入的了解也可以轻松完成。否则，需要熟悉 StyleBook 语法和结构才能创建 StyleBook。

配置生成器还会创建一个配置包，其中一个 NetScaler 实例的配置可以复制到另一个 NetScaler 实例。初始配置源可以是以下之一：

一个 NetScaler 实例： 指定您想要复制的应用程序配置所在的实例。

即使您未指定目标实例，配置生成器也会将 NetScaler 配置转换为样书和配置包。您稍后可以使用此配置包将 NetScaler 配置迁移到其他 NetScaler 实例。
一组 CLI 命令： 从 ns.conf 或 应用程序配置粘贴配置。
上传配置文件： 从本地机器上传配置。

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

应用程序部署信息 - 您可以从原始配置查看和编辑虚拟服务器、服务、服务组成员的 IP 地址和端口。您还可以查看和编辑虚拟服务器的状态和 ARP。
配置属性 - 这些属性可以是源配置中指定的密码或证书。

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

样书配置生成器工作流程

完成应用程序创建和迁移后，将在 NetScaler 控制台中创建一个配置包及其相应的样本。此配置包代表目标 NetScaler 实例上的应用程序配置。要查看创建的配置包，请导航至 应用程序 > StyleBooks > 配置。

在迁移的配置之间共享配置实体

使用配置迁移实用程序迁移配置时，您可以重复使用配置实体。后续迁移成功重用了现有的配置实体。以前，当迁移两个共享某些配置实体的配置时，配置迁移会失败，并出现错误 资源已存在 。此选项允许在跨多个配置使用配置实体的情况下重复使用配置实体，从而简化了迁移工作流程。

支持的 NetScaler 功能

StyleBook 配置生成器识别并支持源配置中的以下 NetScaler 功能：

分析
AppFlow
应用程序级体验质量配置（AppQoE）
身份验证 & 授权
审计
机器人管理
缓存重定向
内容切换
DNS
前端优化
HTTP 压缩
集成缓存
负载均衡
监控
QUIC 协议
速率限制
响应者
改写
SSL 卸载
溢出
交通管理
URL 转换
Web 应用程序防火墙 (WAF)

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

以下步骤是在 NetScaler 控制台中创建迁移 NetScaler 应用程序的样书：

导航到 应用程序 > 配置 > 配置包。
单击 迁移 NetScaler 配置。
单击开始。
在 指定配置中，选择以下配置源之一：
- 从 NetScaler 导入：
  - 源 NetScaler 实例 - 选择要从中迁移或复制应用程序配置的 NetScaler 实例。单击确定。
- 使用 CLI 命令导入 - 从配置文件粘贴配置。
- 上传配置文件 - 单击浏览从本地机器选择一个配置文件。
目标实例 - 选择要将应用程序配置迁移或复制到的 NetScaler 实例或 Autoscale 组。单击确定。

单击 下一步。
在 高级策略配置中，根据您的配置，将出现以下情况：
- 配置中所有现有的经典策略均成功转换为高级策略，且没有错误。查看更新后的配置并选择确认。单击 下一步。
- 配置中所有现有的经典策略均成功转换为高级策略，但出现错误。检查并修复错误。单击 上一个。
- 如果没有经典策略，则配置不会更新。单击 OK 继续。
在 定义应用程序中，
1. 在 应用程序名称中指定应用程序的名称。
2. 选择要迁移的虚拟服务器。
3. 单击 下一步。
在 应用程序配置中，查看应用程序的命令。这些命令特定于所选的应用程序配置。

启用 Visualizer 来查看应用程序配置及其相关实体。可视化工具允许您查看不同组件的连接方式，并帮助您在迁移过程中理解和决策。

使用可视化工具，您可以：
- 查看与服务器关联的操作和策略的层次结构
- 将鼠标悬停在服务器上以获取服务器的详细描述，包括绑定到服务器的策略和操作
- 使用缩放滑块放大和缩小视图
- 单击实体上的减号 (-) 或加号 (+) 可折叠或展开层次结构
单击 下一步。
在 应用程序部署信息中，您可以查看和编辑虚拟服务器、服务和服务组成员的 IP 地址、端口、状态和 ARP。

在 详细信息 页面中，您可以编辑 NSIP 实体的 IP 地址、端口、状态和 ARP 状态。
笔记：
- 虚拟服务器 IP 的 NSIP 实体的状态决定了 ARP 的初始状态。
- 如果目标 NetScaler 上已配置虚拟服务器 IP 的 NSIP 实体，则无法修改虚拟服务器的 ARP 状态。
- 修改虚拟服务器的 ARP 状态会改变所有具有相同 IP 地址的虚拟服务器的 ARP 状态。修改虚拟服务器的状态只会影响关联的虚拟服务器。
- ARP 不适用于基于 IP 模式的虚拟服务器。
- 如果在源配置中禁用虚拟服务器 IP 的 NSIP 状态，则 ARP 也会自动禁用，并且您无法修改 ARP。
如果源实例和目标实例相同，则不会出现 应用程序部署信息 选项卡。
在 身份验证/网络部署信息中，您可以查看和编辑身份验证服务器和网络配置文件的属性（如果可用）。
1. 在 认证部署信息中，选择所需的认证服务器，并编辑服务器的 IP 地址、服务器 IP、服务器名称和端口号。
2. 在 NetProfile Info中，选择所需的网络配置文件并编辑 NetProfile 和 IPSET 的详细信息。

笔记：

在此步骤中所做的 NSIP 地址更改将被考虑用于最终迁移，并且前面步骤中的配置将更新以反映这些更改。

在 Resource Files/Secrets中，上传证书和密钥以解密密码和证书。单击 下一步。
在 全局配置中，查看源和目标之间的全局配置设置的差异。查看要应用于目标的配置并选择确认。单击 下一步。
在 Migrate中，查看 StyleBook 详细信息。单击迁移。

笔记：

默认情况下，NetScaler 控制台管理将应用程序或虚拟服务器迁移到 NetScaler 时创建的配置包。如果您不想将 confipack 与结果配置关联，请清除 通过 NetScaler 控制台 管理配置复选框。
在 不支持的配置中，查看任何错过或不支持的配置。要成功迁移这些配置，您必须在目标实例上单独应用缺失或不受支持的配置。单击 下一步。

限制

源实例中提到的命名表达式和 responderhtmlpages 未被识别。确保在迁移之前在目标实例上配置命名表达式和 responderhtmlpages 。
如果源具有 服务组 的配置，并且监视器绑定如下：

绑定服务组 <Name> <Port> -monitorName <Monitor_Name>

出现以下错误：
```
 CLI 命令转换失败：100 - 没有这样的命令 [{“errorcode”：1090，“message”：“没有这样的参数[XXX]”，“severity”：“ERROR”}]
 
```
发生此错误的原因是 NetScaler 以无效格式保存了服务组和监视器之间的绑定。此问题已从 NetScaler 12.1.52.15 版本开始修复。