Linux 安装

此部分描述了如何在 Linux 计算机上安装 OpenText Functional Testing Lab 服务器。

本文档与 OpenText Core SDP 和 OpenText Core Functional Testing Lab 无关。

开始之前

在安装或升级 OpenText Functional Testing Lab 前，请确保已满足以下先决条件。

前提条件详细信息
服务器要求检查服务器是否满足支持矩阵中指定的要求。
权限

需要超级用户权限。

乌布图: 安装需要 Sudo 许可。

服务器辅助功能服务器计算机的主机名是可访问的。通过运行以下命令进行检查:
ping -c 1 "hostname"
iOS 设备如果打算使用 USB 电缆将 iOS 设备连接到服务器计算机，请确保启用了 IPv6。

仅限新安装

  • 如果服务器计算机上已安装了 nginx，请在安装 OpenText Functional Testing Lab 之前将其删除。
  • CentOS 7.6 - 7.9: X11 转发是必需 .

    1. 安装必需程序包:
      2. Copy code
      yum install -y xorg-x11-server-Xorg xorg-x11-xauth xorg-x11-apps

    2. 启用 X11 转发。

      打开 SSH 配置文件:

      3. Copy code
      vi /etc/ssh/sshd_config

      取消注释或添加以下行:

      Copy code
      X11Forwarding yes

    3. 重新启动 SSH 服务:

      4. Copy code
      systemctl restart sshd

后退到顶部

Ubuntu 考虑事项

在 Ubuntu 上安装服务器时，需要考虑许多注意事项。

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

支持 Ubuntu 完全安装和 Ubuntu 最小安装。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 设备。

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

后退到顶部

使用外部数据库

作为服务器安装的一部分安装的内嵌 PostgreSQL 数据库。但是，您可以将 OpenText Functional Testing Lab 连接到现有外部 PostgreSQL 数据库。此选项使您的组织可以管理和利用现有数据库资源。

在使用外部数据库安装或升级之前:

  1. 按照 hp4m.bin 文件格式，创建原始数据库的备份。有关详细信息，请参阅导出嵌入式数据库。
  2. 如果在未卸载 PostgreSQL 数据库的情况下卸载该服务器，并且现在从外部使用该数据库进行新的安装，请将 postgres 用户添加到 pg_hba.conf 文件中。该文件位于 <Postgres_installdir>/<postgres 版本>/data。

    3. postgres user listed in postgres configuration file
    还需要原始数据库加密密钥。外部数据库需要密钥来解密最初由 OpenText Functional Testing Lab 创建的数据。

  1. 在外部数据库与 OpenText Functional Testing Lab 位于不同计算机上的分布式环境中，请确保数据库服务器接受来自 OpenText Functional Testing Lab 服务器的连接，并且将 OpenText Functional Testing Lab 配置为连接到正确的数据库服务器计算机:
    • 在 <Postgres installdir>/<postgres version>/data 下的文件中，搜索 listen_addresses =。指定服务器侦听连接的地址。请使用 OpenText Functional Testing Lab 服务器 IP 或完全限定的域名 (FQDN) 更新该值。将该值设置为通配符“*”表示数据库服务器接受来自所有地址的连接。
    • 查找 conf/hp4mExt-****.properties 文件在 <OpenText Functional Testing Lab_ installdir>/server/conf.检查 IP 地址 /FQDN 是否为数据库服务器的正确地址。如果由于 DNS 问题 OpenText Functional Testing Lab 服务器无法访问 FQDN，请将 FQDN 替换为数据库计算机的 IP 地址。
  2. 还原数据库。有关详细信息，请参阅将导出的数据迁移到外部数据库。
  3. 如果 PostgreSQL 数据库超过 4GB，OpenText 建议执行 VACUUM FULL 命令清理数据库中已删除的内容，并调整其大小。有关详细信息，请参阅 PosgreSQL 文档。
  4. 可选 : 您可以配置 PostgreSQL Server 以启用 SSL 连接。

    启用到数据库服务器的安全连接:

    1. 生成 SSL 证书。

      创建服务器私钥、服务器证书和证书颁发机构 (CA) 证书。

    2. 将证书和密钥移动到相应的目录，例如 /var/lib/postgresql/data.请确保文件具有正确的权限。

    3. 通过打开 Postgresql.conf 文件并设置以下参数，使用编辑配置 PostgreSQL :

      • ssl = on

      • ssl_cert_file = <server.crt>

      • ssl_key_file = <server.key>

        ssl_ca_file = <root.crt>

    4. 编辑 pg_hba.conf 文件。

      通过修改 host 至 hostssl 配置客户端鉴权使用 SSL。

    5. 重新启动 PostgreSQL Server。

