Skip to main content

运行迁移准备工具

重要

只能使用此工具从 Server 2022.2 版或更早版本迁移。2022.3 版更新了加密机制。

开始之前

迁移准备工具会创建存储在数据库中的工作流数据的暂存副本。在此过程中，迁移准备工具将为您提供继续执行操作所需的预估空间。除非有足够的可用空间，否则请勿继续执行操作。

警告

您必须手动验证是否有足够的空间来完成此过程。迁移准备工具无法验证可用空间。

步骤 1：安装迁移准备工具

  1. 从 downloads.alteryx.com 下载并运行安装程序。

  2. 接受最终用户许可协议。选择下一步。

  3. 要更改安装位置，请选择更改。或者选择下一步接受默认位置。

  4. 按照提示完成安装。

步骤 2：启动迁移准备工具

  1. 打开命令提示符或 PowerShell。

  2. 导航至所选的安装路径（默认路径：C:\Program Files\Alteryx Migration Tool\）。

  3. 运行其中一个命令，以运行迁移准备工具。注意：如果使用 PowerShell，请在每个命令的开头添加 .\。您可以在任何有权访问 MongoDB 服务器的主机上运行此操作。您可以安全地运行此操作多次，而不会造成停机。

    对于多节点设置，IP 地址/主机名、控制器令牌和 NON_ADMIN_MONGO_PASSWORD 应属于根据多节点设置期间完成的配置运行控制器节点的计算机。

    对于单个节点，详细信息应与安装 Alteryx Server 的同一台计算机有关。

如何使用示例：

将连接字符串中的这些变量替换为适合您环境的值。这些是用于配置 Server 数据库的相同凭证，可以在 Alteryx 系统设置中找到。

  • {authenticationDB} = 将验证指定用户凭证的数据库。

    • 如果您的 Server 配置为使用嵌入式 MongoDB，请使用非管理员 MongoDB 密码。在连接字符串中，您的 authSource 应该是“AlteryxService”。

    • 对于用户管理的 MongoDB，请联系您的 MongoDB 管理员以确认用户凭证和 authSource。

  • {port} = MongoDB 用于提供对数据库的访问权限的服务端口。

  • {host.domain.tld} = MongoDB 服务器的完全限定域名。

  • {password} = 用户的凭证。

  • {user} = 用于访问数据库的用户名。

  • {atlasCluster.cloudProvider.mongodb.net} = MongoDB Atlas 集群地址。

Database（数据库）

示例

嵌入式 MongoDB

请注意：“NON_ADMIN_MONGO_PASSWORD”、“CONTROLLER_TOKEN”和“localhost”应根据您的当前设置进行更改。

应用程序区块和 RunAs_Credentials 迁移

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

仅限应用程序区块迁移

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

仅限 RunAs_Credential 迁移

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

用户管理的 Mongo

请注意：“密码”、“端口”、“host.domain.tld”和“authenticationDB”应根据当前 MongoDB 实例进行更改。

应用程序区块和 RunAs_Credentials 迁移

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

仅限应用程序区块迁移

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

仅限 RunAs_Credential 迁移

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

MongoDB 副本集

应用程序区块和 RunAs_Credentials 迁移

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

仅限应用程序区块迁移

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

仅限 RunAs_Credential 迁移

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

MongoDB Atlas

应用程序区块和 RunAs_Credentials 迁移

AlteryxServiceMigrator22_2.exe -p -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

仅限应用程序区块迁移

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

仅限 RunAs_Credential 迁移

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

命令参数

  • -h [ --help ] 显示帮助信息

  • -q [ --quiet ] 将日志消息输出到命令行（进度消息会忽略此标记）

  • -s [ --severity ] arg (=7) 控制台日志记录严重等级（达到等级 5 时，系统将发送迁移进度报告）

  • -p [ --perform ] 执行迁移

  • --appsonly 仅执行区块迁移，而不执行预检

  • --credonly 执行预检，而不迁移区块

  • -u [ --forcenoprogressupdates ] 禁止将进度更新消息写入控制台（这些消息仍会写入日志文件）

  • -c [ --connection ] arg 连接字符串（必须指定 AlteryxService 数据库）

  • -i [--hostname ] arg 控制器的主机名|ip 地址

  •  -t [--controllertoken ] arg 用于检索密钥的控制器令牌

  • -l [ --loggingpath ] arg (=C:\ProgramData\Alteryx) 日志记录文件路径，必须包含 %N 以便进行日志轮换

  • --loggingmaxfilesize arg (=64) 日志文件在轮替之前的最大大小（以 MB 为单位）

  • -d [- stagingdirectory ] arg 在重新加密之前，将临时存储已解密工作流的目录

接下来会发生什么情况？

  • 迁移开始时，系统将显示提示，请您确认是否已备份数据库和运行时设置文件。 

  • 确认备份后，该实用程序将检查当前的空间使用情况。系统将为您预估迁移所需的额外空间。您必须检查您的系统，并仅在您确定有足够的可用空间时，再继续执行操作。

  • 在您确认有足够的可用空间后，实用程序会开始迁移工作流数据。您将看到指示开始时间和完成时间的控制台消息以及进度消息。

疑难解答

如果在迁移过程中发生错误，该错误将显示在控制台中，并且还会捕获到日志文件中。

如果遇到错误，请执行以下步骤：

  1. 捕获命令提示符的屏幕截图。

  2. 遮盖或删除任何敏感数据。

  3. 捕获日志（请参阅位置和命名的验证步骤）。

  4. 再次运行迁移。

  5. 如果迁移再次失败，请联系 Alteryx 支持人员，并在报告中添加屏幕截图和日志文件。

注意

如果在密钥初始化过程中出现错误<将密钥导入 ProgramData 中的 Microsoft\Crypto\RSA\MachineKeys\ 目录时出现错误：访问会被拒绝。(5)> 运行迁移命令时 RunAS 迁移失败，请导航至 C：\ProgramData\Microsoft\Crypto\RSA\MachineKeys。然后右键单击 MachineKeys 文件夹并选择显示更多选项 > 将访问权限授予 > 特定人员。选择具有读取/写入权限的所有人。然后选择共享。

步骤 3：升级到 Server 2022.3

重要

  • 在升级之前，请创建 Mongo 数据库的备份副本和 RuntimeSettings.xml。在维护期内执行的加密是不可逆的。备份可保护您的安装免受数据丢失或额外停机时间的影响。

  • 在 2022.3 升级期间，无法查看迁移进度。

  • 如需详细了解升级，请参阅安装或升级 Server。

  1. 从 downloads.alteryx.com 下载 Server 2022.3。

  2. 运行安装程序。选择是继续升级。

  3. 接受许可协议。

  4. 选择您的安装路径或接受默认路径。然后选择下一步。

  5. 选择安装开始安装（升级）。

  6. 安装完成后，选择 Configure Server now，然后选择 Finish。

  7. Server 2022.3 安装完成后，选择开始备份和迁移选项。

  8. 迁移成功后，选择确定。

请注意：安装完成后，启动服务可能会出现延迟。

安装完成后的后续步骤

系统将打开 Alteryx 系统设置。浏览系统设置以检查设置是否正确。然后依次选择完成和已完成以启动服务。

服务启动后，Server 会进入维护模式以迁移 RuntimeSettings 和之前无法迁移的数据库值。在维护模式期间，您的 Server 实例将不可用。

迁移准备工具会对自上次运行以来做出的数据库更改进行最终检查。然后执行迁移（包括任何新发现的更改），并将暂存的迁移投入使用。

此最终迁移可能需要几个小时的时间。时间取决于配置的大小以及升级前是否运行了迁移准备工具。此过程完成后，Server 应退出维护模式并进入正常工作状态。

疑难解答

如果服务在一段时间后关闭，请检查这些日志中是否存在迁移错误：

  • LastStartupError.txt

  • 由迁移准备工具创建的 AlteryxServiceMigrator_#.log

  • 在服务启动期间创建的 AlteryxServiceMigrator_#.log

如果发生迁移错误，请尝试重新启动 AlteryxService。这样可能会解决问题，因为将重新尝试任何未完成的迁移步骤。如果问题仍然存在，请收集日志并联系客户支持人员寻求帮助。尝试重启 AlteryxService 有可能会解决问题，因为它将重新尝试任何未完成的迁移步骤，但具体结果还要取决于错误。

步骤 4：验证迁移成功

要验证迁移准备工具是否已成功完成，请选择以下任一选项。

验证迁移准备工具日志

  1. 导航至 C:\ProgramData\Alteryx\Service\。

  2. 打开 AlteryxServiceMigrator_#.log。

  3. 查看日志以找到错误或失败消息。在日志中搜索显示为“;3;”的状态 3。

验证服务启动日志

  1. 依次点击 Alteryx 系统设置 > Controller > General > Logging，找到所设置的日志记录文件夹。

  2. 打开 AlteryxServiceMigrator_#.log。

  3. 查看日志以找到错误或失败消息。在日志中搜索显示为“;3;”的状态 3。

升级到 2022.3 后（最终迁移后）进行验证

  1. 通过 Web URI 登录 Server。

  2. 验证以下各项：

    • 您可以手动运行工作流程和应用程序。

    • 计划处于活动状态且运行结果符合预期。

    • 您可以查看、编辑、创建和使用工作流凭证。

    • 您可以查看、编辑、创建和使用 Server 数据连接。

    • 从 API 检索工作流包，将该包导入 Designer，然后在 Designer 中运行工作流。

本节内容如下: