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 2024.1

重要

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

  • 在 2024.1 升级期间,无法查看迁移进度。

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

  1. downloads.alteryx.com 下载 Server 2024.1。

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

  3. 接受许可协议。

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

  5. 选择安装开始安装(升级)。

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

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

  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。

升级到 2024.1 后(最终迁移后)进行验证

  1. 通过 Web URI 登录 Server。

  2. 验证以下各项:

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

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

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

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

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