UFT Mobile Architecture

UFT Mobile is a standalone server that provides mobile device access to different test applications. UFT Mobile supports a distributed architecture where different test clients can all interact with the same UFT Mobile server instance.

UFT Mobile environment

The individual components of UFT Mobile and the relationship between them are represented in the following diagram:

The UFT Mobile environment consists of the following components:

Component Function
UFT Mobile Server

This is a single web server that:

  • Mediates between the testing-tool client calls to mobile devices, and provides a user interface within the testing tool for recording and running tests on real mobile devices.
  • Accepts apps for testing, and manages app versions.
  • Includes a PostgreSQL database storing reusable data, such as Metadata of uploaded apps and connectors, certificates, user information, and so forth.
  • Provides a user interface (Lab Management console) for administrators to:
    • manage users
    • manage apps and view their properties such as OS and version
    • control devices: restart, unlock, or open a device remotely
    • view and manage connectors

    • configure a variety of settings for users such as proxy definitions and packaging services

External PostgreSQL database

You can connect UFT Mobile to an existing external PostgreSQL database. This allows your organization to manage and utilize existing DB resources.

You specify this option during installation. For details, see UFT Mobile - Windows Installation (on-premises) or UFT Mobile- Linux Installation (on-premises).


The connector is a lightweight piece of software for connecting devices to UFT Mobile, which can be installed together with the server (embedded connector), or as a standalone component. You can install the connector on multiple machines in distributed locations, or on your testing-tool machine. For more details, see Install the connector on a Windows machine, Install the connector on a Linux machine, or Install the connector on a Mac Machine.

The connector manages the physical USB connection to the device, and the logical state machine on top of it. It maps the ports to connect to the device over USB and manages the remote screen viewer stream from the device to the tool. It receives lifecycle events from the USB library such as device connected or device disconnected, Agent finished installing, and Agent started. It transfers these events to the UFT Mobile server for adding the device to the pool. The connector is also responsible for installing and uninstalling apps on the device.

Test devices accessed via connectors

These are the devices (smartphones/tablets) on which the tests are run. The following applications are copied to the test devices:

  • The UFTM Agent, which manages commands to the AUT, to the OS (control outside a specific app), and to the remote screen viewer server that supplies the UI and remote control for the testing-tool clients.
  • The AUT – Application under Test.
SV Lab SV (Service Virtualization) Lab is an environment virtualization toolkit for virtualizing real services in areas that would be otherwise difficult to test. The SV Lab is deployed inside UFT Mobile, ready to run Service Virtualization simulations.

NV Test Manager

Network Virtualization is an optional component for testing apps running under different network conditions. Network virtualization emulates real-world conditions by imposing impairments and constraints in your testing environment during the software testing process, thereby improving software testing accuracy.

Back to top

Connector deployment scenarios

The connector is a lightweight piece of software for connecting devices to UFT Mobile. The embedded connector, which you can choose to install on the UFT Mobile server machine as part of the installation process, is automatically configured to work with the local server. However, the connector can also be installed as a standalone component on a different machine, such as that of a developer or testing engineer. Usually, a combination of the following scenarios is used:

Scenario Description Advantages
Central device hub A central lab of devices connected to the connector on the UFT Mobile server machine. Efficiency. Avoids duplication of tasks for setting up and managing devices.
Distributed device hubs Connectors installed on machines in multiple locations (on-site/off-site/globally dispersed).

Scalable. New labs can be added as needed.

Bring your own device Connector installed on a developer's/testing engineer's machine.

Supports hands-on testing of the app on the device.

Back to top

Network connectivity

The following diagram represents a more drilled-down view, with a focus on the physical deployment of a UFT Mobile server. The different protocols and the ports used are also shown.

Client tools and UFT Mobile server connectivity

Common client tools are UFT One, LoadRunner, Sprinter, BPM, UFT Developer, and Appium scripts.

Testing-tool clients connect to the UFT Mobile server for the following:

  • A user interface (UI) for managing devices and uploading apps over HTTP/HTTPS.
  • API (JSON commands) for tests and management, sent over WebSocket (WS).
  • The remote screen viewer client.

UFT Mobile server and connector connectivity

The connector establishes a WebSocket (WS) connection with the UFT Mobile server, allowing two-way asynchronous communication from the connector to the server, and vice avers, on the same socket. API calls and files are passed over WS.

Testing tool, connector, and device connectivity

The connector maps a port forward to the mobile device for communication of API traffic using mobile libraries (Android Debug Bridge (ADB), Mobile Device Library). It also opens a Windows Sockets connection to the Agent. The connector maps a port forward for the remote screen viewer. The connector exposes the remote screen viewer directly to the tool for minimum latency when operating the device remotely. The UFT Mobile Agent on the device listens on a Windows Sockets port.

Back to top

High availability

The diagram below displays a UFT Mobile active-passive high availability environment:

Note that both servers should always be up and running. One of the servers marks itself as active, and the other as passive. The load balance redirects all requests to the active server. When the active server fails, the passive server becomes active, and the load balancer starts redirecting all requests to it. Make sure to monitor and restart the failed server, so that it becomes passive.

Back to top

Hosted devices

The diagram below displays a deployment with hosted devices.

Back to top

Interface with Amazon Device Farm

UFT Mobile allows you to work with the cloud-based Amazon Device Farm, to run tests on a large variety of devices.

In the following diagram, you can see a how the UFT Mobile connector interfaces with the AWS Device Farm.

For details on how to set up UFT Mobile for this integration, see AWS Device Farm integration.

Back to top