安装或升级本地部署机器人代理

下载安装包

1. 从启动面板下载机器人代理安装包（RobotsAgent17.exe）：
   1. 登录到 Diligent One (www.highbond.com)。
   2. 在启动面板的审计和分析下，单击 Analytics 图块以访问下载。
   3. 在顶部菜单中，单击机器人代理。
   4. 单击下载版本 17。
2. 在 Windows 服务器上下载安装包后，双击安装包。

3. 如果出现安全警告对话框，请核实列出的信息，然后单击是。

   提示

   安全警告对话框可能隐藏在已打开的窗口后面。

解压缩并运行安装程序

1. 选择您想要用于安装的语言，然后单击确定。
2. 在解压后的安装目录页面中，指定要将安装文件提取到的文件夹，然后单击提取。

   您可以单击浏览，选择一个文件夹或接受默认位置：

   C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent17

   安装文件已提取到所指定的目标文件夹。提取文件后，安装程序会自动启动。

   说明

   如果由于某种原因没有自动启动安装程序，可以通过 Windows 资源管理器导航到提取安装文件的文件夹中，然后双击 setup.exe。

如果需要，安装必备软件

如果系统提示您安装先决性软件，请单击安装。

安装完先决性软件后， 安装程序会自动继续。

有关必备软件的列表，请参见本地部署机器人代理系统要求。

配置安装属性

1. 在欢迎页面中，单击下一步。
2. 在许可协议页面中，选择我接受上述条款，然后单击下一步。
3. 在机器人代理版本选择页面，选择要安装的版本，并单击下一步：
   • 非 Unicode
   • Unicode

   警告

   请确保您安装的版本是您公司所需要的正确版本。要在 Analytics 中打开机器人代理表，版本必须匹配。

   如果要设置多代理群集，则群集中的所有代理都必须是同一版本。全部是非 Unicode，或全部是 Unicode。

   有关详细信息，请参阅 Diligent Unicode 产品。

4. 在可选的 Analytics 数据连接器页面中，除非有理由不安装可选连接器，否则请保持选中安装选项，然后单击下一步。

   说明

   如果您选择不安装可选的连接器，而以后想使用其中之一，则必须卸载并重新安装机器人代理。

5. 在启用机器学习页面中，除非有理由不安装 Python 引擎，否则请保持选中启用选项，然后单击下一步。

   说明

   如果您选择不安装 Python 引擎，而以后想用其运行机器学习命令，则必须卸载并重新安装机器人代理。

6. 在机器人代理服务设置页面，完成以下服务帐户设置，然后单击下一步：
   • 机器人数据服务端口号指定数据服务的端口，或使用默认值 10000。

     您可以指定 0 到 65536 之间的任何可用端口。

   • 机器人代理服务账户指定现有域帐户以运行机器人代理服务和提供密码。

     帐户必须是一个域帐户，使用 Domain\service_account 格式指定。账户需要具备在 Windows Server 操作系统上运行服务的权限以及您在安装期间指定的数据文件夹的完全访问权限。有关详细信息，请参阅本地部署机器人代理安全。

     说明

     如果需要，可以在安装后更改机器人代理服务帐户。

7. 如果系统提示您将作为服务登录权限授予机器人代理服务帐户，请单击是，然后单击确定。

8. 在目标文件夹页面，完成以下目标和连接设置，然后单击下一步：
   • 机器人代理目标文件夹
     • 选择机器人代理安装的目标文件夹，或使用默认位置。

       默认：C:\Program Files (x86)\ACL Software\Robots Agent\

     • 选择数据文件夹位置，或使用默认位置。

       默认：C:\acl\robots\

       说明

       不得将数据文件夹放在安装目标文件夹中，反之亦然。卸载机器人代理时，这样做可能会导致数据丢失。

   • 机器人代理注册文件位置
     • 选择复制注册文件，然后浏览至您保存 registration.key 文件的位置，或者手动输入文件路径。

       当安装程序运行时，它会自动将密钥文件复制到机器人代理目录结构中的正确位置。

       说明

       如果您计划在安装机器人代理后更改机器人代理服务帐户，请取消选择复制注册文件，不要指定注册文件。

完成安装

1. 在准备安装程序页面中，单击安装。

   机器人代理即被安装。

2. 如果出现提示让您选择安装 Microsoft Access 数据库引擎，请执行以下任一操作：
   • 单击"是”安装数据库引擎如果您需要机器人代理从旧的 Excel 文件 (*.xls) 或 Microsoft Access 文件 (*.mdb) 导入或导出。
   • 单击“否”排除数据库引擎如果您仅将机器人代理与当前生成的 Excel 文件 (*.xlsx) 搭配使用，并且您不使用旧的 Excel 文件或 Microsoft Access 文件。数据库引擎可能会引发与其他较新的 Microsoft Office 产品的兼容性问题。因此，除非确实需要使用数据库引擎，不然应该将之排除。
3. 安装过程结束后，单击完成。

确认机器人代理服务正在运行

机器人代理服务必须为运行状态，机器人代理才能连接到机器人应用程序。如果没有连接，机器人代理将无法处理机器人任务和脚本。

如果需要，您可以在确认机器人代理服务为运行状态的同时，更改机器人代理服务帐户。

使用在安装过程中指定的机器人代理服务帐户

1. 打开 Windows 服务管理器。

2. 检查两个机器人代理 Windows 服务是否正在运行：

   • 机器人代理
   • 机器人数据服务

   如有必要，请启动一项或两项服务。

   说明

   如果出现一则错误消息，指出机器人代理服务启动然后停止，则表明机器人代理的注册可能不成功。

   检查机器人代理安装目录中是否存在注册密钥文件 (registration.key)。如果注册密钥文件不存在，请手动将密钥文件从您保存它的位置复制到安装目录。请再次尝试启动机器人代理服务。

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

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

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

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

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

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

更改机器人代理服务帐户

如果您在安装机器人代理的过程中取消选择了复制注册文件，并且想要更改机器人代理服务帐户，则请按照以下步骤操作。

手动安装注册密钥文件

1. 从注册密钥文件 (registration.key) 的保存位置复制该密钥文件。
2. 导航到机器人代理安装目录，并将注册密钥文件粘贴到代理子文件夹中。

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

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

将机器人代理服务更改为其他帐户

1. 打开 Windows 服务管理器。
2. 右键单击机器人代理服务并选择属性。
3. 在登录选项卡中，单击浏览。
4. 在选择用户对话框中，在输入要选择的对象名称字段中输入想要使用的服务帐户的名称，然后单击检查名称。

   该服务帐户应预先填充在此字段中。

5. 单击确定。
6. 在登录选项卡中，输入并确认该服务帐户的密码，然后单击确定。
7. 在 Windows 服务管理器中，重新启动（或启动）机器人代理服务。
8. 如有必要，启动机器人数据服务。

确认机器人代理注册成功

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

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

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

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

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

在机器人应用程序中配置机器人代理设置

如果适用于贵组织，请在机器人应用程序中更新两个机器人代理配置设置的默认值：

• 已允许文件上传控制是否将输出结果从机器人代理上传到云端机器人应用程序：
• 路径配置指定 Analytics 数据表和结果表的 Windows 服务器或网络目录

有关详细信息，请参阅在本地部署机器人代理上配置。

创建一个 Analytics 项目并下载测试文件

1. 创建一个名为 Robots Agent test.acl 的 Analytics 项目。
2. 右键单击下面的链接，并将文件保存在与刚创建的项目相同的文件夹中：

   Robots_Agent_test_file.txt

复制测试脚本

1. 在 Analytics 项目中，创建一个名为 Robots_Agent_test_script 的脚本。
2. 单击下面的链接，在浏览器中打开测试脚本：

   Robots_Agent_test_script.txt

3. 按 Ctrl+A 选择整个脚本，按 Ctrl+C 将其复制到剪贴板。
4. 将脚本粘贴到 Robots_Agent_test_script，单击保存打开的项目 。

将脚本提交给机器人应用程序，并同时创建一个机器人

1. 从 Analytics 主菜单中选择文件 > 提交脚本。
2. 如果需要，则请在选择目标对话框中，双击适当的 Diligent One 实例。

   将显示机器人集合，其中包含现有机器人（如有的话）的列表。机器人是脚本、数据和自动化任务的容器。

3. 在新机器人字段中键入测试机器人，然后单击创建。

   将创建该机器人，并且自动生成一个机器人 ID。

4. 在提交脚本对话框中，输入提交消息，如“上传测试脚本”，然后单击确定。

   脚本将提交到机器人应用程序，并且位于您刚刚创建的机器人中。

5. 在提交脚本成功对话框中，单击第二个链接。

   结果机器人应用程序将会在浏览器窗口中打开，且已选中脚本版本选项卡。您可能需要登录到 Diligent One。您应该看到了刚才提交的脚本版本。

6. 在 Analytics 中，单击确定退出提交脚本成功对话框。

上传测试文件

1. 在机器人应用程序中，选择输入/输出选项卡。
2. 单击从计算机选择并浏览到保存 Robots_Agent_test_file.txt 的位置。
3. 选择文件，并单击打开。

   结果文件已上传并显示在输入/输出选项卡中的文件下。

创建任务并运行测试脚本

1. 选择任务选项卡，单击创建任务。
2. 输入任务名称测试任务，然后单击保存。
3. 选择机器人代理测试脚本 并单击跳到末尾 > 确认并创建任务。
4. 在任务选项卡的测试任务中，单击 > 立即运行。

   结果 运行带有测试脚本的任务。

   如果任务完成时状态为成功，则安装的本地部署机器人代理工作正常。

   说明

   如果任务失败，请检查机器人代理服务是否在安装了机器人代理的服务器上运行。如果服务未运行，请启动该服务，然后再次尝试运行测试任务。

   如果任务仍然失败，请联系 Diligent 支持人员以获得帮助。

验证脚本输出

检查机器人代理中的以下位置，以确保测试脚本输出正确的文件。

停止机器人代理 Windows 服务

1. 在安装机器人代理的 Windows 服务器上，打开 Windows 服务管理器。
2. 关闭两项机器人代理 Windows 服务：
   • 机器人代理
   • 机器人数据服务

下载安装包

1. 从启动面板下载机器人代理安装包（RobotsAgent17.exe）：
   1. 登录到启动面板 (www.highbond.com)。
   2. 在资源下，单击下载。
   3. 在顶部菜单中，单击 机器人代理。
   4. 单击下载版本 17。
2. 在 Windows 服务器上下载安装包后，双击安装包。

3. 如果出现安全警告对话框，请核实列出的信息，然后单击是。

   提示

   安全警告对话框可能隐藏在已打开的窗口后面。

解压缩并运行安装程序

1. 选择您想要用于安装的语言，然后单击确定。
2. 在解压后的安装目录页面中，指定要将安装文件提取到的文件夹，然后单击提取。

   您可以单击浏览，选择一个文件夹或接受默认位置：

   C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent17

   安装文件已提取到所指定的目标文件夹。提取文件后，安装程序会自动启动。

   说明

   如果由于某种原因没有自动启动安装程序，可以通过 Windows 资源管理器导航到提取安装文件的文件夹中，然后双击 setup.exe。

3. 在升级提示中单击是。
4. 仅当您遵守且满足列出的各项要求时，请在机器人代理安装程序信息对话框中，单击确定。

   如果您尚未遵守和满足要求，则请立即遵守相应的要求，再继续进行升级。 如有必要，请暂时禁用计划在短期内运行的任何机器人任务。

如果需要，安装必备软件

如果系统提示您安装先决性软件，请单击安装。

安装完先决性软件后， 安装程序会自动继续。

有关必备软件的列表，请参见本地部署机器人代理系统要求。

配置安装属性

1. 在欢迎页面中，单击下一步。
2. 在许可协议页面中，选择我接受上述条款，然后单击下一步。
3. 在 机器人代理版本选择页面上，单击下一步。

   安装程序会强制执行当前已安装的机器人代理版本（非 Unicode 版或 Unicode 版）。

   说明

   在升级过程中，无法更改版本。要更改版本，则必须卸载当前版本的机器人代理，然后安装版本 17.0。

4. 在可选的 Analytics 数据连接器页面中，除非有理由不安装可选连接器，否则请保持选中安装选项，然后单击下一步。

   说明

   如果您选择不安装可选的连接器，而以后想使用其中之一，则必须卸载并重新安装机器人代理。

5. 在启用机器学习页面中，除非有理由不安装 Python 引擎，否则请保持选中启用选项，然后单击下一步。

   说明

   如果您选择不安装 Python 引擎，而以后想用其运行机器学习命令，则必须卸载并重新安装机器人代理。

6. 在机器人代理服务设置页面，完成以下服务帐户设置，然后单击下一步：
   • 机器人数据服务端口号保留为数据服务指定的现有端口，或指定一个不同的端口。

     您可以指定 0 到 65536 之间的任何可用端口。

   • 机器人代理服务账户保留运行机器人代理服务的现有域帐户，或指定一个不同的帐户。提供该帐户的密码。

     帐户必须是一个域帐户，使用 Domain\service_account 格式指定。账户需要具备在 Windows Server 操作系统上运行服务的权限以及现有机器人代理数据文件夹的完全访问权限。有关详细信息，请参阅本地部署机器人代理安全。

     说明

     如果需要更改机器人代理服务帐户，一个更优的选项是在升级后进行更改。

     如果在升级过程中更改安装程序中的帐户，则需要重新注册机器人代理。重新注册已安装的代理可能会破坏贵组织的机器人实例的配置。

     有关详细信息，请参阅更改机器人代理服务帐户。

7. 在下一个屏幕中查看配置信息，然后单击下一步。

完成升级

1. 在准备安装程序页面中，单击安装。

   机器人代理已升级。

2. 如果出现提示让您选择安装 Microsoft Access 数据库引擎，请执行以下任一操作：
   • 单击"是”安装数据库引擎如果您需要机器人代理从旧的 Excel 文件 (*.xls) 或 Microsoft Access 文件 (*.mdb) 导入或导出。
   • 单击“否”排除数据库引擎如果您仅将机器人代理与当前生成的 Excel 文件 (*.xlsx) 搭配使用，并且您不使用旧的 Excel 文件或 Microsoft Access 文件。数据库引擎可能会引发与其他较新的 Microsoft Office 产品的兼容性问题。因此，除非确实需要使用数据库引擎，不然应该将之排除。
3. 升级过程结束后，单击完成。
4. 单击是以重新启动服务器并完成升级。

5. 在 Windows 服务管理器中，确保两个机器人代理 Windows 服务都正在运行：

   • 机器人代理
   • 机器人数据服务

   如有必要，请启动一个或两个服务。

这些说明涉及服务器 #1 和服务器 #2：

• 服务器 1安装第一个机器人代理实例的 Windows 服务器
• 服务器 2一个附加的 Windows 服务器，在该服务器上安装机器人代理的附加实例

  说明

  您可以根据需要为更多的代理和服务器重复此过程。

在服务器 2 上安装机器人代理

1. 在服务器 2 上，执行与在服务器 1 上安装机器人代理相同的安装过程。

2. 在安装程序的目标文件夹页面中，请勿选择复制注册文件，并且将机器人代理注册文件位置字段留空。

有关安装步骤，请参见安装机器人代理。

从机器人应用程序检索 RSA 密钥名称

1. 登录到 Diligent One (www.highbond.com)。
2. 从启动面板主页的审计与分析下，选择机器人应用程序。
3. 在仪表盘的右上角，单击设置。
4. 在左侧窗格中，确保选择了代理管理。
5. 单击如何添加附加代理。
6. 单击 将 RSA 密钥名复制到剪贴板。
7. 将 RSA 密钥名粘贴到文本文件中以进行临时存储。

在文件中打包机器人代理 RSA 密钥

使用服务器 1 上的 EncryptionKeyCLI.exe 实用工具，在文件中打包机器人代理 RSA 密钥。

1. 在服务器 1 上，以管理员身份打开 Windows 命令提示窗口。
2. 运行以下命令以更改到机器人代理安装目录：

   cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

   如果未在默认目录中安装机器人代理，请指定适当的路径。

3. 运行以下命令在 zip 文件中打包机器人代理 RSA 密钥：

   EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX

   将 ACL_XXXXXXXX 替换为从机器人应用程序中的代理管理屏幕复制的实际 RSA 密钥名称。

   RSAKeyfile 可以是任何您想指定的文件名，不带空格。您可以选择性地指定服务器上的现有文件夹的文件路径。如果该路径包含空格，请将整个路径和文件名放在双引号中。

4. 如果需要，请输入 Y 以覆盖现有文件。

   结果 RSA 密钥被打包到一个 zip 文件中并保存到默认位置 (C:\ProgramData\robots\RSAKeyfile.zip) 或您指定的位置。

   说明

   如果您看不到 ProgramData 文件夹，则它可能被隐藏。要使该文件夹可见，请在 Windows 文件资源管理器中的 C:\ 根目录中选择隐藏的项目（查看选项卡 > 隐藏的项目）。

将 RSA 密钥文件迁移到服务器 2

使用服务器 2 上的 EncryptionKeyCLI.exe 实用工具，从 zip 文件中提取机器人代理 RSA 密钥并将其导入到 Microsoft 密钥库。

1. 将 RSAKeyfile.zip 从服务器 1 复制到服务器 2 上的机器人代理安装目录。

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

2. 在服务器 2 上，以管理员身份打开 Windows 命令提示窗口。
3. 运行以下命令以更改到机器人代理安装目录：

   cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

   如果未在默认目录中安装机器人代理，请指定适当的路径。

4. 运行以下命令从 zip 文件中提取机器人代理 RSA 密钥，并将其导入服务器 2 上的 Microsoft 密钥库：

   EncryptionKeyCLI.exe import RSAKeyfile

   如果没有使用 RSAKeyfile 作为 zip 文件的名称，请替换您使用的名称。

将注册密钥文件复制到服务器 2

将注册密钥文件 (registration.key) 从服务器 1 上的机器人代理安装目录复制到服务器 2 上的机器人代理安装目录。

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

重新启动服务器 2 上的机器人代理服务

在服务器 2 上，打开 Windows 服务管理器，重新启动（或启动）机器人代理服务。

检查附加代理是否已成功注册

在机器人应用程序中，转到代理管理屏幕，然后按 F5 重新加载页面。如果附加机器人代理出现在列表中，状态为在线，则该代理已成功注册。代理现在成为用于分析处理和负载平衡的代理集群的一部分。