Server 主机恢复指南

1.1

设置主机时区

目标主机的 Windows 时区必须设置为与原始主机一致。

1.2

确保可访问 Alteryx

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

3.1

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

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

c:

cd \Program Files\Alteryx\bin

3.2

停止服务

输入命令

net stop alteryxservice

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

3.3

备份现有的 RuntimeSettings.xml

输入命令

c:

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

3.4

您之前是否已通过灾难恢复准备在目标主机上准备了 RuntimeSettings.xml？

是：来自灾难恢复过程的 RuntimeSettings.xml 应当已位于目标主机的 %ProgramData%\Alteryx\ 目录中。如果没有，请将准备好的 RuntimeSettings.xml 复制到 %ProgramData%\Alteryx\。

前往步骤 3.13。

否：将 RuntimeSettings.xml 文件从原始主机复制到当前目标主机的 %ProgramData%\Alteryx\ 目录。

继续执行步骤 3.5。

3.5

清除控制器令牌

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

保存并关闭文件。

3.6

恢复控制器令牌

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

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

故障排除：

版本 2021.3+ 在此步骤中可能会出现以下错误：“设置服务器密钥失败：CryptImportKey(3) 出错：数据错误。(-2146893819)”。要纠正此错误，请查看上一步，以确保删除标签之间的值。

3.7

恢复加密存储密钥

在步骤 3.6 中重置控制器令牌时，<StorageKeysEncrypted> 值可能已更改。如果是这样，则应将其替换为原始 RuntimeSettings.xml 文件中相应的值。这是在步骤 3.4 中复制的源 RuntimeSettings.xml 文件。最简单的方法是同时复制标签，以确保原始 RuntimeSettings.xml 文件标签之间的整个值得以复制。当您在步骤 4 中进行进一步更改时，可以在文本编辑器中将 RuntimeSettings.xml 保持打开状态。

3.8

恢复Run As（运行身份）

如果原始主机上有“以用户身份运行”，请输入以下命令，否则跳过此步骤。AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

3.9

恢复 SMTP 密码

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

3.10

保存 RuntimeSettings.xml

保存 RuntimeSettings.xml 文件。

3.11

您的原始主机上的 Alteryx Server 版本是否为以下任何版本？

是：前往步骤 3.13。

否：继续执行步骤 3.12。

3.12

传输加密密钥

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

重要：请注意，这要求 AlteryxService 在您的原始主机上运行，并且您的目标主机能够通过网络访问它。

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

3.13

留在命令行上

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

4.1

获取 MongoDB 备份

将 Mongo 备份从原始主机复制到新主机上的 MONGO_BACKUP 文件夹。

4.2

恢复到新文件夹

将 Mongo 数据库从备份文件夹恢复到新的还原文件夹。请按照下面的说明检查 mongoRestore.log，以确保还原成功。

请参阅 MongoDB 备份文档中的从 MongoDB 备份还原部分，查找适合您的 Server 版本的还原命令。

4.3

确认恢复成功

确认恢复成功。

注意

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

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

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

4.4

在 RuntimeSettings.XML 中设置 Mongo 路径

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

示例：

保存并关闭文本编辑器。

4.5

启动 MongoDB

输入命令

mongod ––dbpath "MONGO_RESTORE_FOLDER" ––auth ––port 27018

示例

mongod ––dbpath "%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore" ––auth ––port 27018

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

如果您在步骤 4.5 中关闭窗口，则后续步骤都将无法运行。

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

4.6

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

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

c:

cd \Program Files\Alteryx\bin

4.7

获取非管理员 Mongo 密码

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

AlteryxService.exe getemongopassword

4.8

启动 Mongo 命令行

输入命令

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

示例

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

成功后，您应看到“>”提示。

4.9

删除原始 Server 设置的 AlteryxGallery 锁定

输入 Mongo 命令

db.locks.remove({})

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

4.10

切换到 AlteryxService 数据库

输入 Mongo 命令

使用 AlteryxService

4.11

删除原始 Server 设置的 AlteryxService 锁定

输入 Mongo 命令

db.locks.remove({})

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

4.12

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

输入命令

exit

关闭 Command_Prompt_2

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

4.13

停止 Mongo 数据库

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

ctrl-c

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

关闭命令提示符。

5.1

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

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

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

5.2

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

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

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

5.3

在更安全的环境中，配置所需的Run As（运行身份）用户权限。

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

5.4

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

系统数据连接：

%ProgramData%\Alteryx\Engine\SystemAlias.xml   

系统库内数据连接：

%ProgramData%\Alteryx\Engine\SystemConnections.xml   

5.5

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

用户数据连接：

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

用户库内数据连接：

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

5.6

工作流是否使用连接器？

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

%ProgramData%\Alteryx\Tools

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

5.7

工作流是否使用 Python 工具？

重新安装工作流已安装的 Python 软件包。请参阅 Server 升级中的 Python 工具环境。

5.8

是否使用 SSL？

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

如果要迁移到新 Server，请重新建立 SSL：

配置 Server SSL/TLS

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

6.1

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

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

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

Worker > General > Allow machine to run scheduled Alteryx workflows

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

7.1

基本测试

AlteryxService 是否在运行？

您能否：

7.2

特定于工作流的测试

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