Digital Lab- Linux 安装

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

开始之前

安装或升级 Digital Lab 之前:

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

  • 您具有 root 权限。
  • 服务器计算机的主机名是可访问的。通过运行以下命令进行检查:
    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

后退到顶部

使用外部数据库

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

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

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


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

  1. 在外部数据库与 Digital Lab 位于不同计算机上的分布式环境中，请确保数据库服务器接受来自 Digital Lab 服务器的连接，并且将 Digital Lab 配置为连接到正确的数据库服务器计算机:
    • 在 < Postgres 安装文件夹>/< postgres 版本>/data 下存储的 postgresql.conf 文件中，搜索 listen _ addresses =。指定服务器监听连接的地址。更新具有 Digital Lab 服务器 IP 或 FQDN 的值。将该值设置为通配符"*"表示数据库服务器接受来自所有地址的连接。
    • 在 <Digital Lab 安装文件夹> /server /conf 中找到 conf /hp4mExt - * * * *.properties 文件。检查 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 用户 UFTM。为此用户提供新密码。

  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 数据库执行操作。

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

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

    PostgreSQL 数据库管理员密码

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

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

    注: 从版本 3.2 开始，, 应用程序不再存储在数据库中，而是保存到文件系统中。

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

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

    • 访问监视

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

    • 常规备份

    • 加密

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

    我们还建议您:

    • 在 Digital Lab 安装和临时文件夹中合并文件系统监视。
    • 后退 theencrypted.properties file located in the < path to yourDigital Lab server installation >服务器> conf directory.

后退到顶部

升级 Digital Lab 服务器

Digital Lab 可以作为 Digital Lab (UFT Mobile)3.2 或更高版本的现有安装的升级进行安装。

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

注入代码的应用程序:  
要在 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 用户，都需要文件夹的读写权限。

    注: 从 Digital Lab 3.2 版开始，应用程序不再存储在数据库中，而是保存到文件系统中。

  14. 如果选择升级应用程序，系统将提示您选择要升级的应用程序的操作系统。

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

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

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

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

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

    • 访问监视

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

    • 常规备份

    • 加密

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

    我们还建议您:

    • 在 Digital Lab 安装和临时文件夹中合并文件系统监视。
    • 后退 theencrypted.properties file located in the < path to yourDigital Lab server installation >服务器> conf directory.

后退到顶部

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

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

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

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

后退到顶部

服务器日志

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

cat/dev/null > < logFileName >

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

升级最佳实践

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

准备升级

在开始升级过程之前:

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

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

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

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

执行升级

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

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

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

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

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

升级检查表

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

登录 日志作为 admin 用户添加到 Digital Lab。

用户

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

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

后退到顶部