Skip to main content

Server 主机恢复指南

本指南旨在帮助服务器管理员在以下情况下恢复服务器实例:原始主机或主机发生故障,迁移到新的升级服务器,从本地迁移到云服务器,以及基础结构发生更改的其他情况。

服务器恢复允许您获得一个新的服务器运行与您的原始用户,工作流,计划等,基于从您的原始服务器的以下内容:

  • 控制器令牌

  • 来自 控制器 节点的RuntimeSettings.xml

  • MongoDB 备份

以下是流程每个步骤的详细信息:

1 -准备

2 -恢复RuntimeSettings.xml

3-恢复MongoDB

4 -恢复其它文件和设置

5-启动 Alteryx Server

6 -测试

可恢复范围

  • 恢复 使用嵌入式 MongoDB 的单一默认 Server 安装 上出现的失败。

  • 可用备份包含完整的必要信息。

  • 目标计算机可被覆盖。

不在可恢复范围内

  • 多节点 Server 环境或用户管理的 MongoDB - 请联系客户支持以获得帮助。

  • 合并连接文件数据库。

  • 备份或还原 ODBC 驱动程序。

  • 备份或还原用户或系统 DSN。

  • 备份或还原存在于 Alteryx 之外的 Windows 中存储的其他别名。

先决条件

  • 在完成本指南中列出的步骤之前,请安装工作流操作所需的所有数据库驱动程序和软件,以尽可能降低停机时间。

  • 具有对目标服务器的管理员权限。

  • 具有所有用于模拟使用者的凭证,包括服务帐户(如果不是本地系统)、Run As(运行身份)以及任何已经定义/已使用的工作流凭证。

  • 来自原始 Server 的控制器令牌。

  • 要访问来自原始 Server 的 RuntimeSettings.xml,请访问以下路径: %PROGRAMDATA%\Alteryx\RuntimeSettings.xml

  • 将原始 Server 的 MongoDB 进行备份。 了解如何执行备份。

    • 有关“Server 备份和恢复”的详细信息,请参阅“Server 备份和恢复最佳实践”: 第 1 部分 第 2 部分

  • 在 Windows 时区设置中,确信目标 Server 的时区设置与原始 Server 相同。如果未设置为同一时区,在计划视图中可能会出现错误。

可选

原始 Server 中可能未利用以下各项。检查是否使用了以下功能,并完成本指南中标记为 (可选) 的相应步骤。

  • 服务登录用户(如果使用)。

  • 工作程序配置中的 Run As(运行身份)详细信息:

    • 用户名

    • 密码

  • 用于 Server 配置的 SMTP 服务器用户名和密码。

  • 来自 %ProgramData%\Alteryx\Tools的连接器。

  • 原始 Server 的基于 Alteryx 系统的别名和库内连接别名。

    • 有关系统数据库数据连接,请查看 %PROGRAMDATA%\Alteryx\Engine\SystemConnections.xml

    • 有关系统数据连接,请查看 %PROGRAMDATA%\Alteryx\Engine\SystemAlias.xml

  • 原始 Server 的基于 Alteryx 用户的别名和库内连接别名 – 以下可能与 每个 Run As(运行身份)或工作流凭证用户帐户相关

    • 用户数据连接参见 C:\USers\[用户名]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

    • 用户In-DB数据连接参见 C:\USers\[用户名]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

步骤1:准备

#

步骤

详情

1.1

设置机器时区

新机器的Windows时区必须设置为与原始机器匹配。

1.2

确保访问 Alteryx

确保计算机可以连接到 Alteryx 许可系统所使用的网域 whitelist.alteryx.com  。

1.3

安装相同版本的Server

执行生成Mongo备份的同一版本服务器的全新安装。

使用本季度的最新维护版本,例如,如果您的备份版本为2022.4。 2 和2022.4。 5 维护版本可用,请使用该版本。如果您的版本仍无法在 http://downloads.alteryx.com上获得 ,请联系 fulfillment@alteryx.com

安装或升级 Server

测试服务器UI出现在浏览器中,您无需登录。

1.4

排错

许可证密钥"使用中"错误

如果您的许可证密钥仍绑定到旧服务器,则需要在该计算机上停用它。如果该计算机无法访问,请联系您的许可证管理员以释放许可证。

步骤2:恢复RuntimeSettings.xml

#

步骤

详情

2.1

打开bin文件夹中的命令提示符1

以管理员身份打开命令提示符并导航至Alteryx\bin文件夹,输入以下命令(根据您的安装位置进行调整)。

C:CD \Program Files\Alteryx\bin

2.2

停止服务

输入命令

命令:net stop alteryxservice

成功后,您应看到 “已成功停止 AlteryxService 服务。”

2.3

备份现有 RuntimeSettings.xml

输入命令

C:cd \ProgramData\Alteryx ren RuntimeSettings.xml RuntimeSettings_BACKUP.xml

2.4

还原 RuntimeSettings.xml

RuntimeSettings.xml 文件从原始服务器复制到当前的 %ProgramData%\Alteryx\目录。

2.5

缺少控制器令牌

编辑刚刚复制的 RuntimeSettings.xml 并删除 <ServerSecretEncrypted> 标签之间的所有内容,仅保留标签,如下所示:

64ae505fe2c2c.png

保存并关闭文件。

2.6

缺少控制器令牌

使用原始服务器控制器令牌输入命令

AlteryxService.exe setserversecret=controller_token_from_original_Server

疑难解答

版本2021.3+在此步骤上可能会出现以下错误:"设置服务器机密失败:错误:错误 CryptImportKey(3)数据。(- 2146893819)"。要纠正此问题,请参阅上一步,以确保从标签之间删除该值。

2.7

恢复 加密存储密钥

步骤 2.6 中重置控制器令牌时, <StorageKeysEncrypted> 值可能已更改。如果是这样,则应将其替换为原始 RuntimeSettings.xml 文件中的值。如果需要,在原始计算机上打开 ProgramData%\Alteryx\RuntimeSettings.xml,以获取所需的值。最简单的方法是同时复制标签,以确保原始 RuntimeSettings.xml 文件标签之间的整个值得以复制。当您在 步骤 3 中做进一步更改时,RuntimeSettings.xml 可以在文本编辑器中保持打开状态。

Step 2.7 Restore Encryption Keys

2.8

Run As(运行身份)

如果在原始服务器上有"以用户身份运行",请输入以下命令,否则跳过此步骤。 AlteryxService.exe setexecuteuser=name,domain,password

2.9

恢复 SMTP密码

如果已填写 Alteryx 系统设置 > Server UI > SMTP > Password (即使未选中SMTP复选框),请输入以下命令,否则跳过此步骤。 AlteryxService.exe setsmtppassword=password

2.10

保存 RuntimeSettings.xml

保存RuntimeSettings.xml文件。

2.11

传输 加密密钥

此功能仅适用于以下版本:

  • 2021.4.2 补丁 11+

  • 2022.1 补丁 9+

  • 2022.3 补丁 6+

  • 2023.1 补丁 2+

  • 2023.2 GA+

重要

请注意,这要求 AlteryxService 在您的原始 Server 控制器节点上运行,并且您的新 Server 需要能够通过网络进行访问。

您可以按照 加密密钥传输过程 的步骤将加密密钥从现有控制器传输到新控制器。加密密钥传输过程

2.12

保持在命令行上

步骤 3 假定您在 \Alteryx\bin 文件夹中且位于管理员命令行上。

步骤3:恢复MongoDB

#

步骤

3.1

获取MongoDB备份

将Mongo备份从原始服务器复制到 新服务器上的Mongo备份文件夹。

3.2

恢复到新文件夹

将 Mongo 数据库从备份文件夹恢复到新的还原文件夹。最后一个参数 ,10 可确保恢复期间 MongoDB 的内存使用量较低。这可以降低内存不足错误的几率,但可能会增加恢复时间。去掉 ,10 可能会加快恢复速度。在这两种情况下,请按照下面的说明检查 mongoRestore.log ,以确保还原成功。

AlteryxService.exe emongorestore="MONGO_BACKUP_FOLDER","MONGO_RESTORE_FOLDER",10

示例:

AlteryxService.exe emongorestore="D:\db_bkp","%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore",10

3.3

确认恢复成功

确认恢复成功。

注意

这是必要步骤,因为还原失败不会在上一步中报告,并可能导致您 Server上的数据丢失。为此,请找到已恢复数据的 MongoDB 文件夹,查看 mongoRestore.log 文件。打开 mongoRestore.log 并执行以下步骤:

  • 确认最后一行报告 #### document(s) restored successfully, 0 document(s) failed to restore(文档已成功恢复,并且所有文档均成功恢复)

  • 搜索 error(错误) critical(严重) fatal(致命) failed(失败) 。如果您正在寻找 failed ,请确保结果与上一点中的句子不同,其中包含 0 document(s) failed(0 个失败的文档)

如果恢复失败,或者在搜索上面列出的关键字时找到任何结果,请 联系支持部门 并提供您收集的所有信息。

如果 MongoDB 恢复失败,请勿继续操作。

3.4

在RuntimeSettings.XML中设置Mongo路径

编辑 RuntimeSettings.xml 并在 <EmbeddedMongoDBRootPath> 标签中输入 MONGO_RESTORE_FOLDER 的路径。

示例:

Set Mongo path in RuntimeSettings.XML

保存并关闭文本编辑器。

3.5

启动MongoDB

输入命令

Mongod––dbpath "mongo_restore_folder"––auth––port 27018

示例

Mongod––dbpath "%ProgramData%\Alteryx ervice\Persistence\Mongo_Restore"\S––auth––port 27018

请勿关闭命令提示符窗口。

如果您在 步骤 3.5 中关闭窗口,则后续步骤都将无法进行。

<<第二个命令提示符部分开始>>

3.6

打开bin文件夹中的第二个命令提示符

以管理员身份打开第二个命令提示符 并导航至 Alteryx\bin 文件夹,输入以下命令(根据您的安装位置进行调整)。

C:CD \Program Files\Alteryx\bin

3.7

获取非管理员Mongo密码

输入命令并将 non_admin_mongo_password复制 到记事本

AlteryxService.exe getemongopassword.

3.8

启动Mongo命令行

输入命令

mongosh mongodb://SERVER:PORT/AlteryxGallery -u user -p NON_ADMIN_MONGO_PASSWORD

示例

mongosh mongodb://localhost:27018/AlteryxGallery -u user -p CCEC***33C0

成功后,您应看到 ">" 提示。

3.9

删除由原始服务器设置的锁定

输入Mongo命令

db.locks.remove({})

如果成功,您应该会看到:" writeResult ({"nremoved": N })",其中N是介于0和3之间的数字。

3.10

退出Mongo命令行和 命令提示符2.

输入命令

退出

关闭 Command_Prompt_2

<<第二个命令提示符部分结束>>

3.11

停止Mongo数据库

在原始命令提示符下,输入keyboard命令

Ctrl-c

一次或多次,直到您退出MongoDB并返回正常的命令提示符。

关闭两个命令提示符。

步骤4:还原其他文件和设置

#

步骤

详情

4.1

在原始服务器上是否有服务登录用户?

在新服务器上设置服务登录用户。

Windows服务应用程序 >右键单击 AlteryxService > 属性 > 登录

4.2

添加数据驱动程序和系统DSN。

添加 相同版本的 驱动程序和 相同名称的 系统DSN以匹配原始服务器 https://downloads.alteryx.com/

可能不适用于恢复的高级问题:

4.3

在更安全的环境中,配置所需的"运行方式"用户权限。

确保用于运行工作流的所有凭证 (运行方式,服务登录或保存工作流时设置的凭据)具有适当的足够访问权限, 配置所需的运行用户权限

4.4

还原基于系统和In-DB连接别名

没有数据连接。

%ProgramData%\Alteryx\Engine\SystemAlias.xml

系统In-DB数据连接:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

恢复基于用户和用户数据库内连接别名

没有数据连接。

C:\USers\[用户名]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

用户In-DB数据连接:

C:\USers\[用户名]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

4.6

工作流是否使用连接器?

将Connector文件夹从原始服务器复制到

\ProgramData\Alteryx\Tools

联系 客户支持 ,以在新 Server 上启用连接器。

4.7

工作流是否使用 Python工具?

重新安装工作流已安装的 Python 软件包。请参阅 Server Upgrade Python Tool Environment Checklist

4.8

工作流是否使用 R工具?

即将推出...

4.9

您是否拥有多节点环境或用户管理的Mongo?

(即将推出)请联系您的客户经理或 客户支持

4.10

是否使用SSL?

如果要恢复到沙盒服务器进行测试,请使用HTTP进行测试。

如果要迁移到新服务器,请重新建立SSL:

配置 Server SSL/TLS

为 Alteryx Server配置SSL获取和安装证书(15577)

步骤5:启动 Alteryx Server

#

步骤

详情

5.1

查看 Alteryx 系统设置,如果需要,暂停计划。

运行 Alteryx 系统设置并 逐步浏览每个页面,确认设置(如控制器令牌)包含您期望的值。

如果不希望在服务启动时运行计划,请取消选中:

工作程序 >常规 > 允许计算机运行计划的 Alteryx工作流

选择 Finish 时,AlteryxService 应启动,且 Server 在浏览器中应可用。

重要

请特别注意" 服务器UI配置 "设置,因为新服务器可能具有不同的URL或没有SSL证书。

System Settings, the Server UI configuration section.

步骤6:测试

#

步骤

详情

6.1

基本测试

AlteryxService 是否在运行?

您能否:

  • 是否访问服务器UI URL?

  • 在Admin页面中移动并查看用户,集合等?

  • 是否将工作流从 Designer发布到服务器?

  • 运行工作流:

  • 如果您的配置允许,请保存并运行指定凭证的工作流。

6.2

特定于工作流程的测试

您是否可以运行包含扩展或外部连接(如)的工作流

  • 网络UNC路径的输入/输出

  • 数据库连接

  • 接口工具

  • 位置或业务见解数据集

  • Python 工具

  • R 工具