手动注册本地部署的 机器人代理

必须使用密钥文件 (registration.key).注册 机器人代理。通常,您在安装过程中注册 机器人代理。但是,在某些情况下,则需要独立于安装来手动注册机器人代理,或者重新注册该代理。

手动注册 机器人代理 需要执行两个不同的步骤:

  1. 生成并下载注册密钥文件。
  2. 在 机器人代理 目录结构中手动安装注册密钥文件,并启动或重启 机器人代理服务。

说明

本主题中的信息仅适用于使用本地部署 机器人代理 在 ACL 机器人 中运行 ACL 脚本的组织。

拥有 ACL Robotics 专业版 的个人和组织没有本地部署的 机器人代理。在 HighBond 机器人 或 工作流机器人 中运行的 Python/HCL 脚本不使用 机器人代理。

需要手动注册

在以下情况下,需要手动注册或重新注册 机器人代理:

  • 安装后更改服务账户在 机器人代理 代理期间,您未选择复制注册文件选项。完成安装后,您打算立即更新用于运行 机器人代理服务 的账户。
  • 更改服务器 IP托管 机器人代理 的 Windows 服务器的 IP 地址发生变化。
  • 密钥文件问题现有注册密钥文件存在某个问题。

无需手动注册

在以下情况下,您不应手动重新注册现有的 机器人代理,或生成新的注册密钥文件:

  • 更改生产服务账户您需要更改一直在运行已安装 机器人代理 的服务账户。有关详细信息,请参阅更改 机器人代理服务 账户。
  • 升级 机器人代理升级 机器人代理 时,不涉及注册密钥文件。

在这些情况下,生成新的注册密钥文件是不必要的,并且可能会干扰贵组织 机器人 实例的配置(如下所述)。

重新生成注册密钥的影响

为已在使用的 机器人代理 重新生成注册密钥具有以下影响:

  • 机器人任务中的所有已保存密码被删除,必须重新输入它们。
  • 所有代理都被从代理管理屏幕中的代理列表中移除。
  • 所有代理都需要再次注册,包括对于多代理安装,在服务器之间迁移 机器人代理 RSA 密钥。

生成 机器人代理 密钥文件

说明

您必须具有“管理代理”权限才能生成 机器人代理 注册密钥文件。有关详细信息,请参阅 机器人 应用程序权限。

  1. 在 平台主页 页面 (www.diligentoneplatform.com) 中,选择 机器人 应用程序以将其打开。

    如果您已经进入 Diligent One,可以使用左侧导航菜单切换到机器人应用程序。

  2. 在仪表盘的右上角,单击设置。

  3. 在左侧窗格中,确保选择了代理管理。

  4. 如果您的 机器人 实例当前正在使用基于云的 机器人代理,请执行以下操作:

    1. 单击替换云代理。

    2. 单击注册代理并生成密钥。

  5. 如果您的 机器人 实例当前使用的是本地部署 机器人代理,或者未指定 机器人代理,请执行以下操作:

    1. 单击生成新的注册密钥。

      如果已安装一个或多个现有本地部署代理,则显示的警告对话框适用于您。

    2. 单击生成新的注册密钥。

  6. 单击下载密钥文件并关闭。

    注意

    在下载密钥文件之前,请勿关闭浏览器窗口。

  7. 将下载的密钥文件保存在将存放 机器人代理 的 Windows 服务器上的安全位置。

    说明

    生成密钥文件是注册 机器人代理 的第一部分。当您将密钥文件放在 机器人代理 目录结构中的正确位置,启动或重启机器人代理服务,并成功连接到 机器人 应用程序时,注册过程即告完成。

手动安装注册密钥文件

  1. 在运行 机器人代理 的 Windows 服务器上,从您保存它的位置复制注册密钥文件。
  2. 导航至 机器人代理 安装目录,并将注册密钥文件粘贴到 agent 子文件夹中。

    默认安装目录是:C:\Program File (x86)\ACL Software\Robots Agent\agent

    如有必要,删除或覆盖现有密钥文件。

  3. 在 Windows 服务管理器中,重新启动机器人代理服务。

    说明

    如果您不重新启动该服务,则分析脚本将无法运行。

  4. 检查应用程序日志文件,确认 机器人代理 已成功连接到 机器人 应用程序。

    转到日志文件的末尾并查找 INFO|Connected 条目,其日期和时间与 机器人代理服务 的启动时间一致。

    日志文件的默认位置是:C:\acl\robots\logs\application.log

  5. 在 机器人 应用程序中,转到代理管理屏幕,然后按 F5 重新加载页面。

    如果 机器人代理 出现且其状态为在线,则表明其已被成功注册。