运行迁移准备工具
开始之前
迁移准备工具会创建存储在数据库中的工作流数据的暂存副本。在此过程中,迁移准备工具将为您提供继续执行操作所需的预估空间。除非有足够的可用空间,否则请勿继续执行操作。
警告
您必须手动验证是否有足够的空间来完成此过程。迁移准备工具无法验证可用空间。
步骤 1:安装迁移准备工具
按照以下步骤安装 Runner 工具:
# | 步骤 |
---|---|
1.1 | 从 https://downloads.alteryx.com 下载安装程序并运行。 |
1.2 | 接受最终用户许可协议。 |
1.3 | 选择安装路径或接受默认路径。 |
1.4 | 按照提示完成安装。 |
步骤 2:启动迁移准备工具
按照以下步骤启动迁移准备工具。
# | 步骤 |
---|---|
2.1 | 打开命令提示符或 PowerShell。 |
2.2 | 导航至所选的安装路径(默认路径:
|
2.3 | 执行这 3 个命令中的一个,以运行迁移准备工具。
注:
如果使用PowerShell,请将
您可以在任何有权访问 MongoDB 服务器的主机上运行此操作。您可以安全地运行此操作多次,而不会造成停机。 #与嵌入式MongoDB或单个用户管理的MongoDB服务器一起使用的示例:
这可能类似于以下示例。请注意,"
#与MongoDB副本集一起使用的示例:
#与MongoDB Atlas一起使用的示例:
|
2.4 | 迁移开始时,系统将显示提示,请您确认是否已备份数据库和运行时设置文件: |
2.5 | 确认备份后,该实用程序将检查当前的空间使用情况。它将为您预估迁移所需的额外空间。您必须检查您的系统,并仅在您确定有足够的可用空间时,再继续执行操作。 |
2.6 | 在您确认有足够的可用空间后,实用程序会开始迁移工作流数据。您将看到指示开始时间和完成时间的控制台消息以及进度消息。 |
疑难解答
如果在迁移过程中发生错误,该错误将显示在控制台中,并且还会捕获到日志文件中。
如果遇到错误,请执行以下步骤:
捕获命令提示符的屏幕截图。
遮盖或删除任何敏感数据。
捕获日志(请参阅位置和命名的验证步骤)。
再次运行迁移。
如果迁移再次失败,请联系支持人员并在报告中添加屏幕截图和日志文件。
步骤 3:升级到 Server 2022.3
重要
在升级之前,请创建 Mongo 数据库的备份副本 和 RuntimeSettings.xml 。在维护期内执行的加密是不可逆的。备份可保护您的安装免受数据丢失或额外停机时间的影响。
在 2022.3 升级期间,无法查看迁移进度。
如需详细了解升级,请参阅 安装或升级 Server 。
# | 步骤 |
---|---|
3.1 | 下载 2022.3 安装程序并运行。 |
3.2 | 接受许可协议。 |
3.3 | 选择您的安装路径或接受默认路径。 |
3.4 | 开始安装。 |
3.5 | 等待安装完成。 |
3.6 | 安装完成后,选择 立即配置 Server 选项。 注意 Server 2022.3 安装完成后,启动服务可能会出现延迟。 |
3.7 | 系统将打开 Alteryx 系统设置 。浏览 系统设置 以检查设置是否正确。然后依次单击 完成 和 完成 以启动服务。 |
3.8 | 服务启动后,Server 会进入维护模式以迁移 RuntimeSettings 和之前无法迁移的数据库值。在维护模式期间,您的 Server 实例将不可用。 |
3.9 | 迁移准备工具会对自上次运行以来做出的数据库更改进行最终检查。然后执行迁移(包括任何新发现的更改),并将暂存的迁移投入使用。 |
3.10 | 此最终迁移可能需要几个小时的时间。时间取决于配置的大小以及升级前是否运行了迁移准备工具。此过程完成后,Server 应退出维护模式并进入正常工作状态。 |
疑难解答
如果服务在一段时间后关闭,请检查这些日志中是否存在迁移错误:
LastStartupError.txt
由迁移准备工具创建的 AlteryxServiceMigrator_#.log
在服务启动期间创建的 AlteryxServiceMigrator_#.log
如果遇到迁移错误,请尝试重新启动 AlteryxService。尝试重新启动 AlteryxService 后,可能会解决问题。如果问题仍然存在,请收集日志并联系客户支持人员寻求帮助。尝试重启 AlteryxService 有可能会解决问题,因为它将重新尝试任何未完成的迁移步骤,但具体结果还要取决于错误。
哪些因素可能导致迁移失败?
有 2 种失败情况:
该记录无法解密。这意味着存在一条已损坏的记录,用户需要从表格中将其移除(如果合适的话,先备份再移除)。
该记录无法重新加密。解决方案与前一种情况相同。
其他失败情况通常是环境问题。解决这些问题的方法是修复环境问题,然后再次运行该实用程序。例如,与 MongoDB 的连接中断和磁盘空间不足。
步骤 4:验证迁移成功
要验证迁移准备工具是否已成功完成,请选择以下任一选项。
验证迁移准备工具日志
导航至
C:\ProgramData\Alteryx\Service\
。打开 AlteryxServiceMigrator_#.log 。
查看日志以找到错误或失败消息。在日志中搜索显示为“ ;3; ”的状态 3。
验证服务启动日志
依次点击 Alteryx 系统设置 > Controller > General > Logging ,找到所设置的日志记录文件夹。
打开 AlteryxServiceMigrator_#.log 。
查看日志以找到错误或失败消息。在日志中搜索显示为“ ;3; ”的状态 3。
升级到 2022.3 后(最终迁移后)进行验证
通过 Web URI 登录 Server。
验证以下各项:
您可以手动运行工作流程和应用程序。
计划处于活动状态且运行结果符合预期。
您可以查看、编辑、创建和使用工作流凭证。
您可以查看、编辑、创建和使用 Server 数据连接。
从 API 检索工作流包,将该包导入 Designer,然后在 Designer 中运行工作流。