Server 主机恢复指南
本指南旨在帮助服务器管理员在以下情况下恢复服务器实例:原始主机或主机发生故障,迁移到新的升级服务器,从本地迁移到云服务器,以及基础结构发生更改的其他情况。
服务器恢复允许您获得一个新的服务器运行与您的原始用户,工作流,计划等,基于从您的原始服务器的以下内容:
控制器令牌
MongoDB 备份
以下是流程每个步骤的详细信息:
可恢复范围
恢复 使用嵌入式 MongoDB 的单一默认 Server 安装 上出现的失败。
可用备份包含完整的必要信息。
目标计算机可被覆盖。
不在可恢复范围内
多节点 Server 环境或用户管理的 MongoDB - 请联系客户支持以获得帮助。
合并连接文件数据库。
备份或还原 ODBC 驱动程序。
备份或还原用户或系统 DSN。
备份或还原存在于 Alteryx 之外的 Windows 中存储的其他别名。
先决条件
在完成本指南中列出的步骤之前,请安装工作流操作所需的所有数据库驱动程序和软件,以尽可能降低停机时间。
具有对目标服务器的管理员权限。
具有所有用于模拟使用者的凭证,包括服务帐户(如果不是本地系统)、Run As(运行身份)以及任何已经定义/已使用的工作流凭证。
来自原始 Server 的控制器令牌。
要访问来自原始 Server 的 RuntimeSettings.xml,请访问以下路径:
%PROGRAMDATA%\Alteryx\RuntimeSettings.xml
。将原始 Server 的 MongoDB 进行备份。 了解如何执行备份。
在 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 。 测试服务器UI出现在浏览器中,您无需登录。 |
1.4 | 排错 许可证密钥"使用中"错误 | 如果您的许可证密钥仍绑定到旧服务器,则需要在该计算机上停用它。如果该计算机无法访问,请联系您的许可证管理员以释放许可证。 |
步骤2:恢复RuntimeSettings.xml
# | 步骤 | 详情 |
---|---|---|
2.1 | 打开bin文件夹中的命令提示符1 | 以管理员身份打开命令提示符并导航至Alteryx\bin文件夹,输入以下命令(根据您的安装位置进行调整)。
|
2.2 | 停止服务 | 输入命令
成功后,您应看到
|
2.3 | 备份现有 RuntimeSettings.xml | 输入命令
|
2.4 | 还原 RuntimeSettings.xml | 将
RuntimeSettings.xml
文件从原始服务器复制到当前的
|
2.5 | 缺少控制器令牌 | 编辑刚刚复制的 RuntimeSettings.xml 并删除 <ServerSecretEncrypted> 标签之间的所有内容,仅保留标签,如下所示: 保存并关闭文件。 |
2.6 | 缺少控制器令牌 | 使用原始服务器控制器令牌输入命令
疑难解答 版本2021.3+在此步骤上可能会出现以下错误:"设置服务器机密失败:错误:错误 CryptImportKey(3)数据。(- 2146893819)"。要纠正此问题,请参阅上一步,以确保从标签之间删除该值。 |
2.7 | 恢复 加密存储密钥 | 在
步骤 2.6
中重置控制器令牌时,
|
2.8 | Run As(运行身份) | 如果在原始服务器上有"以用户身份运行",请输入以下命令,否则跳过此步骤。
|
2.9 | 恢复 SMTP密码 | 如果已填写
Alteryx 系统设置
>
Server UI >
SMTP
>
Password
(即使未选中SMTP复选框),请输入以下命令,否则跳过此步骤。
|
2.10 | 保存 RuntimeSettings.xml | 保存RuntimeSettings.xml文件。 |
2.11 | 传输 加密密钥 此功能仅适用于以下版本:
| 重要 请注意,这要求 AlteryxService 在您的原始 Server 控制器节点上运行,并且您的新 Server 需要能够通过网络进行访问。 您可以按照 加密密钥传输过程 的步骤将加密密钥从现有控制器传输到新控制器。 |
2.12 | 保持在命令行上 | 步骤 3
假定您在
|
步骤3:恢复MongoDB
# | 步骤 | |
---|---|---|
3.1 | 获取MongoDB备份 | 将Mongo备份从原始服务器复制到
|
3.2 | 恢复到新文件夹 | 将 Mongo 数据库从备份文件夹恢复到新的还原文件夹。最后一个参数 ,10 可确保恢复期间 MongoDB 的内存使用量较低。这可以降低内存不足错误的几率,但可能会增加恢复时间。去掉 ,10 可能会加快恢复速度。在这两种情况下,请按照下面的说明检查 mongoRestore.log ,以确保还原成功。
示例:
|
3.3 | 确认恢复成功 | 确认恢复成功。 注意 这是必要步骤,因为还原失败不会在上一步中报告,并可能导致您 Server上的数据丢失。为此,请找到已恢复数据的 MongoDB 文件夹,查看 mongoRestore.log 文件。打开 mongoRestore.log 并执行以下步骤:
如果恢复失败,或者在搜索上面列出的关键字时找到任何结果,请 联系支持部门 并提供您收集的所有信息。 如果 MongoDB 恢复失败,请勿继续操作。 |
3.4 | 在RuntimeSettings.XML中设置Mongo路径 | 编辑
RuntimeSettings.xml
并在
示例: 保存并关闭文本编辑器。 |
3.5 | 启动MongoDB | 输入命令
示例
|
请勿关闭命令提示符窗口。 如果您在 步骤 3.5 中关闭窗口,则后续步骤都将无法进行。 | ||
<<第二个命令提示符部分开始>> | ||
3.6 | 打开bin文件夹中的第二个命令提示符 | 以管理员身份打开第二个命令提示符
并导航至
|
3.7 | 获取非管理员Mongo密码 | 输入命令并将 non_admin_mongo_password复制 到记事本
|
3.8 | 启动Mongo命令行 | 输入命令
示例
成功后,您应看到
|
3.9 | 删除由原始服务器设置的锁定 | 输入Mongo命令
如果成功,您应该会看到:"
|
3.10 | 退出Mongo命令行和 命令提示符2. | 输入命令
关闭 Command_Prompt_2 |
<<第二个命令提示符部分结束>> | ||
3.11 | 停止Mongo数据库 | 在原始命令提示符下,输入keyboard命令
一次或多次,直到您退出MongoDB并返回正常的命令提示符。 关闭两个命令提示符。 |
步骤4:还原其他文件和设置
# | 步骤 | 详情 |
---|---|---|
4.1 | 您 在原始服务器上是否有服务登录用户? | 在新服务器上设置服务登录用户。 Windows服务应用程序 >右键单击 AlteryxService > 属性 > 登录 |
4.2 | 添加数据驱动程序和系统DSN。 | 添加 相同版本的 驱动程序和 相同名称的 系统DSN以匹配原始服务器 https://downloads.alteryx.com/ 。 |
可能不适用于恢复的高级问题: | ||
4.3 | 在更安全的环境中,配置所需的"运行方式"用户权限。 | 确保用于运行工作流的所有凭证 (运行方式,服务登录或保存工作流时设置的凭据)具有适当的足够访问权限, 配置所需的运行用户权限 。 |
4.4 | 还原基于系统和In-DB连接别名 | 没有数据连接。
系统In-DB数据连接:
|
4.5 | 恢复基于用户和用户数据库内连接别名 | 没有数据连接。
用户In-DB数据连接:
|
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: |
步骤5:启动 Alteryx Server
# | 步骤 | 详情 |
---|---|---|
5.1 | 查看 Alteryx 系统设置,如果需要,暂停计划。 | 运行 Alteryx 系统设置并 逐步浏览每个页面,确认设置(如控制器令牌)包含您期望的值。 如果不希望在服务启动时运行计划,请取消选中: 工作程序 >常规 > 允许计算机运行计划的 Alteryx工作流 选择 Finish 时,AlteryxService 应启动,且 Server 在浏览器中应可用。 |
重要
请特别注意" 服务器UI配置 "设置,因为新服务器可能具有不同的URL或没有SSL证书。
步骤6:测试
# | 步骤 | 详情 |
---|---|---|
6.1 | 基本测试 | AlteryxService 是否在运行? 您能否:
|
6.2 | 特定于工作流程的测试 | 您是否可以运行包含扩展或外部连接(如)的工作流
|