Linux 安装

此部分描述了如何在 Linux 计算机上安装 Digital Lab 服务器。此部分仅与UFT Digital Lab相关。有关在 Windows 计算机上安装服务器的信息，请参阅Windows 安装。

开始之前

安装或升级Digital Lab之前:

  • 请参见支持 Linux 版本的支持矩阵。有关详细信息，请参阅支持矩阵。备注: Ubuntu 仅支持 UFT Digital Lab 版本 24.2 和 ValueEdge Digital Lab。
  • 确保您的服务器计算机满足系统要求。

仅限 Linux : 如果要通过 USB 将 iOS 设备连接到此计算机，请确保已启用 IPV6。

  • 您具有 root 权限。乌布图: 安装需要 Sudo 许可。
  • 服务器计算机的主机名是可访问的。通过运行以下命令进行检查:
    ping -c 1 "hostname"
  • 仅新安装: 
    • 如果服务器计算机上已安装了 nginx，请在安装Digital 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 仅支持 UFT Digital Lab 版本 24.2 和 ValueEdge Digital Lab。

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

考慮 详细信息
版本支持 仅支持 Ubuntu 版本 22.04.3 (LTS)。
安装类型

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

后退到顶部

關於 iOS 17 的評論

如果您计划将 iOS 17 设备直接连接到服务器，则需要考虑一些问题。

考慮 详细信息
OS

UFT Digital Lab 版本 24.2 和 ValueEdge Digital Lab: iOS 17 目前仅支持 Linux Ubuntu (22.04.3) 服务器。

UFT Digital Lab 23.4: iOS 17 当前仅在 Mac 连接器上受支持。
互联网连接

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

  • 千万

  • 时间.apple.com

  • devimages-cdn.apple.com 中

  • 此分類上一篇: Apple.com

  • ITunes.com

  • 开发服务 2.apple.com

  • 開發服務 2.v.aaplimg.com

OpenText 建议允许访问所有 *.apple 域名。
支持

iOS 17 不支持下列内容:

  • 连接 AWS Device Farm 和 WeTest 设备。

  • 强迫停止申请

后退到顶部

使用外部数据库

Digital Lab 包括作为Digital Lab安装的一部分安装的嵌入 PostgreSQL 数据库。但是，您可以选择将Digital Lab连接到现有外部 PostgreSQL 数据库。此选项使您的组织可以管理和利用现有数据库资源。

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

  1. 创建以hp4m.bin文件的形式备份原始数据库。有关详细信息，请参阅导出嵌入式数据库。
  2. 如果卸载了服务器但未卸载 PostgreSQL 数据库，并且现在将数据库用作全新安装Digital Lab的外部数据库，则将 postgres 用户添加到pg_hba.conf文件。该文件位于 <Postgres_installdir>/<postgres 版本>/data。


    3. 还需要原始Digital Lab数据库加密密钥。外部数据库需要密钥来解密最初由Digital Lab创建的数据。

  1. 在外部数据库与Digital Lab位于不同计算机上的分布式环境中，请确保数据库服务器接受来自Digital Lab服务器的连接，并且将Digital Lab配置为连接到正确的数据库服务器计算机:
    • 在 postgresql.conf 文件存储在 <Postgres installdir>/<postgres 版本>/data 搜索 listen_addresses = 。指定服务器监听连接的地址。更新具有Digital Lab服务器 IP 或 FQDN 的值。将该值设置为通配符“*”表示数据库服务器接受来自所有地址的连接。
    • 查找 conf/hp4mExt-****.properties 文件在 <Digital Lab_ installdir>/server/conf.检查 IP 地址 /FQDN 是否为数据库服务器的正确地址。如果由于 DNS 问题Digital Lab服务器无法访问 FQDN，请将 FQDN 替换为数据库计算机的 IP 地址。
  2. 还原数据库。有关详细信息，请参阅将导出的数据移植到外部数据库。
  3. 如果 PostgreSQL 数据库超过 4GB，我们建议您运行 VACUUM FULL 命令从删除的内容中清除该数据库并减小其大小。有关详细信息，请参阅 PosgreSQL 文档。

后退到顶部

Postgres 13 的重要说明

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

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

  2. 在 pg _ hba.conf 文件< postgresql 13path >/data/pg_hba.conf中，将所有出现的编码 - sa - 256 更改为 md5。

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

后退到顶部

安装Digital Lab作为新安装

按照以下步骤将Digital Lab 作为未安装先前版本的完整安装进行安装:

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

  2. 日志 in，具有 Linux 计算机上的 root 权限。
  3. 复制 zip 文件到 Linux 计算机。
  4. 解压缩服务器安装文件:
    unzip < Linux 服务器文件名>.zip|ndash; d <目标目录名称>
  5. 将目录更改为目标目录：
    cd <目标目录名称>

  6. 运行安装程序:

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

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

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

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

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

    如果选择 n，则 Digital Lab 将创建默认的 LinuxOS 用户 DL。为此用户提供新密码。

  10. 根据以下准则配置 Digital Lab 服务器:

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

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

    SSL 连接

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

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

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

    服务器端口

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

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

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

  11. 在 PostgreSQL 配置阶段，安装程序会提示您指明是否使用外部 PostgreSQL 数据库。通过使用外部数据库，您的组织可以利用现有的数据库资源并使用所有其他系统管理这些资源。如果要使用嵌入 Digital Lab 的 PostgreSQL 版本，请跳到下一步。

    在使用外部数据库安装 Digital Lab 之前，请确保已按照使用外部数据库中所述的步骤进行操作。

    当提示是否要使用外部 PostgreSQL 数据库时，键入 " y"。

    确保数据库计算机可访问，并为连接提供以下参数:

    • 外部数据库服务器: 数据库计算机的 IP 地址或完全限定域名称 (FQDN) 。
    • 数据库端口: 外部数据库计算机的端口。
    • 数据库: 外部数据库的名称。可以使用数据库名称，如“ hp4m ”。此数据库可能已存在于目标数据库服务器中。如果不是，则在用户具有足够权限的情况下，它将作为 Digital Lab 服务器安装的一部分创建。

    • 架构: 可以使用模式名称，如“ public ”。此架构可能已存在于指定的数据库中。如果不是，则在用户具有足够权限的情况下，会将其创建为 Digital Lab 服务器安装的一部分。

      注: 如果 database/schema 最初由 Digital Lab 创建 (例如，如果卸载服务器但不卸载 PostgreSQL 数据库) ，则在进入下一屏幕时，系统将提示您提供加密密钥。如果数据库/架构不是由 Digital Lab 创建的，则无需提供加密密钥。

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

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

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

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

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

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

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

    PostgreSQL 数据库管理员密码

    		您需要为数据库管理员提供密码。
    密码必须至少包含一个数字、一个大写和一个小写的英文字符，并且长度必须在 6 到 20 个英文字符之间。任何字母字符、数字和特殊字符“@”和“_”是允许的。

  13. 选择将上载到 Digital Lab 的应用程序保存到的文件夹。默认值为 opt/UFTDigitalLab/storage.运行此安装的用户和在安装开始时定义的 LinuxOS 用户都需要对文件夹具有读写权限。

  14. (可选) 设置共享空间 (多方租用) 配置:
    如果需要，请启用共享空间功能。
    重要信息: 此功能需要企业版或旗舰版许可。不支持禁用共享空间，需要全新安装。有关详细信息，请参阅共享空间。
  15. 查看安装前摘要并按 Enter 键继续安装。
  16. 安装需要几分钟才能完成。安装完成后，将显示一条消息，指出服务器已安装，并提供以下选项:
    • 允许收集匿名数据以改进产品。安装管理设置 后，可以修改此选项的选择。
    • 开始服务。除非在安装过程中另行指定，否则默认情况下，服务器在端口 8443 (HTTPS) 或 8080 (HTTP) 上启动。
  1. 安装后:

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

    • 访问监视

    • 有限的访问权限 (仅限 Digital Lab 用户)

    • 常规备份

    • 加密

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

    我们还建议您:

    • 在 Digital Lab 安装和临时文件夹中合并文件系统监视。
    • 备份<Digital Lab 服务器安装目录 > server > conf 目录中的 encrypted.properties 文件。

后退到顶部

升级 Digital Lab 服务器

Digital Lab 它可以作为升级到现有安装。

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

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

如果您的应用程序是从命令行手动注入代码添加的，然后上传到 Digital Lab，则升级程序将无法再升级这些应用程序。在将应用程序上传到 Digital Lab 之前，需要使用最新版本的代码注入程序服务 (iOS) 或 Android Enabler 将您的应用程序重新打包。

