Skip to main content

迁移准备工具

面向 Server 的迁移准备工具是一个实用程序,允许预迁移工作流和应用程序的数据库,以便更快地迁移到新的 AES256 标准。

此迁移准备工具是可选的,是一个单独的命令行实用程序。在从 Server 2022.1(或更早版本)升级到 2022.3.x 或更高版本之前,只需运行该工具一次。

重要

  • 如果您要从 2022.1 或更低版本升级,请在升级到 2022.3 以上版本之前运行“迁移准备”工具。

  • 如果您从 2022.3 以上版本升级,则您的数据库已加密迁移,无需运行“迁移准备”工具。

注意

我们为什么要创建此工具?

Server 正在更新其加密机制,以针对静态数据使用 AES256。所有现有的加密存储数据都需要从当前的加密方法迁移到新的加密方法。当您的 Server 处于生产状态时,可以在升级到 2022.3 之前迁移其中一些数据。

需要迁移的最耗时的数据是存储在 Server 中的应用程序和工作流。在升级到 Server 2022.3 时,可以提前迁移这些数据以节省时间。

Alteryx 创建了迁移准备工具来帮助您在升级前迁移这些数据。

应在何时使用迁移准备工具

我们建议您在以下情况下运行迁移准备工具:

  • 如果您正在升级的 Server 安装是停机时间不能超过几个小时的生产系统或开发系统,

  • 您有数百个工作流,并且

  • 您运行的是 MongoDB Atlas 或用户管理的 MongoDB。

即使这些情况不适用于您,最佳做法是在尝试升级之前运行“迁移准备”工具以确保成功。

此外,您还可能要考虑 db.AS_App_Chunks.dataSize()AS_PackageDefinitions 的大小。但是,对于何时应在准备模式下运行迁移准备工具,我们目前尚无针对数据库大小的建议。

如果您只有几个工作流,或者您不介意 Server 升级需要几个小时到几天的时间,则可以不使用“迁移准备”工具,而是运行标准 Server 安装程序以升级到 2022.3。停机时间将比平时更长,因为加密迁移将是升级的一部分。

注意

如果您选择在升级前不运行迁移准备工具,该工具将在 2024.1 升级安装的过程中安装和运行。

传输前检查

要在升级到 2022.3 或更高版本之前评估您可能需要解决的任何预期问题,请在迁移准备工具中进行传输前检查。

重要

只能对使用 64 字符控制器令牌的 Server 实例进行传输前检查。

  • 如果您的 Server 版本为 2021.3 或更早版本,您需要先升级至 2022.1 版本,然后再继续执行后续步骤。

  • Alteryx 系统设置 > Controller > General > Token > View 中检查控制器令牌的长度。

    如果您的令牌长度为 40 个字符,请选择重新生成以创建新令牌。然后选择确定以重新启动 AlteryxService 并创建新令牌。

在预迁移或完全迁移过程中,您将能够看到错误日志,以便您能够自己解决问题。借此,您可以采取建议操作,以确保即使出现任何错误也能成功完成全部迁移。

运行迁移准备工具时,我们添加了 3 个新的运行选项

  • 默认:同时运行预迁移和预迁移检查 (-p)

  • 只运行预迁移(应用程序)(--appsonly)

  • 只运行凭证验证步骤 (--credonly)

运行迁移准备工具时,必须提供控制器令牌 (-t) 和控制器的主机名/IP 地址 (-i)。这也意味着您现在可以提供控制器的主机名/IP 地址和控制器令牌,通过多节点设置运行迁移准备工具。

请注意,2 个迁移准备工具实例不能同时为同一控制器运行。