Server 主机恢复指南

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.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> 标签之间的所有内容，仅保留标签，如下所示：

保存并关闭文件。

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 可以在文本编辑器中保持打开状态。

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

传输 加密密钥

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

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

2.12

保持在命令行上

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

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 并执行以下步骤：

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

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

3.4

在RuntimeSettings.XML中设置Mongo路径

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

示例：

保存并关闭文本编辑器。

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.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.1

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

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

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

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

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

6.1

基本测试

AlteryxService 是否在运行？

您能否：

6.2

特定于工作流程的测试

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