手动注册本地部署 机器人代理
必须使用密钥文件 (registration.key).注册 机器人代理。通常,您在安装过程中注册 机器人代理。但是,在某些情况下,则需要独立于安装来手动注册机器人代理,或者重新注册该代理。
手动注册 机器人代理 需要执行两个不同的步骤:
- 生成并下载注册密钥文件。
- 在 机器人代理 目录结构中手动安装注册密钥文件,并启动或重启 机器人代理服务。
说明
本主题中的信息仅适用于使用本地部署 机器人代理 在 ACL 机器人 中运行 ACL 脚本的组织。
拥有 ACL Robotics 专业版 的个人和组织没有本地部署的 机器人代理。在 HighBond 机器人 或 工作流机器人 中运行的 Python/HCL 脚本不使用 机器人代理。
需要手动注册
在以下情况下,需要手动注册或重新注册 机器人代理:
- 安装后更改服务账户在 机器人代理 代理期间,您未选择复制注册文件选项。完成安装后,您打算立即更新用于运行 机器人代理服务 的账户。
- 更改服务器 IP托管 机器人代理 的 Windows 服务器的 IP 地址发生变化。
- 密钥文件问题现有注册密钥文件存在某个问题。
无需手动注册
在以下情况下,您不应手动重新注册现有的 机器人代理,或生成新的注册密钥文件:
- 更改生产服务账户您需要更改一直在运行已安装 机器人代理 的服务账户。有关详细信息,请参阅更改 机器人代理服务 账户。
- 升级 机器人代理升级 机器人代理 时,不涉及注册密钥文件。
在这些情况下,生成新的注册密钥文件是不必要的,并且可能会干扰贵组织 机器人 实例的配置(如下所述)。
重新生成注册密钥的影响
为已在使用的 机器人代理 重新生成注册密钥具有以下影响:
- 机器人任务中的所有已保存密码被删除,必须重新输入它们。
- 所有代理都被从代理管理屏幕中的代理列表中移除。
- 所有代理都需要再次注册,包括对于多代理安装,在服务器之间迁移 机器人代理 RSA 密钥。
生成 机器人代理 密钥文件
说明
您必须具有“管理代理”权限才能生成 机器人代理 注册密钥文件。有关详细信息,请参阅 机器人 应用程序权限。
在 平台主页 页面 (www.diligentoneplatform.com) 中,选择 机器人 应用程序以将其打开。
如果您已经进入 Diligent One,可以使用左侧导航菜单切换到机器人应用程序。
在仪表盘的右上角,单击设置。
在左侧窗格中,确保选择了代理管理。
如果您的 机器人 实例当前正在使用基于云的 机器人代理,请执行以下操作:
单击替换云代理。
单击注册代理并生成密钥。
如果您的 机器人 实例当前使用的是本地部署 机器人代理,或者未指定 机器人代理,请执行以下操作:
单击生成新的注册密钥。
如果已安装一个或多个现有本地部署代理,则显示的警告对话框适用于您。
单击生成新的注册密钥。
单击下载密钥文件并关闭。
注意
在下载密钥文件之前,请勿关闭浏览器窗口。
将下载的密钥文件保存在将存放 机器人代理 的 Windows 服务器上的安全位置。
说明
生成密钥文件是注册 机器人代理 的第一部分。当您将密钥文件放在 机器人代理 目录结构中的正确位置,启动或重启机器人代理服务,并成功连接到 机器人 应用程序时,注册过程即告完成。
手动安装注册密钥文件
- 在运行 机器人代理 的 Windows 服务器上,从您保存它的位置复制注册密钥文件。
- 导航到 机器人代理 安装目录,并将注册密钥文件粘贴到 agent 子文件夹中。
默认安装目录是:C:\Program File (x86)\ACL Software\Robots Agent\agent
如有必要,删除或覆盖现有密钥文件。
- 在 Windows 服务管理器中,重新启动机器人代理服务。
说明
如果您不重新启动该服务,则分析脚本将无法运行。
- 检查应用程序日志文件,确认 机器人代理 已成功连接到 机器人 应用程序。
转到日志文件的末尾并查找 INFO|Connected 条目,其日期和时间与 机器人代理服务 的启动时间一致。
日志文件的默认位置是:C:\acl\robots\logs\application.log
- 在 机器人 应用程序中,转到代理管理屏幕,然后按 F5 重新加载页面。
如果 机器人代理 出现且其状态为在线,则表明其已被成功注册。