运行迁移准备工具
重要
只能使用此工具从 Server 2022.2 版或更早版本迁移。2022.3 版更新了加密机制。
开始之前
迁移准备工具会创建存储在数据库中的工作流数据的暂存副本。在此过程中,迁移准备工具将为您提供继续执行操作所需的预估空间。除非有足够的可用空间,否则请勿继续执行操作。
警告
您必须手动验证是否有足够的空间来完成此过程。“迁移准备”工具无法验证可用空间。
步骤 1:安装迁移准备工具
从 downloads.alteryx.com 下载并运行安装程序。
接受最终用户许可协议。选择下一步。
要更改安装位置,请选择更改。或者选择下一步接受默认位置。
按照提示完成安装。
步骤 2:启动迁移准备工具
打开命令提示符或 PowerShell。
导航至所选的安装路径(默认路径:
C:\Program Files\Alteryx Migration Tool\
)。运行其中一个命令,以运行迁移准备工具。注意:如果使用 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 在重新加密之前,将临时存储已解密工作流的目录
迁移开始时,系统将显示提示,请您确认是否已备份数据库和运行时设置文件。
确认备份后,该实用程序将检查当前的空间使用情况。系统将为您预估迁移所需的额外空间。您必须检查您的系统,并仅在您确定有足够的可用空间时,再继续执行操作。
在您确认有足够的可用空间后,实用程序会开始迁移工作流数据。您将看到指示开始时间和完成时间的控制台消息以及进度消息。
疑难解答
如果在迁移过程中发生错误,该错误将显示在控制台中,并且还会捕获到日志文件中。
如果遇到错误,请执行以下步骤:
捕获命令提示符的屏幕截图。
遮盖或删除任何敏感数据。
捕获日志(请参阅位置和命名的验证步骤)。
再次运行迁移。
如果迁移再次失败,请联系 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。
从 downloads.alteryx.com 下载 Server 2024.1。
运行安装程序。选择是继续升级。
接受许可协议。
选择您的安装路径或接受默认路径。然后选择下一步。
选择安装开始安装(升级)。
安装完成后,选择 Configure Server now,然后选择 Finish。
Server 2024.1 安装完成后,选择开始备份和迁移选项。
迁移成功后,选择确定。
请注意:安装完成后,启动服务可能会出现延迟。
系统将打开 Alteryx 系统设置。浏览系统设置以检查设置是否正确。然后依次选择完成和已完成以启动服务。
服务启动后,Server 会进入维护模式以迁移 RuntimeSettings 和之前无法迁移的数据库值。在维护模式期间,您的 Server 实例将不可用。
迁移准备工具会对自上次运行以来做出的数据库更改进行最终检查。然后执行迁移(包括任何新发现的更改),并将暂存的迁移投入使用。
此最终迁移可能需要几个小时的时间。时间取决于配置的大小以及升级前是否运行了迁移准备工具。此过程完成后,Server 应退出维护模式并进入正常工作状态。
疑难解答
如果服务在一段时间后关闭,请检查这些日志中是否存在迁移错误:
LastStartupError.txt
由迁移准备工具创建的 AlteryxServiceMigrator_#.log
在服务启动期间创建的 AlteryxServiceMigrator_#.log
如果发生迁移错误,请尝试重新启动 AlteryxService。这样可能会解决问题,因为将重新尝试任何未完成的迁移步骤。如果问题仍然存在,请收集日志并联系客户支持人员寻求帮助。尝试重启 AlteryxService 有可能会解决问题,因为它将重新尝试任何未完成的迁移步骤,但具体结果还要取决于错误。
步骤 4:验证迁移成功
要验证迁移准备工具是否已成功完成,请选择以下任一选项。
验证迁移准备工具日志
导航至
C:\ProgramData\Alteryx\Service\
。打开 AlteryxServiceMigrator_#.log。
查看日志以找到错误或失败消息。在日志中搜索显示为“;3;”的状态 3。
验证服务启动日志
依次点击 Alteryx 系统设置 > Controller > General > Logging,找到所设置的日志记录文件夹。
打开 AlteryxServiceMigrator_#.log。
查看日志以找到错误或失败消息。在日志中搜索显示为“;3;”的状态 3。
升级到 2024.1 后(最终迁移后)进行验证
通过 Web URI 登录 Server。
验证以下各项:
您可以手动运行工作流程和应用程序。
计划处于活动状态且运行结果符合预期。
您可以查看、编辑、创建和使用工作流凭证。
您可以查看、编辑、创建和使用 Server 数据连接。
从 API 检索工作流包,将该包导入 Designer,然后在 Designer 中运行工作流。