DCME备份密钥
本指南旨在帮助 Server 管理员在将 Alteryx Server 移动到新主机(本地或云)时以及在基础架构发生变化的其他情况下主动传输 Alteryx Server 加密密钥。
加密密钥传输过程允许您运行使用加密资产的工作流(如 DCM 连接和 Server 数据连接)。
先决条件
对原始控制器/主机的访问权。
目标计算机必须安装相同版本的 Alteryx Server。
目标 Server 和原始 Server 上的系统管理员权限。
具有用于运行工作流的所有共享凭证的访问权限,包括服务账户(如果不是本地系统)、以用户身份运行和任何工作流凭证。
原始服务器的控制器令牌和端口号(如果与默认端口不同)。
Alteryx Service 必须在原始主机上运行。
步骤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 以及默认端口以外的端口号(如果有)。 |
步骤 2:了解目标主机详细信息
# | 步骤 | 详情 |
---|---|---|
2.1 | 获取AlteryxService.exe路径 | {Install Directory}\Alteryx\> .\AlteryxService.exe 默认为 C:\Program Files\Alteryx\bin> .\AlteryxService.exe |
步骤3:准备并执行命令
以下步骤均在目标主机上执行。
# | 步骤 | 详情 |
---|---|---|
3.1 | 命令 | 转移cmesecret |
3.2 | Prepare命令 | 注意 路径是在步骤 2.1 {Install Directory}\Alteryx\bin> .\AlteryxService.exe. 收集的。 非TLS已启用 使用默认端口: {Install Directory}\Alteryx\bin> .\AlteryxService.exe transferdcmesecret=< IP 地址 | 主机名 | FQDN >:<端口号>,<步骤 1.1 未加密的控制器令牌> 注:默认情况下,端口号是可选的。 示例: C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=172x.2x.2xx,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaab 使用指定的端口号: {Install Directory}\Alteryx\bin> .\AlteryxService.exe transferdcmesecret=< IP 地址 | 主机名 | FQDN >:< 端口号 >,<步骤 1.1 未加密的控制器令牌> 示例:C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=172x.2x.2xx: 81 ,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaab TLS已启用 使用默认端口: {Install Directory}\Alteryx\bin> .\AlteryxService.exe transferdcmesecret=< https://IP 地址 | FQDN >:<可选端口号>,<步骤 1.1 未加密的控制器令牌> 注:默认情况下,端口号是可选的。对于非默认情况,必须填写此字段。 示例:C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=https://172x.2x.2xx,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaaab 使用指定的端口号: {{Install Directory}\Alteryx\bin> .\AlteryxService.exe transferdcmesecret=< https://IP 地址 | FQDN >:< 端口号 >,<步骤 1.1 未加密的控制器令牌> 示例:C:\Program Files\Alteryx\bin>.\AlteryxService.exe transferdcmesecret=443 https://172x.2x.2xx: ,81d73a13f264c4b5b43d6e28e9419dc8861d1091ffc46f23f5afaabaaaab |
3.3 | 执行命令 | 在管理员模式下打开命令提示符或 PowerShell 窗口,并运行步骤 2.1 中的命令。 |
注意
如果您在控制台窗口中看到任何错误,请参阅已知错误消息表。
已知错误消息
错误消息 | 原因 |
---|---|
参数无效。无法找回原始密钥。 | 来自原始主机的控制器令牌不正确。 |
无法获取服务器地址,服务器 <servername>:未知此类主机。 | 指定的IP地址/主机名/FQDN不正确或存在通信问题。 |
无法连接到服务器 <servername>,端口 <xxxx>:无法进行连接,因为目标计算机主动拒绝连接。 | 端口号不正确。 |
步骤 4:传输加密密钥后重新启动 Alteryx Service
# | 步骤 | 详情 |
---|---|---|
4.1 | 重新启动 Alteryx Designer。 | 转至 任务管理器 > 服务 ,选择 Alteryx服务 ,然后选择 重新启动。 |