UFT Mobile - Windows 安装(本地)

本节介绍如何在 Windows 计算机上安装服务器。此部分仅与 UFT Mobile 的内部部署相关。有关在 Linux 计算机上安装服务器的特定信息，请参见 UFT Mobile- Linux 安装(本地)。

开始之前

安装 UFT Mobile 之前，请确保:

  • 您的服务器计算机满足 支持矩阵 中指定的要求。
  • 您具有管理员权限。
  • 服务器计算机的主机名是可访问的。请通过从 Windows 命令行运行以下命令来进行检查:
    ping -n 1 "hostname"
  • 您已经为 Android 设备安装了 USB 驱动程序，或者为 iOS 设备安装了 iTunes。

”注意：“服务器安装在 USB 棒或闪存驱动器不受支持。

后退到顶部

使用外部数据库

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

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

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


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

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

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. 重新启动 postProgressQL 13 服务。
  4. 重置 postProgressql13 用户密码并重新启动。

后退到顶部

完全安装

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

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

  8. 根据以下准则配置 UFT Mobile 服务器:

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

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

    请考虑以下指导原则:

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

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

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

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

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

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

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

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

    ”模式“ 

    可以使用方案名，如“public”。可以使用指定数据库中已存在的名称。如果架构不存在，则在用户具有足够权限的情况下，它将作为 UFT Mobile 服务器安装的一部分创建。

    ”注意：“如果数据库/架构最初由 UFT Mobile 创建(例如，如果卸载了服务器但没有卸载 PostgreSQL 数据库)，则在进入下一屏幕时，系统将提示您提供加密密钥。如果数据库/架构不是由 UFT Mobile 创建的，则无需提供加密密钥。

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

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

    安装将创建默认共享空间管理员用户 admin @ default.com，用于访问 UFT Mobile实验室管理控制台。指定此用户的密码。

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

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

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

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

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

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

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

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

    • 访问监视

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

    • 常规备份

    • 加密

    • 存储消耗监视

    我们还建议您:

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

后退到顶部

升级

UFT Mobile 可以从版本 3.2 或更高版本升级安装。

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

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

如果已从命令行手动打包个应用程序，然后将其上载到 UFT Mobile，则升级程序将无法升级个应用程序。在将个应用程序上载到 UFT Mobile 之前，需要使用最新版本的打包程序服务(iOS)或 AndroidEnabler 对其进行重新打包。

升级 UFT Mobile :

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

    如果选择不运行自动升级程序，可以稍后手动运行升级程序。有关详细信息，请参阅 升级注入代码的应用程序(内部部署)。
  5. 您还可以选择删除应用程序的旧上载。如果选择”是“，则指定要保留的上载的数量(”默认: 30)“。选择删除旧上载并指定要保留的上载的数量时，这些设置将复制到”管理>设置“中的常规部分。有关详细信息，请参阅 管理设置 中的文件存储设置。
  6. 选择将保存上载到 UFT Mobile 的应用程序的文件夹。运行此安装的用户和本地系统帐户都需要文件夹的读写权限。

    ”注意：“从 UFT Mobile 3.2 版开始，应用程序不再存储在数据库中，而是保存到文件系统中。

    如果文件存储和 UFT Mobile 服务器计算机不在同一域中，但属于同一 Windows 工作组，则在两台计算机上都需要相同的 Windows 管理员用户名和密码。安装后，以 Windows 管理员用户身份运行 UFT Mobile 服务器。有关详细信息，请参阅 运行服务作为不同的用户。

  7. 如果选择升级个应用程序，则下一屏幕提示您选择要升级的个应用程序的操作系统。
  8. 查看安装设置摘要，然后单击下一页继续安装。

  9. 要完成服务器升级，请单击下一页。升级服务器后，应用程序将继续升级。

    安装完成且服务器启动后，您将能够在 UFT Mobile实验室控制台的”应用程序“菜单中检查个应用程序的升级状态。要查看个应用程序的状态，请单击个应用程序卡上的更多信息图标 。下面的示例显示了正在升级的个应用程序。

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

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

  11. 单击”完成“。

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

    • 访问监视

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

    • 常规备份

    • 加密

    • 存储消耗监视

    我们还建议您:

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

后退到顶部

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

起始时间 Windows ”开始“菜单，导航到 ” UFT Mobile服务器“并选择所需操作。还可以搜索所需的命令: "开始UFT Mobile服务器 service"、"停止UFT Mobile服务器 service"或"重新启动UFT Mobile服务器 service"。

运行服务作为不同的用户

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

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

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

  5. 对 ”UFT Mobile NIgnx“ 服务重复上述步骤。

后退到顶部

升级的最佳实践

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

准备升级

在开始升级过程之前:

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

  2. 确定是否要在升级过程中升级应用程序，因为在安装过程中会提示您。

    • 从 UFT Mobile 3.2 开始，个应用程序将异步升级。在升级个应用程序时，用户可以访问并继续使用升级后的服务器。可以在实验室控制台的”应用程序“菜单中检查个应用程序的升级状态。
    • 如果不希望升级个应用程序，可以在升级后更新个应用程序。有关详细信息，请参阅 升级注入代码的应用程序(内部部署)。
  3. 后退 up your existing UFT Mobile database .有关详细信息，请参阅 导出嵌入的数据库。

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

执行升级

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

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

  3. 通过登录到测试计算机上的 UFT Mobile 并验证个应用程序、设备、设置等，验证导入是否成功，如下面的 升级检查表 所示。备注，您将无法与这些连接器通信，因为它们已配置为使用生产计算机，而不是测试计算机。

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

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

升级检查表

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

”登录“日志作为共享空间管理员用户添加到 UFT Mobile。
”用户“检查是否已将所有用户迁移到 UFT Mobile in”管理 > USERS“。
”设置“检查是否已从生产环境迁移所有 管理设置 。
”应用程序“如果选择在升级过程中升级应用程序，请确保所有个应用程序在”应用程序“屏幕中可见。
”连接器“验证所有连接器在”个设备>连接器“页中是否可见。备注，您将无法与这些连接器通信，因为它们已配置为使用生产计算机，而不是测试计算机。
”个设备“确保看到生产环境的所有设备。

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

后退到顶部

故障排除

许多因素都可能导致安装问题。以下信息可以帮助您解决安装问题:

  • 有关安装故障排除的信息，请参阅位于 UFT Mobile 安装下的 ” installation/日志“文件夹中的安装日志文件。即使安装挂起，也可以查看中间日志 ”installation/UFT_Mobile_Server_install.log“。

  • 503 错误-服务器安装后无法启动共享文件夹的应用程序存储。如果文件存储和 UFT Mobile 服务器计算机不在同一域中，但属于同一 Windows 工作组，则在两台计算机上都需要相同的 Windows 管理员用户名和密码。安装后，应使用 Windows admin 用户运行 UFT Mobile 服务器。有关详细信息，请参阅 运行服务作为不同的用户。

  • 如果需要更改有关 UFT Mobile 服务器的信息，请参见 重新配置 UFT Mobile 服务器(内部部署)。
  • 有关连接器的故障排除提示，请参见 Windows 连接器疑难解答。
  • 要卸载产品，请参见 卸载UFT Mobile (内部部署)。

  • 安装 Windows 服务器之前，请确保计算机上未安装 Windows 连接器(” C:\Program Files\UFT Mobile连接器“)。如果存在连接器，则使用”开始“菜单中的”卸载“命令。

  • 如果在安装过程中遇到问题:

    • 导航到”C:\Program Files“，并删除 ” UFT Mobile连接器“文件夹(在尝试运行卸载之后)(如果存在)。
    • 删除 the (hidden)”Zero G Registry“ 文件夹。如果不可见，请在 Windows 资源管理器中选择”组织>文件夹和搜索选项>查看“选项卡，然后选择”显示隐藏的文件、文件夹和驱动器“。
    • 如果开始安装服务器但失败，请删除 Windows 服务器安装文件夹 ” C:\Program Files\UFT Mobile Server“，然后重新启动安装程序。
    • 如果安装成功，但无法访问 UFT Mobile 服务器，请检查防火墙或防病毒程序是否未阻止端口。
    • 请参阅”安装>日志“文件夹中的安装日志文件，并查找错误消息。

后退到顶部

另请参见: