Skip to main content

Server 主机恢复指南

本指南旨在帮助 Server 管理员在以下情况中恢复 Server 实例:一台或多台原始主机出现故障、迁移到新升级的 Server、从本地服务器迁移到云服务器,以及与基础架构发生变化相关的其他情况。

通过 Server 恢复,您可以基于原始 Server 的以下内容,使用原始用户、工作流、计划等运行新的 Server:

  • 控制器令牌

  • 控制器节点中的 RuntimeSettings.xml

  • MongoDB 备份

以下是Server 恢复过程每个步骤的详细信息:

1 - 准备

2 - 恢复 RuntimeSettings.xml

3 - 恢复 MongoDB

4 - 恢复其他文件和设置

5 - 启动 Alteryx Server

6 - 测试

可恢复范围

  • 使用嵌入式 MongoDB 的单一默认 Server 安装故障 进行恢复。

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

  • 目标计算机可被覆盖。

不在可恢复范围内

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

  • 合并连接文件数据库。

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

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

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

先决条件

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

  • 具有对目标 Server 的管理员权限。

  • 具有所有用于模拟使用者的凭证,包括服务账户(如果不是本地系统)、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 用户的别名和库内连接别名 – 以下可能与 每个 运行身份或工作流凭证用户账户相关

    • 有关用户数据连接,请查看 C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

    • 有关用户库内数据连接,请查看 C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

步骤 1:准备

#

步骤

详情

1.1

设置计算机时区

新计算机的 Windows 时区必须设置为与原始计算机一致。

1.2

确保可访问 Alteryx

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

1.3

安装相同版本的 Server

全新安装生成 Mongo 备份的同一版本的 Server。

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

安装或升级 Server

测试 Server UI 在浏览器中显示,您无需登录。

1.4

排错

许可证密钥“使用中”错误

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

步骤 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 文件从原始 Server 复制到当前的 %ProgramData%\Alteryx\ 目录。

2.5

清除 控制器令牌

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

64ae505fe2c2c.png

保存并关闭文件。

2.6

恢复 控制器令牌

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

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(运行身份)

如果原始 Server 上有 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 备份从原始 Server 复制到新 Server 上的 MONGO_BACKUP 文件夹。

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\Service\Persistence\Mongo_Restore" ––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

删除原始 Server 设置的锁定

输入 Mongo 命令

db.locks.remove({})

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

3.10

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

输入命令

exit

关闭 Command_Prompt_2

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

3.11

停止 Mongo 数据库

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

ctrl-c

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

关闭命令提示符。

步骤 4:恢复其他文件和设置

#

步骤

详情

4.1

您在原始 Server 上是否有 服务登录用户

在新 Server 上设置 服务登录用户

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

4.2

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

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

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

4.3

在更安全的环境中,配置所需的Run As(运行身份)用户权限。

确保用于运行工作流的所有凭证(Run As 运行身份、服务登录或保存工作流时设置的凭证)具有足够的访问权限,请参阅 配置所需的运行用户权限

4.4

恢复基于系统的别名和库内连接别名

系统数据连接:

%ProgramData%\Alteryx\Engine\SystemAlias.xml

系统库内数据连接:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

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

用户数据连接:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

用户库内数据连接:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

4.6

工作流是否使用连接器?

将连接器文件夹从原始 Server 复制到

%ProgramData%\ Alteryx\Tools

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

4.7

工作流是否使用 Python 工具?

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

4.8

工作流是否使用 R 工具?

即将推出。

4.9

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

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

4.10

是否使用 SSL?

如果要恢复到 Sandbox Server 进行测试,请使用 HTTP 进行测试。

如果要迁移到新 Server,请重新建立 SSL:

配置 Server SSL/TLS

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

步骤 5:启动 Alteryx Server

#

步骤

详情

5.1

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

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

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

Worker > General > Allow machine to run scheduled Alteryx workflows

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

重要

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

System Settings, the Server UI configuration section.

步骤 6:测试

#

步骤

详情

6.1

基本测试

AlteryxService 是否在运行?

您能否:

  • 访问 Server UI URL?

  • 在管理员页面之间移动并查看用户、集合等?

  • 将工作流从 Designer 发布到 Server?

  • 运行工作流?

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

6.2

特定于工作流的测试

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

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

  • 数据库连接

  • 连接器工具

  • 地理位置或业务洞察数据集

  • Python 工具

  • R 工具