Windows 安装

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

开始之前

在安装 Digital Lab 之前，确保满足以下先决条件:

服务器要求 检查服务器计算机是否满足支持矩阵中指定的要求。
权限 需要管理员权限
服务器辅助功能 服务器计算机的主机名必须是可访问的。请通过从 Windows 命令行运行以下命令来进行检查:
ping -n 1 "hostname"
驱动程序

检查是否已为 Android 设备安装 USB 驱动程序，或为 iOS 设备安装 iTunes。
仅限 Windows 11 内部版本 22572 和更高版本

安装 WMI 命令行 (WMIC) 实用程序。

  1. 打开设置，方法是同时按 Windows + I 键。

  2. 单击应用程序。

  3. 单击可选特征。

  4. 单击功能显示按钮。

  5. 搜索 Wmic。选择旁边的复选框，然后按下一步。

  6. 单击安装。

后退到顶部

使用外部数据库

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

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

  1. 创建以 hp4m.bin 文件的形式备份原始数据库。有关详细信息，请参阅导出嵌入式数据库。
  2. 如果在未卸载 PostgreSQL 数据库的情况下卸载 Digital Lab 服务器，并且现在将数据库用作新安装 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 地址。
  1. 还原数据库。有关详细信息，请参阅将导出的数据移植到外部数据库。
  2. 如果 PostgreSQL 数据库超过 4GB，我们建议您运行 VACUUM FULL 命令从删除的内容中清除该数据库并减小其大小。有关详细信息，请参阅 PostgreSQL 文档。

Postgres 13 的重要说明

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

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

  2. 在 pg_hba.conf 文件 <postgresql _13_installdir>/data/pg_hba.conf, 更改所有发生情况的 scram-sha-256 到 md5.

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

后退到顶部

完全安装

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

  1. 确保计算机上未安装连接器。如果是，则需要在安装 Windows Server 之前将其删除。有关详细信息，请参阅故障排除。
  2. 获取安装 zip 文件。使用提取工具将存档文件 install-server-windows-x64- x.xx-x.zip 的内容提取到计算机中。
  3. 日志在您的计算机作为管理员。
  4. 找到提取的 .exe 文件。请确保它位于本地驱动器上，而不是网络共享驱动器上。
  5. 单击安装文件，然后从右键单击菜单中选择运行 as administrator。安装向导将打开到简介页。
  6. 选择文件夹的安装和本地文件夹的临时文件。
  7. 如果计划仅使用独立连接器，并且不将设备直接连接到 Digital Lab 计算机 , 清除嵌入式连接器复选框。

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

    服务器配置 详细信息
    FQDN 或 IP 地址 使用自动检测到的值或根据需要对其进行修改。使用完全限定域名称 (FQDN) 时， FQDN 必须以英文字母中的字符开头。不支持以数字开头的 FQDN。
    SSL 连接

    清除仅限 SSL 复选框，以使用非安全 HTTP 连接 (非 SSL) 。 默认值为使用端口 8443 的安全 SSL 连接。

    请考虑以下指导原则:

    • SSL 设置会影响与服务器集成的所有连接器和测试工具。在连接器和工具中配置 Digital Lab 设置时，请确保您的选择与服务器的选择匹配。

    • 如果要通过 SAML 2.0 使用单一登录，请不要清除该复选框。

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

    接受或编辑计算机的防火墙中未包含的默认内部端口 8081。请确保此端口可用并且不能从外部访问。
  1. 配置外部 PostgreSQL 数据库:
    通过选中使用外部 PostgreSQL 数据库复选框，可以选择将 Digital Lab 连接到现有外部 PostgreSQL 数据库。此选项使您的组织可以管理和利用现有数据库资源。在使用外部数据库安装 Digital Lab 之前，请确保已按照使用外部数据库中所述的步骤进行操作。

    选择此选项时，下一页按钮将打开外部 PostgreSQL 数据库配置屏幕。确保数据库计算机可访问，并为连接提供以下参数:
    数据库配置详细信息
    外部数据库服务器

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

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

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

    模式 

    可以使用方案名，如“ public ”。可以使用指定数据库中已存在的名称。如果程序不存在，则作为 Digital Lab 服务器安装的一部分创建，只要用户有足够的许可。

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

    用户凭据PostgreSQL 数据库用户名和密码。
  2. 选择将上载到 Digital Lab 的应用程序保存到的文件夹。从 Digital Lab (UFT Mobile) 版本 3.2 开始，应用程序不再存储在数据库中，而是保存到文件系统中。

    运行此安装的用户和本地系统帐户都需要文件夹的读写权限。使用共享文件夹时，Digital Lab 计算机上的本地系统帐户必须具有该文件夹的读写权限。不在域中的计算机具有单独的用户管理。每台计算机都跟踪自己的用户帐户。若要使用另一台计算机上的文件夹，请确保两台计算机上都定义了具有相同名称和密码的 Windows 帐户。安装后，修改 Digital Lab 服务器以在此 Windows 帐户下运行。有关详细信息，请参阅作为另一个用户运行服务。
  3. 共享空间配置 (可选):
    如果需要，请启用共享空间 (多方租用) 功能。
    重要信息: 此功能需要企业版或旗舰版许可。不支持禁用共享空间，需要全新安装。有关详细信息，请参阅共享空间。
  4. 指定以下身份证明:
    凭据详细信息
    Digital Lab 默认管理员

    安装将创建默认管理员用户 admin@default.com，用于访问 Digital Lab 控制台。指定此用户的密码。

    Postgres 用户 - 仅限嵌入式数据库

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

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

    按照屏幕上显示的密码规则进行操作 - 至少包含六个字符 (小写和大写)、至少一个数字，并且只能包含字母或数字 (空格或“@”符号除外) 。

  5. 安装完成后，向导将显示一条消息，指出服务器已成功安装，并提供以下选项:
    • 按下一页时，会自动开始服务。
    • 允许收集数据以改进产品。可以在管理设置中修改此选项的选择。

  6. 服务启动后，Digital Lab 控制台将在默认浏览器窗口中打开。日志中提供的凭据。按照屏幕上的说明连接设备并开始工作。

    安装将在桌面上创建一个指向服务器安装文件夹的新快捷方式 Digital Lab 服务器。

  7. 安装 Digital Lab 后，强烈建议您将以下应用程序文件存储文件夹和外部数据库 (如果相关) 的内容合并在一起，以确保文件和数据的安全:

    • 访问监视

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

    • 常规备份

    • 加密

    • 存储消耗监视

    我们还建议您:

    • 更改运行 Digital Lab 服务的帐户，而不是默认的 LocalService 帐户。确保此帐户对 Digital Lab 安装文件夹具有完全访问权限。有关详细信息，请参阅 Windows 文档。
    • 在 Digital Lab 安装和临时文件夹中合并文件系统监视。
    • 备份 encrypted.properties 文件。该文件位于<Digital Lab 服务器安装路径 > server >conf.

后退到顶部

升级

Digital Lab 可以从版本 3.2 或更高版本升级安装。

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

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

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

升级 Digital Lab:

  1. 获取安装 zip 文件。使用提取工具将存档文件 install-server-windows-x64- x.xx-x.zip 的内容提取到计算机中。
  2. 运行安装文件。开始安装时，向导会检测到您正在执行升级，并警告您丢失现有应用程序。它还提示您输入数据库密码。升级时，所有现有的应用程序仍与其相应的工作区关联。有关详细信息，请参阅实验室和工作区管理。
  3. 指示是否要在升级期间执行数据库的自动备份，以便安装可以在失败时执行回滚。此步骤可能会延长升级的持续时间。
  4. 在下一个屏幕中，指明是否要在安装后自动运行应用程序代码注入程序升级程序。应用程序在升级 Digital Lab 服务器后异步升级，从而减少服务器停机时间。个用户能够访问升级后的服务器，并在升级应用程序时继续使用 Digital Lab。

    如果选择不运行自动升级程序，可以稍后手动运行升级程序。有关详细信息，请参阅升级注入代码的应用程序。
  5. 您还可以选择删除应用程序的旧上载。如果选择是，则指定要保留的上载的数量 (默认: 30)。选择删除旧上载并指定要保留的上载的数量时，这些设置将复制到管理 > 设置中的常规部分。有关详细信息，请参阅管理设置中的文件存储设置。
  6. 选择一个文件夹，将上载到 Digital Lab 的应用程序保存到该文件夹中。运行此安装的用户和本地系统帐户都需要文件夹的读写权限。
  7. 如果文件存储和 Digital Lab 服务器计算机不在同一域中，但属于同一 Windows 工作组，则在两台计算机上都需要相同的 Windows 管理员用户名和密码。安装后，以 Windows 管理员用户身份运行 Digital Lab 服务器。有关详细信息，请参阅作为另一个用户运行服务。
  8. 如果选择升级应用程序，则下一屏幕提示您选择要升级的应用程序的操作系统。
  9. 查看安装设置摘要，然后单击下一页继续安装。

  10. 要完成服务器升级，请单击下一页。升级服务器后，应用程序继续升级。安装完成且服务器启动后，可以在 Digital Lab 控制台的应用程序菜单中检查应用程序的升级状态。

  11. 安装完成后，向导将显示一条消息，指出服务器已成功安装，并提供以下选项:

    • 按完成时自动启动服务。
    • 允许收集数据以改进产品。可以在管理设置中修改此选项的选择。

  12. 单击完成。

  13. 升级 Digital Lab 服务器后，强烈建议您对应用程序文件存储文件夹和外部数据库 (如果相关) 进行以下合并，以确保文件和数据的安全:

    • 访问监视

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

    • 常规备份

    • 加密

    • 存储消耗监视

    我们还建议您:

    • 更改运行 Digital Lab 服务的帐户，而不是默认的 LocalService 帐户。确保此帐户对 Digital Lab 安装文件夹具有完全访问权限。详细信息，请参阅在 Microsoft Windows 文档中设置如何启动服务。
    • 在 Digital Lab 安装和临时文件夹中合并文件系统监视。
    • 后退启动位于 Digital Lab 服务器安装文件夹中的 encrypted.properties 文件。

后退到顶部

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

从 Windows 开始菜单，导航到 Digital Lab 服务器并选择所需操作。还可以搜索所需的命令: “启动 Digital Lab 服务器服务”、“停止 Digital Lab 服务器服务”或“重新启动 Digital Lab 服务器服务”。

作为另一个用户运行服务

对于某些集成，可能需要以其他用户身份运行 Digital Lab 服务。您可以通过服务管理器执行此操作。

  1. 单击 Win + R 以打开运行对话框，并输入 services.msc
  2. 找到 Digital Lab 服务器和 Digital Lab 图元服务。
  3. 右键单击 Digital Lab 服务器服务，然后选择属性。

  4. 在日志开启选项卡中，选择此帐户，输入凭据，然后单击应用。

    Changing the user credentials in the Log On tab.

  5. 对Digital Lab NIgnx 服务重复上述步骤。

后退到顶部

升级的最佳实践

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

准备升级

在开始升级过程之前:

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

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

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

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

执行升级

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

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

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

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

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

升级检查表

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

物品详细信息
登录日志作为管理员用户添加到 Digital Lab。
用户检查是否已将所有用户迁移到管理 Administration menu > 用户中的 Digital Lab。
设置检查是否已从生产环境迁移所有管理设置。
应用程序如果选择在升级过程中升级应用程序，请确保所有应用程序在应用程序屏幕中可见。
连接器验证所有连接器在设备 > 连接器页中是否可见。请注意，您无法与这些连接器通信，因为它们被配置为与生产机器一起使用，而不是与测试机器一起使用。
设备确保看到生产环境的所有设备。如果您使用的是 iOS 设备，请重新签署代理，否则设备将显示为断开连接。

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

后退到顶部

修补程序安装

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

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

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

  • 所有连接器

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

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

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

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

后退到顶部

故障排除

有关 Windows 服务器故障解决的信息，请参阅 Windows 服务器。

后退到顶部

另请参阅: