Test Execution Agent (TEA)

Test Execution Agent (TEA) 可用于触发从 Web 客户端 运行的自动化测试。

关于 TEA 主机和 TEA 主机标识符

此部分简要介绍了 TEA 主机、TEA 主机标识符以及 TEA 如何与 Web 客户端 配合使用。

TEA 主机

您可以在用于运行自动化测试的测试机器上安装并配置 TEA。安装了 TEA 的测试机器是 TEA 主机。
TEA 主机标识符

每次 TEA 启动时，TEA 都会检查您的 TEA 主机标识符。如果标识符无效或被其他 TEA 主机占用，身份验证将失败。每个标识符一次只能由一个 TEA 主机使用。
TEA 如何与 Web 客户端 配合使用

当您启动在 Web 客户端 中运行的自动化测试时，Web 客户端 会检查您的测试机器是否已注册以及该机器是否支持运行选定的自动化测试。如果验证通过，则 TEA 从服务器提取自动化测试，并告知测试主机运行自动化测试。

您可以从“站点管理”监控 TEA 主机服务。有关详细信息，请参阅监控 TEA 主机服务。

返回页首

TEA 工作流

以下步骤说明了如何使用 TEA 在 Web 客户端 中运行自动化测试:

  1. 下载 TEA。

    有关详细信息，请参阅下载 TEA。

  2. 在“站点管理”中为测试机器创建一个 TEA 主机标识符。首次启动 TEA 时使用该标识符，以使主机在服务器中进行身份验证。

    有关详细信息，请参阅监控 TEA 主机服务。

  3. 通过运行 start-agent.bat 启动 TEA。

    有关详细信息，请参阅 启动 TEA。

  4. 触发从 Web 客户端 运行的自动化测试。

    有关详细信息，请参阅自动运行测试。

  5. (可选) 编辑 TEA 配置。

    有关详细信息，请参阅(可选) 编辑 TEA 配置。

返回页首

下载 TEA

您可以从 qcbin 页面下载 TEA。

要下载 TEA，请执行以下操作:

  1. 在 qcbin 页面 (http://<服务器>:<端口号>/qcbin/) 上，单击 Tools 链接以打开 Tools 页面。

  2. 单击 Test Execution Agent 链接。

  3. 在 Test Execution Agent 页面底部，单击“下载 Test Execution Agent”。

返回页首

启动 TEA

在从 Web 客户端 运行自动化测试之前，在要运行自动化测试的测试机器中启动 TEA。

先决条件：

64 位 JDK/JRE 17

在安装 TEA 的测试机器上安装 64 位 JDK/JRE 17。

注: TEA 不适用于 32 位 JDK/JRE。如果您在 24.1 之前一直在使用 TEA，则升级到 24.1 后，应安装 64 位 JDK/JRE 17。否则，您无法启动 TEA。
注册 64 位客户端组件

使用客户端注册工具在测试机器上注册客户端 (64 位)。有关详细信息，请参阅工具。

注: TEA 不适用于 32 位客户端组件。如果您在 24.1 之前一直在使用 TEA，则升级到 24.1 后，应注册 64 位客户端组件。否则，您无法启动 TEA。
创建 API 密钥

为您 (测试机器所有者) 创建 API 密钥。确保与该密钥关联的用户包含在项目中。记下 API 密钥客户端和 API 密钥。

有关 API 密钥身份验证的详细信息，请参阅API 密钥管理。
导入证书

仅当使用安全协议时才需要这样做。

通过在 jre/bin 目录中运行以下命令，将证书导入 Java 的密钥库:

  • Oracle JDK 

    keytool -import -keystore "{Java_home}\jre\lib\security\cacerts" -storepass
changeit -keypass changeit -alias <文件别名> -file <文件名>

  • 打开 JDK 

    keytool -keystore {Java_home}\jre\lib\security-importcert -file
<证书文件名>-alias <文件别名> -storepass changeit -keypass changeit

{Java_home} 是部署 64 位 JDK/JRE 的位置。

要启动 TEA，请执行以下操作:

  1. 在安装 TEA 的目录中，运行 start-agent.bat。

  2. 提供以下信息:

    字段 描述
    Port 运行 TEA 的 HTTP 端口号。
    服务器 URL 服务器的 URL，格式为“http://<服务器>:<端口号>/qcbin”。

    API Key Client

    API Key Secret

    用于访问服务器的 API 密钥客户端 ID 和密码。
    Token

    用于注册主机的 TEA 主机标识符。

    有关 TEA 主机标识符的详细信息，请参阅监控 TEA 主机服务。
    is shared (Y/N)

    它支持以下两个选项:

    • Y。TEA 主机可供任何在 Web 客户端 中触发自动化测试的人使用。

    • N。TEA 主机只能供主机所有者使用。
    Java Bin 存储 java.exe 文件的 JDK (64 位) 的安装路径。

TEA 成功启动后:

TEA 成功启动后，TEA 每分钟 Ping 一次 OpenText Application Quality Management。运行自动化测试时请确保以下几点:

  • TEA 命令窗口已打开。

  • TEA 运行时不要移动光标。

返回页首

(可选) 编辑 TEA 配置

首次启动 TEA 后，会自动创建以下两个配置文件。

要编辑 TEA 配置，请编辑文件，然后通过运行 start-agent.bat 重新启动 TEA。

文件 配置
agent.conf

可以在此文件中编辑以下信息:

  • 端口

  • 服务器 URL

  • API 密钥客户端和 API 密钥

  • Token

  • 共享
agent.ini 可以在此文件中编辑 Java Bin 配置。

返回页首

疑难解答

下表列出了在使用 TEA 时可能遇到的问题以及解决方法:

问题 解决方案
无法检查 OTA 平台的存在和兼容性。

出现此问题可能是因为您未注册客户端组件。

使用客户端注册工具在测试机器上注册客户端组件。有关详细信息，请参阅工具。
无法启动 TEA，并且出现“按任意键继续”消息。 向上滚动命令行，以查看是否有任何报告的错误。修复错误并重新启动 TEA。
TEA 停止 ping，因为您在命令行中删除光标后单击了某个区域。 在命令行中右键单击。

返回页首

另请参阅：