Skip to main content

运行迁移准备工具

开始之前

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

警告

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

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

按照以下步骤安装“迁移准备”工具。

#

步骤

1.1

https://downloads.alteryx.com 下载安装程序并运行。

Run the installer of the Migration Prep Tool.

1.2

接受最终用户许可协议。

Accept the EULA.

1.3

选择安装路径或接受默认路径。

Choose the installation path or accept the default path. 

1.4

按照提示完成安装。

Follow the prompts to complete the installation.
Follow the prompts to complete the installation.

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

按照以下步骤启动“迁移准备”工具。

#

步骤

2.1

打开命令提示符或 PowerShell。

2.2

导航至所选的安装路径(默认路径: C:\Program Files\Alteryx Migration Tool\ )。

2.3

执行这 3 个命令中的一个,以运行迁移准备工具。 注意: 如果使用 PowerShell,请在每个命令的开头添加 .\

您可以在任何有权访问 MongoDB 服务器的主机上运行此操作。您可以安全地运行此操作多次,而不会造成停机。

#用于嵌入式 MongoDB 或用户管理的单个 MongoDB 服务器的示例:

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

这可能与以下示例类似。请注意,“ NON_ADMIN_MONGO_PASSWORD ”和“ localhost 应根据您当前的设置进行更改。

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService"

#用于 MongoDB 副本集的示例:

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}"

#用于 MongoDB Atlas 的示例:

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

  • 将连接字符串中的这些变量替换为适合您环境的值。这些是用于配置 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 集群地址。

  • 命令参数:

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

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

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

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

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

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

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

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

    • -r [ --runtimesettings ] arg 运行时设置文件路径

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

2.4

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

When the migration starts it will it will prompt you to confirm you have made a backup of the database and your runtime settings file.

2.5

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

Once you confirm the backups, the utility will check current space usage .

2.6

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

After confirming sufficient free space is available, the utility will begin migrating the the workflow data in preparation for the upgrade to 2022.3.

疑难解答

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

如果遇到错误,请执行以下步骤:

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

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

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

  4. 再次运行迁移。

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

步骤 3:升级到 Server 2023.2

重要

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

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

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

#

步骤

3.1

下载 2023.2 安装程序并运行。

Run the installer.

3.2

接受许可协议。

Accept the license agreement.

3.3

选择您的安装路径或接受默认路径。

Choose your installation path or accept the default.

3.4

开始安装。

Start the installation.

3.5

等待安装完成。

Allow the installation to complete.

3.6

安装完成后,选择 立即配置 Server 选项。

Upon completion of the installation choose the ‘Configure Server Now’ option.

注意

Server 2023.2 安装完成后,启动服务可能会出现延迟。

3.7

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

3.8

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

3.9

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

3.10

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

疑难解答

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

  • LastStartupError.txt

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

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

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

哪些因素可能导致迁移失败?

有 2 种失败情况:

  1. 该记录无法解密。这意味着存在一条已损坏的记录,用户需要从表格中将其移除(如果合适的话,先备份再移除)。

  2. 该记录无法重新加密。解决方案与前一种情况相同。

其他失败情况通常是环境问题。解决这些问题的方法是修复环境问题,然后再次运行该实用程序。例如,与 MongoDB 的连接中断和磁盘空间不足。

步骤 4:验证迁移成功

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

验证迁移准备工具日志

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

  2. 打开 AlteryxServiceMigrator_#.log

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

验证服务启动日志

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

  2. 打开 AlteryxServiceMigrator_#.log

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

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

  1. 通过 Web URI 登录 Server。

  2. 验证以下各项:

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

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

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

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

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