安装连接器在 Linux 计算机上

连接器是用于将设备连接到实验室的独立组件。也可以将连接器作为独立组件安装在 Linux 计算机上，并将其配置为连接到 OpenText Functional Testing Lab 服务器。连接到分布式连接器计算机的设备将成为设备实验室的一部分。

有关如何查看所有连接器的详细信息，请参阅查看和管理连接器。

开始之前

在安装或更新连接器之前，请确保满足以下先决条件。

前提条件 详细信息
系统要求

检查您的计算机是否符合建议的系统要求以及您的设备是否受支持。有关详细信息，请参阅、连接设备和安装和配置最佳实践中的支持矩阵连接器要求。
iOS 设备 如果打算使用 USB 电缆将 iOS 设备连接到连接器计算机，请确保启用了 IPV6。

仅适用于新安装:

  1. 请确保 OpenText Functional Testing Lab 服务器尚未安装在计算机上。

  2. 连接器必须能够访问服务器。
    要检查连接，请运行以下 curl 命令并检查您是否获得 200 确定状态:

    curl - I http/s://<OpenText Functional Testing Lab 服务器 IP 地址 >:< 端口 >

  3. 如果已在连接器计算机上安装了 nginx，请在安装 OpenText Functional Testing Lab 连接器之前将其删除。

  4. 在服务器中获取文件号码。

    • 管理员用户: 选择连接器选项卡。单击生成新密钥，并提供名称、类型 (连接器)、到期日期、描述 (可选) 。
    • 非管理员用户:从管理员处请求一个用户。选择联系管理员 (位于“帮助”菜单的右上角) 。

  5. CentOS 7.6 - 7.9 新安装: X11 转发是必需 .

    要启用 x11 转发，请执行下列操作:

    1. 安装必需程序包:

      Copy code
      yum install -y xorg-x11-server-Xorg xorg-x11-xauth xorg-x11-apps
    2. 启用 X11 转发。

      打开 SSH 配置文件:

      Copy code
      vi /etc/ssh/sshd_config

      取消注释或添加以下行:

      Copy code
      X11Forwarding yes

    3. 重新启动 SSH 服务:

      4. Copy code 
      systemctl restart sshd

后退到顶部

关于 Ubuntu 的评论

在安装 Linux 连接器时，需要考虑的几点。

考虑 详细信息
版本支持 Ubuntu 版本 11.03 .3 (LTS) 、24.04 和更高版本。
安装类型

支持 Ubuntu Normal 安装和 Ubuntu Minimum 安装。Ubuntu Pro 不支持。
出版物 Ubuntu Desktop 和 Ubuntu Server 支持。
CPU 仅支持 X86_64 架构。
权限 安装需要 Sudo 许可

后退到顶部

iOS 17 及更高版本的注意事项

iOS 17 及更高版本的设备，如果计划直接接入到连接器计算机，需要考虑如下事项:

考虑 详细信息
支持的 OS

支持以下操作系统: iOS 17 及以上版本:

  • Mac 连接器。iOS 18 需要 Mac OS 14 (单机版) 及以上版本。

  • Linux Ubuntu 单机或嵌入式连接器。

  • RedHat Enterprise Linux 单机或嵌入式连接器。

Windows: Windows Connector 只支持 iOS 的版本 17.4 或更高版本。

互联网连接

要随时从 Apple 获取签名密钥，必须有计算机连接器访问以下内容:

  • 千万

OpenText 建议允许访问所有 *.apple 域名。
iOS 17 及更高版本的其他注意事项

  • 不支持 Dev 访问。

  • 不支持连接 AWS Device Farm 和 WeTest 设备。

  • 不支持强制退出应用程序。

后退到顶部

下载连接符

下载连接符的方法如下:

    • 对于管理员，选择下载连接器位于连接器页面中。
    • 对于非管理员的用户，请从帮助菜单 Help menu 的 OpenText Functional Testing Lab 控制台中选择下载连接器。

后退到顶部

安装连接器

单独连接器为 OpenText Functional Testing Lab 可以作为完整的安装或升级到现有连接器的安装。安装程序将检查哪些文件已存在，并安装或更新相关文件。

要安装连接器，请执行以下操作:

  1. 开启 Linux 计算机，以 root 用户身份。乌布图: 需要 Sudo 安装许可。
  2. 复制文件到 Linux 计算机并提取安装文件: 
    unzip < Linux 连接器安装文件的名称>.zip – d <目标目录名称>
  3. 将目录更改为目标目录：
    cd < 目标目录名称 > /
  4. 运行连接器安装程序:
    。/< install_connector-x64 文件名>.bin
  5. 阅读许可协议，然后选择 Y 接受条款并继续安装。选择安装文件夹和用于存放临时文件的本地文件夹。根据以下原则填写信息或回答每个“安装”部分中的问题。

    部分详细信息
    用户配置使用现有的 LinuxOS 用户，或单击 n 创建默认用户。
    指定此用户的密码。
    身份验证输入您的凭据。输入由您的管理员提供的访问密钥。

    OpenText Core Functional Testing Lab: 应选择启用 SSL 选项。

    如果通过代理连接，则在代理部分中选择服务器地址，并根据需要指定服务器、端口和凭据。

    连接器配置为连接器提供有意义的名称，因为这样可以根据连接器名称有效地筛选设备。输入连接器的 IP 地址 (如果 IP 是静态的) 或 FQDN，或者接受默认值。

    6. 有关如何在安装后更改配置的详细信息，请参阅更改连接器的配置。

  6. 查看安装前摘要并按 Enter 键继续安装连接器。

    警告: 为确保与 OpenText Functional Testing Lab 一起存储的信息的完整性和机密性，强烈建议您在安装文件夹和临时文件夹上合并文件系统监控。

后退到顶部

连接并验证设备

  1. 如果您还没有做到这一点，请确保在连接 Android 和 iOS 设备时遵循初始设备配置步骤。
  2. 使用 USB 电缆将设备连接到连接器计算机。开启某些设备，当您连接该设备时，可能会出现通知、信任或位置弹出窗口。接受这些弹出窗口。
  3. 请等待，直到设备上运行代理。

  4. 如果代理未在设备上启动，请验证设备是否可以识别:

    在 Linux 连接器上运行以下命令计算机 (如果您是 root 用户，请将目录更改为 /opt/FunctionalTestingLabForMobileAndWeb/connector/android-sdk-linux/platform-tools):

    。/adb 设备

    全部连接的设备应列出。设备的状态应为“设备”，而不是任何其他状态，例如“未经授权”。

    提示: 如果您连接的是 C 类 USB 设备，例如 One Plus 和 Nexus 5，idVendor 值可能尚未被识别。
    解决方法: 运行 dmesg 以获取以 0x 开头的 idVendor 值。作为安装过程中指定的用户登录。运行 sudo ~/add_android_vendor.sh <idVendor> 脚本。

    1. 去吧:
      //opt/FunctionalTestingLabForMobileAndWeb/Connector/libimobiledevice/linux/
    2. 运行 ./idevice_id –l


    此命令的结果应为设备 ID (UDID) 列表。如果命令返回空结果或 ERROR 消息，请尝试以下操作:

    1. 在服务器或连接器计算机上，以根用户中的用户身份登录。
    2. 找到“usbmuxd”的进程 ID
      ps aux | grep '[u]sbmuxd'
    3. 终止进程:
      kill –9 <processID>
    4. 再次启动 usbmuxd:
      usbmuxd
    5. 再次运行 idevice_id –l 以查看是否识别设备。

    如果设备连接正确，请尝试手动启动 Launcher 应用程序。如果您看到 Untrusted 应用程序 Developer 通知:

    • 单击 Trust。
    • 断开连接设备。
    • 等待 5 秒，然后重新连接设备。

  5. 仅限 iOS 设备:

    如果您尚未执行此操作，请在设备上启用 “设置”>“开发者”>“启用 UI 自动化” 中的 。断开连接设备，等待 5 秒，然后重新连接它。

    如果您安装的是使用企业证书签名的应用程序，但不使用移动设备管理 (MDM) 解决方案，则在首次安装该应用程序时，系统会提示您信任该企业开发者。要信任配置文件，请转到设置 > 常规 > 设备管理，选择企业开发人员配置文件并信任它。可以在设备上远程执行这些操作。

    首次安装您的企业签名应用程序的所有用户也需要 Internet 连接。在设备上信任企业开发者配置文件之后，如果其他具有相同配置文件的应用程序已连接到 Internet，则无需再次信任这些应用程序，但前提是打开这些应用程序的设备已连接到 Internet。如果接受测试的应用程序的企业开发人员配置文件不受信任，代理将无法打开应用程序和 1009 错误: “无法与 AUT 通信”结果.

后退到顶部

开始并停止连接器

您可以使用下列命令管理连接器。

操作

命令

启动连接器service DL start
停止连接器service DL stop
重新启动连接器服务 DL 重新启动

乌布图:

  • 要管理连接器服务的命令必须用 Sudo 运行。例如， sudo 服务 DL 开始。

  • 日志信息将打印到日志文件 {installation path} /log/hpmc_daemon_service.log，而不是控制台输出。

后退到顶部

启用本地化

要使用英语以外的受支持语言显示系统应用程序 (用于运行设备本身的应用程序)，请在安装连接器后转至 /opt/FunctionalTestingLabForMobileAndWeb/connector/conf/connector.properties，并在文件中取消注释以下行:
ENABLE _ LOCALIZATION = true

后退到顶部

卸载连接器

可以按如下方式卸载连接器:

  1. 日志作为 root 用户进入 Linux 连接器计算机。

  2. 将目录更改为连接器安装目录:
    cd < 安装文件夹的路径 > (默认/opt/FunctionalTestingLabForMobileAndWeb/)
  3. 运行卸载脚本通过输入以下命令:
    ./DL_uninstall
  4. 点击输入，以便继续拆除连接器。

注: 如果使用现有的 Linux 用户安装或升级了连接器，则在卸载过程中将询问您是否删除此用户。如果在安装期间使用了 OpenText Functional Testing Lab 创建的默认新用户，则会自动删除此用户。

后退到顶部

更改连接器的配置

如果您需要修改连接器的详细信息，例如更改服务器或连接器的详细信息，可以通过更新工具来完成。运行该工具时，可以更新以下详细信息。

机器可以修改的详细资料
服务器

  • IP 地址或 FQDN

  • 端口

  • 安全连接或非安全连接 (SSL)

  • 代理信息

连接器

  • 凭据

  • 连接器名称

  • 连接器 IP 地址

  • 连接器端口

要更改连接器的配置，请执行下列操作:

  1. 开启连接器计算机，以 root 用户或 Linux sudoers 文件中的用户身份登录。
  2. 导航到连接器安装目录。
    默认 opt/FunctionalTestingLabForMobileAndWeb/
  3. 运行以下命令:
    ./DL_update
  4. 出现提示时，请指定新的详细信息。
  5. 重新启动过程结束时的连接符，以使更改生效。
  6. 仅限 SSL 访问: 在服务器详细信息更改后修改连接器详细信息时，将为连接器生成一个新证书。测试工具用户还需要重新配置其对 OpenText Functional Testing Lab. 的 SSL 访问

后退到顶部

修补程序安装

要从最新的增强功能和修复中获益，请安装最新版本的修补程序。服务器和连接器补丁可从软件许可和下载下载。最新的修补程序包括以前任何修补程序的内容。无需安装以前的修补程序。

重要信息: 如果使用远程 iOS 签名服务，则应在升级服务器之前升级此服务。

在将服务器升级到最新的修补程序时，还应该升级以下内容:

  • 所有连接符。

  • 手动签名工具 (如果适用)。

    • iOS 启用手动签署 iOS 应用程序。安装服务器修补程序后，可在代理文件夹中找到 iOS 启用程序。补丁可从 ADM Marketplace 获取。

    • Android 启用程序以手动签署 Android 应用程序。安装服务器修补程序后，服务器文件夹中提供了更新后的 Android Enabler。

按照修补程序发行说明中包含的修补程序安装说明进行操作。

另请参阅: