Skip to main content

Alteryx Server 降级

本文提供了有关如何进行 Alteryx Server 降级的指南。

Alteryx Server 升级升级有时会导致无法预见的复杂情况,从而迫切需要解决相应问题或降级以避免服务中断。您可以使用我们的 “社区”页面 上的资源解决大多数问题,或联系 Alteryx 技术支持。在某些情况下,您bu'de'bu还原到最近的正常工作版本才能解决潜在问题。

注意

在降级之前,您可以搜索 Alteryx 社区 查找降级原因,以及联系 Alteryx 技术支持 进行相关讨论。

重要

请确保在升级之前 备份 MongoDB 。否则,您将无法降级。

Environment(环境)

  • Alteryx Server(所有版本)

  • 嵌入式 MongoDB(所有版本)

先决条件

  • 您必须拥有 Server 计算机的管理员权限。

  • 执行降级所需的 Server 停机时间(维护)窗口。

    不一定要安排 Server 停机时间窗口,具体取决于您内部de规定。停机时间窗口的长度取决于您的设置和数据库的大小。

  • 您要降级到的以前 Server 版本的安装程序文件。

  • 从您要降级到的以前版本获取的 MongoDB 备份。如需了解详情,请参阅 Alteryx Server 备份和恢复程xu 一文。

  • 如果要从 2022.3+ 版降级到 2022.3 之前的版本,则需要备份 RuntimeSettings.xml 文件以升级到 2022.3+ 版: C:\ProgramData\Alteryx\RuntimeSettings.22_2_legacy.xml

Alteryx Server 降级

此过程显示了如何从 Alteryx Server 降级到之前在同一环境中运行的旧版本。在本文中,我们将举例说明如何从 Alteryx Server 2023.1 降级到 2022.3。

  1. 连接到 Alteryx Server。对于多节点环境,连接到托管嵌入式 MongoDB 的控制器节点。

  2. 打开 Services.msc 控制台并 停止 该服务。如需详细了解如何停止服务,请前往 ru'he启动 Alteryx Service ,然后选择 停止 而不是“启动”。

  3. 要打开 控制面板 ,请在 开始菜单 中搜索“控制面板”。

  4. 选择 程序 并卸载 Alteryx Server 2023.1。卸载程序还会自动卸载 Alteryx 预测工具。

    downgrade_Server_01_03.png
  5. 如果您要从 2022.3+ 版降级到 2022.3 之前的版本,则需要还原原始的 RuntimeSettings.xml

    1. 前往 RuntimeSettings.xml 文件所在的文件夹(例如 %ProgramData%\Alteryx\RuntimeSettings.xml),右键单击该文件,然后选择 重命名 。接着将该文件重命名为 RuntimeSettings_rollback_bkp.xml

    2. 在同一文件夹中,将 RuntimeSettings.22_2_legacy.xml 重命名为 RuntimeSettings.xml ,方法是右键单击该文件并选择 重命名

  6. 完全卸载后,运行 2022.3 版(或您要降级到的任何版本)的 Alteryx Server 安装程序。右键单击安装程序文件,然后选择 以管理员身份运行

    注意

    确保您降级到与之前使用的版本完全相同的版本,连补丁级别也必须完全相同。如果您不确定之前使用的是哪个补丁,请降级到该版本的最新补丁。

  7. 选中 许可协议 ,然后选择 下一步

  8. 如果您不使用默认位置,请选择要安装到的文件夹路径,然后选择 下一步

    downgrade_Server_02_02.png
  9. 安装完成后,系统会提示您安装预测工具,如下图所示。如果您打算继续使用此版本,并且工作流依赖于预测工具,请选择 安装预测工具 ,然后选择 完成 。如果不打算使用此版本,请选择 关闭 ,稍后再运行 Alteryx Designer,然后选择 完成

    downgrade_Server_03_02.png

注意

在多节点环境中,对每个节点执行相同的过程。

还原 MongoDB

在下一步中,将 MongoDB 数据库还原到以前的版本。

  1. 此时,Alteryx Service 仍应处于停止状态。要确认,请检查 Services.msc 控制台。

  2. 通过从您要降级到的版本获取的最新 MongoDB 备份还原 MongoDB。如需了解如何还原 MongoDB 并验证还原是否成功,请参阅 “MongoDB 备份”帮助页面上的“从 MongoDB 备份还原”部分

降级后检查

  • 检查 Server UI 是否可访问以及预期内容(例如用户、工作流和计划)是否已成功还原。

  • 检查 Server 日志中是否存在任何意外锁定。在 方法:附加 Server 日志文件 中查看日志文件的位置。如果您看到以下错误,请联系 Alteryx 技术支持 以进行进一步调查。

    • 2020-05-11 15:53:06.564593,FATAL,18,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock->Retry in (1) seconds...,"Lucene.Net.Store.LockObtainFailedException: Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock-context, String name)

    • 2020-05-11 15:33:59.700855,FATAL,20,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Failed to obtain IndexWriter lock.->Retry in (1) seconds...,System.Exception: Failed to obtain IndexWriter lock.-> at Alteryx.Server.Models.BackgroundThread.QueueWorker.RunOnce()

注意

如果您对该流程没有把握,请联系 Alteryx 技术支持 以寻求更多帮助。