升级 Digital Lab 服务器:

  1. 下载 Digital 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. 指示是否要在安装后自动运行应用程序代码注入程序升级程序。应用程序在升级 Digital Lab 服务器后异步升级，从而减少服务器停机时间。个用户能够访问升级后的服务器，并在升级应用程序时继续使用 Digital Lab。

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

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

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

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

    请注意，安装完成且服务器启动后，您可以在 Digital Lab 控制台的应用程序菜单中检查应用程序的升级状态。要查看应用程序的状态，请单击应用程序卡上的更多信息图标。下面的示例显示了正在升级的应用程序。

    17. App in the proces of being upgraded

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

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

    • 访问监视

    • 有限的访问权限 (仅限 Digital Lab 用户)

    • 常规备份

    • 加密

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

    我们还建议您:

    • 在 Digital Lab 安装和临时文件夹中合并文件系统监视。
    • 备份 encrypted.properties 文件位于 Digital Lab_ server_installdir> Server >conf 目录。

后退到顶部

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

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

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

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

乌布图: 登录信息将打印到登录文件 <Digital Lab_server_installdir>/log/hpmc_deamon_service.log 而不是控制台。

后退到顶部

服务器日志

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

cat/dev/null > < logFileName >

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

升级最佳实践

为了确保顺利升级并防止数据丢失，强烈建议首先在与生产计算机具有相同操作系统的测试计算机上执行升级。如果在测试计算机上升级成功，则可以继续升级生产服务器。

准备升级

在开始升级过程之前:

  1. 如果您使用的是 iOS 代码注入程序服务，请在运行升级过程之前将其升级到新版本。有关详细信息，请参阅自动签名服务。

  2. 按照安装期间的提示，确定是否要在升级过程中升级您的应用程序。

    • 应用程序无同步升级。用户可以访问并继续使用升级后的服务器，同时正在升级应用程序。可以在实验室控制台的应用程序菜单中检查应用程序的升级状态。
    • 如果不想自动升级应用程序，可以在稍后阶段升级应用程序。有关详细信息，请参阅升级注入代码的应用程序。
  3. 备份现有 Digital Lab 数据库有关详细信息，请参阅导出嵌入式数据库。

  4. 准备与生产环境具有相同操作系统的测试计算机。其他硬件参数 (如 CPU 和 RAM) 可以不同。此计算机用作升级的测试环境。

执行升级

建议您在上述准备的测试计算机上执行升级。升级 Digital Lab 如下所示:

  1. 安装与生产环境具有相同操作系统的测试计算机上的当前 Digital Lab 服务器版本。
  2. 将原始数据库导入到测试计算机。有关详细信息，请参阅将导出的数据移植到外部数据库。

  3. 通过在测试计算机上登录 Digital Lab 并验证应用程序、设备、设置和其他项目 (如升级检查表中所示) ，验证导入是否成功。请注意，您无法与这些连接器通信，因为它们被配置为与生产机器一起使用，而不是与测试机器一起使用。

  4. 找到要升级到的 Digital Lab 版本的服务器安装文件。
  5. 提取其内容并在测试计算机上运行文件，如升级 Digital Lab 服务器中所述。如果在升级期间遇到任何困难，请与支持联系。
  6. 通过在测试计算机上登录 Digital Lab 并验证应用程序、设备、设置和其他项 (如升级检查表中所示) ，验证导入是否成功。
  7. 可选: 安装是升级后的测试计算机上的新连接器，并尝试通过其中一个集成测试工具运行测试。

  8. 如果上述所有信息在测试计算机上都正确，则转到生产计算机上的升级 Digital Lab 服务器。

升级检查表

在测试计算机上完成升级过程后，请检查以下各项以确保升级成功:

物品 详细信息
登录 日志作为管理员用户添加到 Digital Lab。

用户

检查是否已将所有用户迁移到管理 > 用户页中的 Digital Lab。
设置 检查是否已从生产环境迁移所有管理设置。
应用程序 如果选择在升级过程中升级应用程序，请确保所有应用程序在应用程序屏幕中可见。
连接器 验证所有连接器在设备 > 连接器页中是否可见。请注意，您无法与这些连接器通信，因为它们被配置为与生产机器一起使用，而不是与测试机器一起使用。
设备 确保看到生产环境的所有设备。

如果缺少任何项或遇到任何其他问题，请与支持联系。

后退到顶部

修补程序安装

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

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

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

  • 所有连接器

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

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

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

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

后退到顶部

故障排除

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

  1. 运行以下命令:

Copy code
sudo yum install createrepo

  1. 安装 UFT Digital Lab 服务器。

后退到顶部

另请参阅: