安装连接器在 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. 从服务器获取连接器的访问键。

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

后退到顶部

关于 Ubuntu 的注意事项

在 Ubuntu 上安装服务器时，需要考虑许多注意事项。有关更多详细信息，请参阅支持矩阵。

后退到顶部

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

若要连接 iOS 17 和更高版本上运行的设备，需要通过 Internet 随时从 Apple 获取签名密钥。服务器计算机必须能够访问以下内容:

  • 千万
    OpenText 建议允许访问所有 *.apple 域名。

如果服务器计算机通过代理服务器访问 Internet，请在“管理”设置中配置代理服务器详细信息。有关详细信息，请参阅管理设置中的代理设置。

如果计算机服务器不允许访问 Internet，请确保连接器可以访问 Apple 服务器。如果该连接器使用代理服务器，请在 <installation_dir>/connector or server/conf/ 下的 connector.properties 文件中配置以下代理服务器详细信息:

  • APPLE_HTTP_PROXY_HOST=<代理主机名>

  • APPLE_HTTP_PROXY_PORT=<代理端口号>

  • APPLE_HTTP_PROXY_USERNAME=<连接到代理服务器的用户名>

  • APPLE_HTTP_PROXY_PASSWORD=<用于连接到代理服务器的密码>

有关支持的操作系统以及应考虑的其他注意事项，请参阅支持矩阵。

后退到顶部

下载连接符

下载连接符的方法如下:

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

后退到顶部

安装连接器

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

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

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

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

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

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

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

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

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

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

后退到顶部

连接并验证设备

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

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

    设备 OS步骤
    Android

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

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

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

    iOS
    1. 转到:

      /opt/FunctionalTestingLabForMobileAndWeb/Connector/libimobiledevice/linux/

    2. 运行 ./idevice_id –l



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

    1. 在服务器或连接器计算机上，以 root 用户身份登录。
    2. 找到“usbmuxd”的进程 ID

      ps aux | grep '[u]sbmuxd'
    3. 终止进程:

      kill –9 <processID>
    4. 再次启动 usbmuxd:

      usbmuxd
    5. 再次运行 idevice_id –l 以查看是否识别设备。

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

    1. 单击 Trust。
    2. 断开连接设备。
    3. 等待 5 秒，然后重新连接设备。

  5. 仅限 iOS 设备:

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

    仅适用于企业证书的重要说明:

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

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

  6. 连接设备后，执行特定设备可能需要的任何其他配置。有关更多详细信息，请参阅已知设备问题。

后退到顶部

开始并停止连接器

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

操作

命令

启动连接器service FTLab start
停止连接器service FTLab stop
重新启动连接器service FTLab restart

Ubuntu:

  • 要管理连接器服务的命令必须用 Sudo 运行。例如 sudo/etc/init.d/FTLab start。

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

后退到顶部

启用本地化

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

后退到顶部

卸载连接器

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

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

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

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

后退到顶部

更改连接器的配置

如果需要修改连接器详细信息 (例如，更改服务器或连接器详细信息)，可以使用更新工具。运行该工具时，可以更新以下详细信息。

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

  • IP 地址或 FQDN

  • 端口

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

  • 代理信息

连接器

  • 凭据

  • 连接器名称

  • 连接器 IP 地址

  • 连接器端口

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

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

后退到顶部

更新

有时，会发布包含增强功能和修补程序的更新。

产品详细信息
OpenText Functional Testing Lab

要从最新的增强功能和修复中获益，请安装最新版本的修补程序。可从 软件许可和下载下载服务器修补程序。最新的修补程序包括以前任何修补程序的内容。无需安装以前的修补程序。按照修补程序发行说明中包含的修补程序安装说明进行操作。

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

将服务器升级到最新修补程序时，还必须升级以下内容:

  • 所有连接符。 OpenText 建议启用连接器的自动更新设置。这样，便无需在安装服务器更新时手动更新连接器。有关详细信息，请参阅“管理设置”中的常规。

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

    • iOS 启用手动签署 iOS 应用程序。iOS enabler 将在代理文件夹或 ADM Marketplace 中提供。

    • Android 启用程序以手动签署 Android 应用程序。在安装完服务器修补程序后，可以在服务器文件夹或 ADM Marketplace 找到更新的 Android 启用程序。

OpenText Core SDP

当 OpenText 更新部署到服务的时候，Connector 也需要升级。 OpenText 建议启用连接器的自动更新设置。有关详细信息，请参阅管理设置。

备注: 如果使用 iOS 或 Android Enabler 进行手动应用程序签署，更新服务器时需要升级它们。您可以从 ADM Marketplace 下载最新版本。

另请参阅: