使用 StyleBooks Configuration Builder 迁移 NetScaler® 应用程序配置
StyleBooks Configuration Builder 用于从现有 NetScaler 配置创建应用程序配置 StyleBook。此功能还可自动将应用程序配置从一个 NetScaler 实例迁移到另一个实例。
使用 Configuration Builder，您可以简化创建自定义 StyleBook 的过程，即使您不深入了解 StyleBook 语法和构造，也能轻松完成。否则，创建 StyleBook 需要熟悉 StyleBook 语法和构造。
Configuration Builder 还会创建一个配置包，通过该配置包可以将一个 NetScaler 实例的配置复制到另一个 NetScaler 实例。初始配置源可以是以下之一：
-
一个 NetScaler 实例： 指定要复制的应用程序配置所在的实例。
即使您未指定目标实例，Configuration Builder 也会将 NetScaler 配置转换为 StyleBook 和配置包。您以后可以使用此配置包将 NetScaler 配置迁移到其他 NetScaler 实例。
-
一组 CLI 命令： 粘贴来自
ns.conf或“应用程序配置”的配置。 -
上传配置文件： 从本地计算机上传配置。
Configuration Builder 会识别源配置中嵌入的不同应用程序列表。当您选择感兴趣的应用程序配置时，Configuration Builder 会提取所选应用程序的 CLI 命令集。这些 CLI 命令是从源配置中提取的。它还会识别可能需要您输入的部署和配置属性。
-
应用程序部署信息 - 您可以查看和编辑原始配置中虚拟服务器、服务、服务组成员的 IP 地址和端口。您还可以查看和编辑虚拟服务器的状态和 ARP。
-
配置属性 - 这些属性可以是源配置中指定的密码或证书。
指定必要信息后，开始在目标 NetScaler 实例上迁移或复制应用程序配置。
完成应用程序创建和迁移后，将在 NetScaler Console 中创建一个配置包及其对应的 StyleBook。此配置包表示目标 NetScaler 实例上的应用程序配置。要查看创建的配置包，请导航到 Applications（应用程序）> StyleBooks > Configurations（配置）。
在迁移的配置之间共享配置实体
使用配置迁移实用程序迁移配置时，可以重用配置实体。后续迁移会成功重用现有配置实体。以前，当迁移共享某些配置实体的两个配置时，配置迁移会因错误“资源已存在”而失败。此选项通过允许在多个配置中使用配置实体的情况下重用配置实体来简化迁移工作流程。
支持的 NetScaler 功能
StyleBook Configuration Builder 识别并支持源配置中的以下 NetScaler 功能：
- Analytics
- AppFlow®
- 应用程序级别服务质量配置 (AppQoE)
- Authentication & Authorization（身份验证和授权）
- Audit（审计）
- Bot Management（Bot 管理）
- Cache Redirecting（缓存重定向）
- Content Switching（内容切换）
- DNS
- Frontend Optimization（前端优化）
- HTTP Compression（HTTP 压缩）
- Integrated caching（集成缓存）
- Load Balancing（负载平衡）
- Monitoring（监视）
- QUIC protocol
- Rate Limiting（速率限制）
- Responder（响应方）
- Rewrite（重写）
- SSL Offloading（SSL 卸载）
- SpillOver
- Traffic Management（流量管理）
- URL Transformation（URL 转换）
- Web Application Firewall (WAF)
创建 StyleBook 以迁移 NetScaler 应用程序配置
以下过程用于创建 StyleBook，以在 NetScaler Console 中迁移 NetScaler 应用程序：
-
导航到 Applications（应用程序）> Configuration（配置）> Config Packs（配置包）。
-
单击 Migrate NetScaler Configuration（迁移 NetScaler 配置）。
-
单击 Get Started（开始）。
-
在 Specify Configuration（指定配置）中，选择以下配置源之一：
-
Import from a NetScaler（从 NetScaler 导入）：
- Source NetScaler Instance（源 NetScaler 实例）- 选择要从中迁移或复制应用程序配置的 NetScaler 实例。单击 OK（确定）。
-
Import using CLI Commands（使用 CLI 命令导入）- 粘贴来自配置文件的配置。
-
Upload configuration file（上传配置文件）- 单击 Browse（浏览）以从本地计算机选择配置文件。
Target Instance（目标实例）- 选择要将应用程序配置迁移或复制到的 NetScaler 实例或 Autoscale 组。单击 OK（确定）。
单击 Next（下一步）。
-
-
在 Advanced Policy Configuration（高级策略配置）中，根据您的配置，会出现以下情况：
- 配置中的所有现有经典策略都已成功转换为高级策略，没有错误。查看更新的配置并选择确认。单击 Next（下一步）。
- 配置中的所有现有经典策略都已成功转换为高级策略，但存在错误。查看并修复错误。单击 Previous（上一步）。
- 如果没有经典策略，则配置不会更新。单击 OK（确定）继续。
-
在 Define Application（定义应用程序）中，
-
在 Application Name（应用程序名称）中，指定应用程序的名称。
-
选择要迁移的虚拟服务器。
-
单击 Next（下一步）。
-
-
在 Application Configuration（应用程序配置）中，查看应用程序的命令。这些命令特定于所选的应用程序配置。
启用 Visualizer（可视化工具）以查看应用程序配置及其关联的实体。可视化工具允许您查看不同组件的连接方式，并帮助您在迁移过程中进行理解和决策。
使用可视化工具，您可以：
- 查看与服务器关联的操作和策略的层次结构
- 将鼠标悬停在服务器上以获取服务器的详细描述，包括绑定到服务器的策略和操作
- 使用缩放滑块放大和缩小视图
- 单击实体上的减号 (-) 或加号 (+) 符号以折叠或展开层次结构
单击 Next（下一步）。
-
在 Application Deployment Info（应用程序部署信息）中，您可以查看和编辑虚拟服务器、服务和服务组成员的 IP 地址、端口、状态和 ARP。
在 Details（详细信息）页面中，您可以编辑 NSIP 实体的 IP 地址、端口、状态和 ARP 状态。
注意：
- 虚拟服务器 IP 的 NSIP 实体的状态决定了 ARP 的初始状态。
- 如果虚拟服务器 IP 的 NSIP 实体已在目标 NetScaler 上配置，则无法修改虚拟服务器的 ARP 状态。
- 修改虚拟服务器的 ARP 状态会更改所有具有相同 IP 地址的虚拟服务器的 ARP 状态。修改虚拟服务器的状态仅影响关联的虚拟服务器。
- ARP 不适用于基于 IP 模式的虚拟服务器。
- 如果源配置中禁用了虚拟服务器 IP 的 NSIP 状态，则 ARP 也会自动禁用，并且您无法修改 ARP。
如果源实例和目标实例相同，则不会显示 Application Deployment Info（应用程序部署信息）选项卡。
-
在 Authentication/Networking Deployment Info（身份验证/网络部署信息）中，您可以查看和编辑身份验证服务器和网络配置文件的属性（如果可用）。
- 在 Authentication Deployment Info（身份验证部署信息）中，选择所需的身份验证服务器并编辑服务器的 IP 地址、服务器 IP、服务器名称和端口号。
-
在 NetProfile Info（网络配置文件信息）中，选择所需的网络配置文件并编辑 NetProfile（网络配置文件）和 IPSET 详细信息。
注意：
在此步骤中进行的 NSIP 地址更改将用于最终迁移，并且上一步中的配置将更新以反映这些更改。
-
在 Resource Files/Secrets（资源文件/密钥）中，上传证书和密钥以解密密码和证书。单击 Next（下一步）。
-
在 Global Configuration（全局配置）中，查看源和目标之间的全局配置设置差异。查看要应用于目标的配置并选择确认。单击 Next（下一步）。
-
在 Migrate（迁移）中，查看 StyleBook 详细信息。单击 Migrate（迁移）。
注意：
默认情况下，NetScaler Console 会管理在将应用程序或虚拟服务器迁移到 NetScaler 时创建的配置包。如果您不想将配置包与生成的配置关联，请清除 Manage the configuration through NetScaler Console（通过 NetScaler Console 管理配置）复选框。
-
在 Unsupported Configuration（不支持的配置）中，查看任何遗漏或不支持的配置。要成功迁移这些配置，您必须在目标实例上单独应用遗漏或不支持的配置。单击 Next（下一步）。
限制
-
源实例中提及的命名表达式和
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 版本中修复。