加密密钥传输过程
本指南旨在帮助 Server 管理员在将 Alteryx Server 移动到新主机(本地或云)时以及在基础架构发生变化的其他情况下主动传输 Alteryx Server 加密密钥。
加密密钥传输过程允许您运行使用加密资产的工作流(如 DCM 连接和 Server 数据连接)。
注意
此功能仅适用于以下版本:
2021.4.2 补丁 11+
2022.1 补丁 9+
2022.3 补丁 6+
2023.1 补丁 2+
2023.2 GA+
All versions newer than 2023.2
先决条件
对原始控制器/主机的访问权。
目标计算机必须安装相同版本的 Alteryx Server。
目标 Server 和原始 Server 上的系统管理员权限。
具有用于运行工作流的所有共享凭证的访问权限,包括服务账户(如果不是本地系统)、以用户身份运行和任何工作流凭证。
来自原始 Server 的控制器令牌和端口号(如果与默认端口不同)。
AlteryxService 必须在原始主机上运行。
步骤 1:了解原始主机详细信息
# | 步骤 | 详情 |
---|---|---|
1.1 | 获取原始主机控制器令牌 | 从 Alteryx 系统设置 > Controller > General > Token 部分复制控制器令牌 或者以管理员身份从命令提示符或 Powershell 运行以下命令: {Install Directory}\Alteryx\bin> .\AlteryxService.exe getserversecret 默认为 C:\Program Files\Alteryx\bin> .\AlteryxService.exe getserversecret |
1.2 | 获取原始主机详细信息 | 未启用 TLS: 获取原始主机的 IP 地址/FQDN/主机名以及默认端口以外的端口号(如果有)。 启用 TLS: 获取原始主机的 IP 地址/FQDN 以及默认端口以外的端口号(如果有)。 注意 “启用 TLS”仅指 Server 的内部群集级别服务连接,而不是指终端用户访问的 Server UI URL。启用 TLS 的服务层仅在 2022.3 和更高版本的 Alteryx Server 上可用,其设置可在 Alteryx 系统设置 > Controller > General > Communication > Enable Controller SSL/TLS 中找到。如需了解详情,请访问 控制器 帮助页面。 |
步骤 2:了解目标主机详细信息
# | 步骤 | 详情 |
---|---|---|
2.1 | 获取 AlteryxService.exe 路径 | {Install Directory}\Alteryx\> .\AlteryxService.exe 默认为 C:\Program Files\Alteryx\bin> .\AlteryxService.exe |
步骤 3:准备并执行命令
以下步骤均在目标主机上执行。
# | 步骤 | 详情 |
---|---|---|
3.1 | 命令 | transferdcmesecret |
3.2 | 准备命令 | 注意 路径是在步骤 2.1 {Install Directory}\Alteryx\bin> .\AlteryxService.exe. 收集的。 未启用 TLS 使用默认端口: {Install Directory}\Alteryx\bin> .\AlteryxService.exe transferdcmesecret=< IP 地址 | 主机名 | FQDN >:<端口号>,<来自步骤 1.1 的未加密 Controller Token(控制器令牌)> 注意:默认情况下,端口号可有可无。 示例:C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=172.x.2x.2xx,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaaab 使用指定的端口号: {Install Directory}\Alteryx\bin> .\AlteryxService.exe transferdcmesecret=< IP 地址 | 主机名 | FQDN >:< 端口号 >,<步骤 1.1 未加密 Controller Token(控制器令牌)> 示例:C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=172.x.2x.2xx: 81 ,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaaab 启用 TLS 注意 “启用 TLS”仅指 Server 的内部群集级别服务连接,而不是指终端用户访问的 Server UI URL。启用 TLS 的服务层仅在 2022.3 和更高版本的 Alteryx Server 上可用,其设置可在 Alteryx 系统设置 > Controller > General > Communication > Enable Controller SSL/TLS 中找到。如需了解详情,请访问 控制器 帮助页面。 使用默认端口: {Install Directory}\Alteryx\bin .\AlteryxService.exe transferdcmesecret=<https://IP 地址 | FQDN:可选端口号,步骤 1.1 的未加密控制器令牌 注意:默认情况下,端口号可有可无。非默认情况下端口号必填。 示例:C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=https://172.x.2x.2xx,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaaab 使用指定的端口号: {Install Directory}\Alteryx\bin> .\AlteryxService.exe transferdcmesecret=< https://IP 地址 | FQDN >:< 端口号 >,<来自步骤 1.1的未加密 Controller Token(控制器令牌)> 示例:C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=https://172.x.2x.2xx: 443 ,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaaab |
3.3 | 执行命令 | 在管理员模式下打开命令提示符或 PowerShell 窗口,并运行步骤 2.1 中的命令。 |
注意
如果您在控制台窗口中看到任何错误,请参阅已知错误消息表。
已知错误消息
错误消息 | 原因 |
---|---|
参数无效。无法找回原始密钥。 | 来自原始主机的控制器令牌不正确。 |
获取服务器地址失败,服务器 <servername>:未知此类主机。 | 指定的IP地址/主机名/FQDN不正确或存在通信问题。 |
无法连接到服务器 <servername>,端口 <xxxx>:无法进行连接,因为目标计算机主动拒绝连接。 | 端口号不正确。 |
步骤 4:传输加密密钥后启动或重新启动 AlteryxService
注意
如果您正在将此过程作为 主机恢复指南 的一部分执行,请跳过此步骤,因为 AlteryxService 将在主机恢复结束时重新启动。
# | 步骤 | 详情 |
---|---|---|
4.1 | 启动或重新启动 AlteryxService | 前往 任务管理器 > 服务 ,选择 AlteryxService ,然后选择 启动 或 重启 。 |