Linux 上的 Tool Server(工具服务器)教程

本教程说明如何使用 Tool Server 连接并控制远程 Linux 系统上的工具。

启动 ecu.test

本教程使用 “RemoteCommandLinux” 工具。出于安全原因,该工具只能结合与 Tool Server 的安全通信使用(参见 Secure connection to Tool Server(与 Tool Server 的安全连接))。

因此,必须创建用于身份验证的证书(*.crt)及其对应的私钥(*.key)。可在 ecu.test 的设置对话框中通过 Local settings > Signing > Secure communication with Tool Server 创建。

启动 Tool Server

首先,必须在 Linux 系统上启动 Tool Server。本教程假定 Tool Server 已完成安装和设置。更多细节请参见章节 Usage on Linux systems(Linux 系统上的使用)。

要启用安全通信,需要配置以下 Tool Server 设置(参见 General settings of Tool Server(Tool Server 的常规设置)):

  • 将选项 SSL_ENABLED 设置为 1

  • 将选项 CertificateDir 设置为 Tool Server 在建立连接时用于搜索并校验客户端证书的目录

  • 将之前在 ecu.test 中创建的证书文件(*.crt)复制到该目录

由于 Tool Server 在 Linux 系统上没有 GUI,因此只能通过控制台启动。为此,必须在 Linux 系统的控制台中执行命令 tool_server。

当控制台输出中出现 “Listening on port 5017” 消息时,表示 Tool Server 已成功启动。

启动时可附加额外参数来修改 Tool Server 端口:

tool_server -p 5020

并非 ecu.test 支持的所有工具都可在 Linux 系统上使用。支持的工具列表见章节 Tools(工具)。

创建测试台架配置

在此步骤中,需要创建一个连接到 Tool Server 的测试台架配置。关于如何创建测试台架配置以及如何连接工具的详细说明,请参见章节 How to access tools?(如何访问工具?)。

在本教程中,需要新建一个测试台架配置,并将 Linux 系统添加为新的工具主机。

为此,选择 Remote (Tool Server),然后输入 Linux 系统的主机名。

在列出的受支持工具中,以 tracetronic: RemoteCommandLinux 为例。添加该工具后,无需进一步设置,即可保存测试台架配置。

创建 test case(测试用例)

为了使用与该工具的连接,需要创建一个简单的 test case(测试用例),其中包含一个会传输到 Linux 系统的文件,然后检查该文件是否存在于目标系统中。

在 ecu.test Workspace(工作区)的 Packages 文件夹中,创建一个名为 “abc.txt” 的新文本文件。该文件将被传输到 Linux 系统。

接着,为此创建一个新的 Package(测试包),并在 Jobs 标签页中向 test case 添加工具作业 UploadFile。参数 localpath 使用该文本文件的相对路径,即 “Packages/abc.txt”。参数 remotepath 需要填写 Linux 系统上的绝对目标路径,即 “/tmp/abc.txt”。

随后,将工具作业 ListDir 添加到 test case。参数 directory 填写 Linux 系统上的绝对目录路径,例如 “/tmp”。此外,启用复选框 Evaluation。在随后显示的求值区域中,选择模式 Unspecific,并将期望值填写为以下表达式:('abc.txt', '.', False) in value。该设置用于检查 ListDir 工具作业的返回值中是否包含名为 abc.txt 的文件,从而确认该文件确实存在。

最后一步是保存该 Package。

创建好的 Package 如下所示:

../_images/TutToolServerLinux.png

执行 test case(测试用例)

要运行已创建的 test case,需要执行以下步骤:

  1. 选择并加载已创建的测试台架配置 (参见 How to access tools?(如何访问工具?))

  2. 连接工具 “RemoteCommandLinux”

  3. 运行已创建的 Package。

该 test case 应能成功运行,并且工具作业 ListDir 应获得 SUCCESS 评级。

更多信息

如果 ecu.test 与 Tool Server 之间出现连接或通信问题,Tool Server 的日志文件中可能包含有用信息。日志文件 tool_server_out.log 和 tool_server_err.log 位于以下目录:

<home directory>/.cache/ecu.test 2026.3/