Postgres 13 的重要说明

密码验证仅支持 md5 方法。安装 Postgres 13 后，请执行以下操作:

  1. 在 postgres 配置文件 <postgresql 13 path>/data/postgresql.conf 中，将密码加密设置更改为 md5:
    Password _ encryption = md5

  2. 在 pg_hba.conf 文件 <postgresql 13 path>/data/pg_hba.conf 中，所有出现的 scram-sha-256 都会被更改为 md5。

  3. 重新启动 postgresql-13 服务。
  4. 重置 postgresql13 用户密码并重新启动。

后退到顶部

将服务器作为新安装进行安装

OpenText Functional Testing Lab 可以作为未安装早期版本的完整安装进行安装。

要安装服务器，请执行以下步骤:

  1. 下载 Linux 服务器 zip 文件。

  2. 使用根权限登录 Linux 计算机。
  3. 复制 zip 文件到 Linux 计算机。
  4. 解压缩服务器安装文件:
    unzip <Linux 服务器文件名>.zip –d <目标目录名称>
  5. 将目录更改为目标目录：
    cd <目标目录名称>

  6. 运行安装程序:

    用户具有超级用户权限:
    。/< install_server-x64 文件名 >.bin

    安装向导将显示“简介”页。读取内容并按 Enter。

  7. 安装向导将显示许可协议。按 Enter 在页面中移动，然后按 Y 接受协议。
  8. 选择安装文件夹。默认值为 /opt/FunctionalTestingLabForMobileAndWeb/。
  9. 配置 LinuxOS 用户:

    10. 要使用现有的 LinuxOS 用户，请选择 Y 并提供用户名。

    警告: 不要使用与运行此安装的具有 root 权限的用户相同的名称。

    如果选择 n，OpenText Functional Testing Lab 会创建一个默认的 Linux OS 用户 DL。为此用户提供新密码。

  10. 根据以下原则配置服务器。

    服务器配置详细信息
    FQDN 或 IP 地址

    完全限定的域名 (FQDN) 由主机名和域名组成。例如，myhost.opentext.com。FQDN 必须以英文字母字符开头。不支持以数字开头的 FQDN。

    SSL 连接

    指定到服务器的连接是否只应通过 SSL。

    默认值为 Y(仅限安全连接) 。

    备注: 如果选择 SSL 选项，则从连接器和测试工具计算机到服务器的所有连接都需要安全。在连接器和工具中配置 OpenText Functional Testing Lab 设置时，请确保您的选择与服务器的选择匹配。
    如果要使用 SAML 2.0 的单一登录，请使用默认值 Y。

    警告: 指定 SSL 连接时，安装程序将安装自签名证书。自签名证书不是最佳的，因为没有外部授权来验证服务器的标识。 OpenText 强烈建议您在将服务器投入生产后安装组织 CA 证书。有关详细信息，请参阅使用由证书颁发机构颁发的 SSL 证书。

    服务器端口

    预留者默认情况下，安装设置为 SSL 在端口 8443。默认的非 SSL 使用端口 8080。

    要在内部使用的空闲端口默认: 8081
    嵌入式连接器此组件是可选的。如果您计划将设备直接连接到 OpenText Functional Testing Lab 计算机，请将该连接器放在此处。
    默认用户安装将创建默认管理员用户 admin @ default.com ,，用于访问 OpenText Functional Testing Lab 控制台。指定此用户的密码。
    临时文件的本地文件夹

    指定用于临时文件的本地文件夹，或接受默认值。

  11. 可选: 配置外部 PostgreSQL 数据库。

    嵌入的 PostgreSQL 数据库会作为服务器安装的一部分进行安装。但是，您可以通过选择使用外部 PostgreSQL 数据库的选项来连接到现有的外部数据库。通过使用外部数据库，您的组织可以利用现有的数据库资源并使用所有其他系统管理这些资源。如果要使用嵌入 OpenText Functional Testing Lab 的 PostgreSQL 版本，请跳到下一步。

    使用外部数据库进行安装之前，请确保已执行了使用外部数据库中所述的步骤。

    当系统提示是否使用外部 PostgreSQL 数据库时，请键入 y。

    确保数据库计算机是可访问的，并为该连接提供以下信息。

    数据库配置详细信息
    外部数据库服务器

    数据库计算机的 IP 地址或完全限定的域名 (FQDN)。

    数据库端口外部数据库计算机的端口。
    数据库

    外部数据库的名称。支持的数据库名称为 hp4m。可以使用目标数据库服务器中已存在的名称。如果数据库不存在，则在用户具有足够权限的情况下，它将作为 OpenText Functional Testing Lab 服务器安装的一部分创建。

    架构 

    支持使用类似 public 的架构名称。可以使用指定数据库中已存在的名称。如果该架构不存在，则在用户具有足够权限的情况下，该模式将作为服务器安装的一部分创建。

    注: 如果数据库/架构最初是由 OpenText Functional Testing Lab 创建的 (例如，如果卸载了服务器但未安装 PostgreSQL 数据库)，则会在进入下一个屏幕时提示您提供加密密钥。如果数据库/架构不是由 OpenText Functional Testing Lab 创建的，则不需要提供加密密钥。

    用户凭据PostgreSQL 数据库用户名和密码。
    SSL 连接

    若要使用 SSL 启用实验室服务器连接到外部数据库服务器，请键入 y。

    指定根证书的位置，以启用到外部 PostgreSQL 数据库的 SSL 连接。服务器必须能够访问证书。仅支持扩展名为 .crt 的文件。

    此选项要求为 SSL 连接配置外部 PostgreSQL 数据库。要配置数据库以进行 SSL 连接，请参阅使用外部数据库

  12. 使用 PostgreSQL 数据库的嵌入式版本时，请按照以下指导配置 PostgreSQL。
    13. 数据库配置详细信息
    数据库服务器端口默认: 5432
    PostgreSQL 超级用户密码

    首次安装 PostgreSQL 服务器时，将自动创建一个超级用户帐户 postgres。需要超级用户来创建 OpenText Functional Testing Lab 数据库架构，并添加用于管理数据库的用户。超级用户可以覆盖数据库中的所有访问限制，因此最好使用非超级用户角色执行大多数操作。

    您需要为超级用户提供密码:

    • 密码长度必须介于 6 到 20 个英文字符之间 (允许使用任何英文字母、数字和特殊字符“@”和“_”)。
    • 至少包含一个数字、一个大写和一个小写的英语字符。
    PostgreSQL 数据库管理员用户名

    安装过程将创建一个用于管理数据库的其他用户。此用户不是超级用户，仅有权对 OpenText Functional Testing Lab 数据库执行操作。

    您需要为数据库管理员提供用户名 (默认: DLadmin)。用户名可以由任何小写英文字母字符、数字和特殊字符“_”组成。

    不要使用 postgres 作为此用户的名称。

    PostgreSQL 数据库管理员密码

    您需要为数据库管理员提供密码。

    密码必须至少包含一个数字、一个大写和一个小写的英文字符，并且长度必须在 6 到 20 个英文字符之间。允许使用任何英语字母字符、数字以及特殊字符“@”和“_”。

  13. 选择将上载到 OpenText Functional Testing Lab 的应用程序保存到的文件夹。默认值为 opt/FunctionalTestingLabForMobileAndWeb /storage。对于运行此安装的用户，以及在安装开始时定义的 Linux OS 用户，均需要此文件夹的读写权限。

  14. 可选。共享空间 (多租用) 配置。

    如果需要，请启用共享空间功能。
    重要信息: 此功能需要企业版或旗舰版许可。不支持禁用共享空间，需要全新安装。有关详细信息，请参阅共享空间。
  15. 查看安装前摘要并按 Enter 键继续安装。
  16. 安装需要几分钟才能完成。安装完成后，将显示一条消息，指出服务器已安装，并提供以下选项:
    • 允许收集匿名数据以改进产品。安装之后，您可以在 管理设置 中修改对此选项的选择。
    • 开始服务。默认情况下，服务器通过端口 8443 (HTTPS) 或 8080 (HTTP) 启动，除非在安装过程中另行指定。
  1. 安装后，OpenText 强烈建议您结合以下有关应用程序文件存储文件夹和外部数据库的信息，以保证文件和数据安全 (如果相关):

    • 访问监视

    • 有限的访问权限 (仅限 OpenText Functional Testing Lab 用户)

    • 常规备份

    • 加密

    • 存储消耗监视。可以设置文件存储总量阈值，并使用管理仪表板中的文件存储小部件监视此情况。有关详细信息，请参阅文件存储。

    OpenText 还建议您:

    • 在安装文件夹和临时文件夹上合并文件系统监视。
    • 备份位于 <OpenText Functional Testing Lab 服务器安装路径>/Server/conf 目录下的 encrypted.properties 文件。

后退到顶部

升级服务器

OpenText Functional Testing Lab 它可以作为升级到现有安装。

要确保顺利升级，请参阅升级的最佳实践。

注入代码的应用程序: 
要在 iOS 应用程序上运行应用程序代码注入程序升级程序，必须已按照自动签名服务中所述设置 Mac 计算机。

如果您在命令行中手动添加了代码注入应用程序，然后再将这些应用程序上传到 OpenText Functional Testing Lab，升级程序将无法再升级这些应用程序。需要使用最新版本的 iOS 或者 Android Enabler 对您的应用程序进行重新打包，然后上传至 OpenText Functional Testing Lab。

要升级服务器，请执行以下步骤:

  1. 下载 OpenText Functional Testing Lab Linux 服务器 zip 文件。

  2. 作为在 Linux 计算机上具有 root 权限的用户中的用户。
  3. 复制 zip 文件到 /root，即您的主目录。
  4. 解压缩服务器安装文件:
    unzip < Linux 服务器文件名>.zip|ndash; d <目标目录名称>
  5. 将目录更改为目标目录：
    cd <目标目录名称>
  6. 运行安装程序:
    作为具有超级用户权限的用户:
    。/< install_server-x64 文件名 >.bin

    安装向导将显示“简介”页。读取内容并按 Enter。
  7. 阅读许可协议，然后选择 y 接受条款并继续安装。
  8. 安装程序检测到这是升级，并相应地发出警告。升级时，所有现有应用程序仍与其对应的工作区相关联。
  9. 输入 PostgreSQL 超级用户密码。
  10. 指示您是否要在升级过程中执行数据库的自动备份，以便安装可以在失败时执行回滚。此步骤可能会延长升级的持续时间。
  11. 指明安装后是否要自动运行应用程序代码注入程序升级程序。应用程序在升级 OpenText Functional Testing Lab 服务器后异步升级，从而减少服务器停机时间。个用户能够访问升级后的服务器，并在升级应用程序时继续使用 OpenText Functional Testing Lab。

    如果您选择不自动运行，可以在升级后手动运行。 有关详细信息，请参阅升级注入代码的应用程序。

  12. 您还可以删除应用程序的旧上载。如果选择 y，则指定要保留的上载的数量 (默认: 30)。当您选择删除旧上载的选项并指定要保留的上载数量时，这些设置将复制到 “管理”>“设置” 中的常规部分。有关详细信息，请参阅常规设置。
  13. 选择一个文件夹，将上载到 OpenText Functional Testing Lab 的应用程序保存到该文件夹中。对于运行此升级的用户以及在初始安装过程中定义的 LinuxOS 用户，都需要文件夹的读写权限。
  14. 如果您选择升级应用，系统会提示您选择要升级的应用的操作系统。

  15. 查看安装前摘要并按 Enter 键继续安装。

  16. 在“包升级摘要”部分中，单击 Enter 以完成服务器升级。升级服务器后，应用程序继续升级。

    当服务器启动后，安装之后，您可以通过控制台应用程序菜单查看应用程序的升级状态。要查看应用程序的状态，请单击应用程序卡上的更多信息图标 。下面的示例显示了正在升级的应用程序。

    17. App in the proces of being upgraded

  17. 安装完成后，将显示一条消息，指出服务器已安装，并提供一个选项，允许收集匿名数据以改进产品。安装完成后，您可以在管理设置中修改此选项的选择。
  18. 退出安装程序。
  19. 升级后:
    • 清除浏览器缓存，然后再登录到实验室管理控制台。测试工程师应在连接到 OpenText Functional Testing Lab 之前清除测试工具计算机上的浏览器缓存。
    • iOS: 使用开发人员证书重新签署代理应用程序。有关详细信息，请参阅连接 iOS 移动设备。

    为确保文件和数据的安全，OpenText 强烈建议您在应用程序文件存储文件夹和外部数据库中合并以下内容 (如果相关):

    • 访问监视

    • 有限的访问权限 (仅限 OpenText Functional Testing Lab 用户)

    • 常规备份

    • 加密

    • 存储消耗监视。可以设置文件存储总量的阈值，并使用管理仪表板中的文件存储小部件监视此情况。有关详细信息，请参阅文件存储。

    OpenText 还建议您:

    • 在安装文件夹和临时文件夹上合并文件系统监视。
    • 备份位于 OpenText Functional Testing Lab 服务器安装路径>/Server/conf 目录下的 encrypted.properties 文件。

后退到顶部

停止，启动或重新启动服务器

可以使用以下命令停止和启动服务器:

  • 启动服务器:service DL start
  • 停止服务器:service DL stop

  • 要重新启动服务器，请执行下列操作: 服务 DL 重新启动

乌布图: 日志信息将打印到日志文件 <OpenText Functional Testing Lab _server_installdir > /log/hpmc_daemon_service.log，而不是控制台。

后退到顶部

服务器日志

OpenText 建议不要在服务器运行时删除服务器日志。但是，如果需要在服务器在 Linux 上运行时清除日志文件，则可以运行以下命令:

cat/dev/null > < logFileName >

当删除日志文件以增加可用磁盘空间时，OpenText 建议仅删除带编号后缀的日志文件。例如，connectorKeepAlive-1.log ,connectorKeepAlive-2.log。

后退到顶部

修改服务器

如果需要，可以通过运行更新工具来修改服务器配置。有关详细信息，请参阅重新配置服务器。

后退到顶部

修补程序安装

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

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

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

  • 所有连接符。

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

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

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

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

后退到顶部

故障排除

请按照以下步骤解决由于缺少 createrepo 软件包而导致的服务器安装错误。

如果遇到此错误，请手动安装 createrepo 工具:

  1. 运行以下命令:

Copy code
sudo yum install createrepo

  1. 安装 OpenText Functional Testing Lab 服务器。

后退到顶部

另请参阅: