您的 Server 配置是唯一的，升级它是一个需要规划和准备工作才能成功的项目。此检查列表可确保您考虑到升级时可能需要的所有任务，并指导您查看“帮助”和"知识库"文章，以了解详细的分步过程。
如果您希望获得准备或执行升级方面的帮助，请咨询您的客户主管以了解相关选项。
|
高级
|
高级
|
|
|
在升级生产 Server 之前测试升级过程是确保 Server 升级过程在生产环境中顺利进行的最佳方法。
理想情况下，从相同版本的沙箱/开发/测试 Server 开始并升级，请参阅 Alteryx Server 沙箱环境。如果您有一个多节点环境，那么在运行控制器 + Server UI + 工作程序的单台计算机上，测试仍然有效。类似地，如果您有一个用户管理的 MongoDB，那么将数据库备份还原到测试计算机的嵌入式 Mongo 可以帮助验证升级。如需了解沙箱使用许可，请联系您的客户主管。
至少，您应该在用户的计算机上安装 Designer 的目标版本，以在新版本中测试关键工作流。如需了解详情，请参阅 在同一台计算机上安装两个版本的 Designer。
理想过程：
问题/步骤 | 注意事项/链接 |
|---|---|
选择目标版本。 | 版本到版本 Server 升级指南 - 升级时应注意的具体事项。
|
了解您的当前版本以便回滚。 | 您可以通过以下方式找到您的当前版本：
|
确认有足够的可用空间。 重要 空间不足会导致升级失败。 | 如果您使用嵌入式 MongoDB，并且 版本到版本 Server 升级指南 指示 MongoDB 版本将升级，请确认有足够的可用空间： |
确定验证工作流。 | 确定用于验证升级的工作流。这些工作流包括：
|
计划如何在升级过程中管理计划的工作流。 | 默认情况下，应该在 Server 升级时运行的计划将在 Server 和节点重新启动后立即执行。您可以暂停所有计划，并确定应单独运行的计划（在 升级部分 中进行了说明）。 |
可能不适用于升级的高级问题： | |
工作流是否使用连接器工具？ | 连接器是独立安装的，必须与您的新 Server 版本兼容。您可以通过 %ProgramData%\Alteryx\Tools 下的文件夹名称来确定所安装的连接器和版本。 查看每个连接器，确保与您的新 Server 版本兼容，以确定 Server+ 连接器版本的兼容性：
如果 Python 版本在 Server 升级过程中进行了升级，则必须重新安装所有基于 Python 的连接器。在安装过程中，YXI 文件会考虑当前的 Python 版本（因此，在使用不同 Python 版本的 Designer/Server 版本中运行时，同一个 YXI 文件将执行不同的安装）。在 Alteryx 嵌入式 Python 中查看 Server 版本所使用的 Python 版本。 |
工作流是否使用 Python 工具？ | |
您的组织是否需要维护 MongoDB 的供应商支持？ | |
您的 MongoDB 是否由用户管理？ | |
是否要在嵌入式 MongoDB 和用户管理的 MongoDB 之间进行更改？ | 请勿同时执行 Server 升级和 MongoDB 迁移，这是两个独立的项目。 |
是否要从本地部署迁移到云？ | 请勿同时执行 Server 升级和云迁移，这是两个独立的项目。 |
您是否使用 Connect 产品？ | |
问题/步骤 | 注意事项/链接 |
|---|---|
运行升级前检查。 重要 跳过此步骤是导致大多数服务器升级失败的原因。 | |
如果升级到 2022.3 或经过 2022.3 升级到其他版本，请运行加密迁移准备工具。 | |
停止 Server 并备份 MongoDB 和其他关键信息。 | |
停止 Server。 | 顺序：Workers（工作程序）（等待作业完成）… Server UI … Controller（控制器）… [用户管理的 MongoDB] |
备份 Mongo 数据库。 重要 服务器快照不足以满足要求，因为如果在拍摄快照时服务正在运行，它可能会还原损坏的 MongoDB。 | 从命令行执行 MongoDB 备份（根据文件夹结构进行调整）。
|
备份 RuntimeSettings.xml、控制器令牌和服务登录用户。 |
|
（可选）备份其他设置。 | |
（可选）执行快照备份。 | 在拍摄快照之前停止 AlteryxService。如果需要回滚，您可以尝试使用快照，并将上述 MongoDB 备份作为安全保障。 |
问题/步骤 | 注意事项/链接 |
|---|---|
如果要迁移到新 Server 或在测试 Server 上测试升级，请执行以下操作： | |
对新 Server 或测试 Server 执行 Server 主机恢复 | |
升级前进行测试。 警告 请勿跳过此步骤。 | 在升级之前，按照下面的 测试部分 确保迁移成功，以便更轻松地进行故障排除。 |
如果就地升级（在同一台计算机上），请执行以下操作： | |
是否要在升级后暂停计划？ | 如果不希望在服务启动时运行计划：在每个 Worker（工作程序）上运行 Alteryx 系统设置，取消选择 Worker（工作程序）> General（常规）> Run unassigned jobs（运行未分配的作业），然后为工作程序指定一个唯一的Job tag（作业标记）。或者，请联系客户支持部门以获得删除所有计划的帮助。 |
停止 Server | 顺序：Workers（工作程序）（等待作业完成）… Server UI … Controller（控制器）… [用户管理的 Mongo] |
升级 |
提示 保存安装程序，以防将来升级后需要回滚到此版本。 |
您是否在 准备工作部分 中设置了服务登录用户？ | 升级后重置服务登录用户： Windows 服务应用程序 > 右键单击 AlteryxService > 属性 > 登录 提示 今后，请考虑改为使用 Alteryx 系统设置 > Worker（工作程序）> Run As（运行身份）用户，因为它不会在升级过程中丢失。 |
执行特定于版本的任务 |
|
可能不适用于升级的高级问题： | |
您是否有多节点环境？ | 所有节点必须升级到相同版本。 重启顺序：[用户管理的 Mongo] … Controller（控制器）… Server UI … Workers（工作程序） |
工作流是否使用连接器工具？ | 如果需要升级连接器以保持与新 Server 版本兼容，请安装连接器的升级版本，并删除不兼容的连接器文件夹。 从 Server 中删除连接器版本后，使用该版本的现有工作流将停止运行，并显示错误消息“错误：无法解析插件 Python‘XXXXX\main.py’（工具 Id：X）”。 用户需要：
|
问题/步骤 | 注意事项/链接 |
|---|---|
如果正在升级，请查看 MongoDB 架构迁移文件 | 确认架构已迁移到新 Server 版本所需的版本
在接近末尾处查找一个数字与预期架构相匹配的行
如果迁移未达到预期水平，请参阅 故障排除部分。 |
基本 Server 测试 | AlteryxService 是否在运行？ 您能否：
|
测试验证工作流 | 测试 规划部分 中确定的验证工作流。如果这会产生重复记录或导致您的组织出现其他数据完整性问题，请确认这些工作流不会将数据输出到生产位置或数据库。 |
问题 | 故障排除 |
|---|---|
Mongo 架构迁移未完成或出现错误。 | 导致出现此问题的最常见原因是，未运行升级前检查工作流或未更正所发现的问题。 |
访问 UNC 位置时工作流中出现 UNC 网络位置错误。 | 确保正确设置了 Run As（运行身份）用户或 服务登录用户，并且这些用户有权访问网络位置。 |
使用 DSN 访问数据库时出现 ODBC / DSN 错误。 | 比较旧计算机上的 ODBC 驱动程序版本和 ODBC 系统 DSN。寻找版本或拼写差异。下载支持的驱动程序。 |
访问库内连接时出现库内连接错误。 | 从原始 Server 复制文件：
|
连接器工具错误 | 请参阅 连接器故障排除。 |
回滚 | 如需回滚，请参阅 Alteryx Server 降级。 |
客户支持帮助 | 如果您在升级过程中遇到错误，并且无法使用上述常见故障排除文章来解决该错误，客户支持部门可以提供帮助。如果您在规划或执行升级时需要帮助，您的客户主管可以提供相应方案。 案例优先级 标准 1：
标准 2：付费支持级别 |
应向客户支持部门提供哪些信息？ | 为确保客户支持部门可以立即开始故障排除，请在您的支持请求中包含以下信息：
|