View and manage devices

The DEVICE LAB menu provides visibility and control of devices and connectors in the mobile lab.

Note: When preparing a test with a testing tool, select your device through your testing tool interface, such as UFT or TruClient. For details, see UFT Mobile wizard or Record scripts.

Device display

Click DEVICE LAB>DEVICES to display the devices in the Lab.

  • Administrators will see all the devices that have been connected to UFT Mobile. An admin user will also have full control over the devices and the workspaces to which they belong.
  • Users will see all UFT Mobile shared devices (devices in Shared Assets), as well as devices assigned to the workspace in which they are working.

The following details are displayed in the Devices page and device card:

  • License capacity. This the number of devices that can be accessed concurrently. For more, see License installation and management.

  • Device Host. The device host type, for example, for a hosted device or for an Amazon ADF device. For details about hosted devices, see UFT Mobile hosted device lab integration. In the Filter pane, use the Features section to filter by the type of device: Physical, Emulator, Hosted or Amazon.
  • Settings app blocked . If your administrator has not granted permission to non-admin users change the settings on the device, this icon is displayed in the top-right of the device card. If for some reason access to the Settings app could not be restricted for non-admin users, this icon will be displayed. Note that while you can still interact with the Settings app, replay will fail with a 2700 error.
  • Number of devices. The number of devices that match the current filter, out of the total number of connected devices.
  • Operating System and version. A read-only field in the card's top left corner.
  • Device name. Click the name to edit it. The default is the model number of the device.
    Note that if your administrator has not granted you permission to update this field, you will not be able to edit the device name.
  • Manufacturer, model, and ID. A read-only field in the indicating the device information.
  • Workspace name. The workspace to which the device is assigned.
  • Device health. The readiness of the device represented by its conformance with the defined thresholds. This indicator is only displayed if one of the metrics exceeds the defined threshold. Hover over the icon to see details about the exceeded threshold. Admins can configure the thresholds for all device health indicators in the Administration Settings.
  • Reservations. The reservations for the device. For example, Available or Reserved by... Until. Click this section to view and create reservations. A triangular emblem at the bottom right of the device indicates its status:

    Reserved for you
    Reserved and in use by you
    Reserved for someone else
    Reserved and in use by someone else

You can also view the devices in a list. Click the List and Card view buttons in the upper right corner to toggle between the views. To see device details in List view, select a device and click More.

Note:  To use iOS devices with UFT Mobile you must re-sign the Agent apps with a development certificate of an Apple Developer account. For details, see Re-sign the Agent apps. This is not required when using UFT Mobile hosted devices.

Back to top

Finding specific devices

Find a specific device in one of the following ways:

  • Search. In the right pane, click the Search button. In the text box, specify the name, device ID, model, or manufacturer of the device.
  • Filter. Use the left panel filter in the Devices page to limit what items are displayed, to focus on the information that is important to you. Using the filter panel, specify your criteria in the following areas:

    • OS. Operating System: Android or iOS. Use the slider to select an OS version.
    • Features. The type of device: Physical or Emulator, Phone or Tablet, SV Enabled, Hosted, or Amazon Device.
    • Availability:
    • Available Available devices
      Reserved for me Devices reserved for you or that are currently in use by you.
      Reserved for others Devices that have been reserved for someone else or are currently in use by someone else.
      Disconnected Devices that were once connected to UFT Mobile but are no longer connected. Disconnected devices are displayed faded.
    • Connector. The connector whose devices you want to display.
    • Workspace. Display devices assigned to a specific workspace.

    Tip: Use the Clear link in the upper right corner of the filter panel, to remove all your device filters.

    Back to top

Device management

When you hover over a specific device in Card view or select it in List view, the following options are displayed For Amazon Device Farm devices, the following options are not supported: record, Dev Access, and Actions (Restart and Reconnect):

Open device remotely. For Available or Reserved for me devices, access the device remotely. This reserves the device for 30 minutes or uses an existing reservation, allowing you to interact with the device and conduct exploratory testing.

If the device is in the Reserved and In Use By Me state, the interaction with the device in the remote session will be limited and most options in the control panel will not be available. However, this option is useful for when you want to remotely connect to a device while an unattended test (such as an Appium test) is running. If the device is Reserved for or In use by others, or if you do not have the adequate license capacity, this button will be disabled.

When you are finished working with the device, click END SESSION in the top right-hand corner of the remote window to close the session and delete the device reservation.

For information about exploratory testing and interacting with the device, see Device control panel.


  • Parallel remote sessions on the same device are not supported.
  • If you have many tabs (60+) open in your native mobile browser, the remote view may be unresponsive.

Open the device remotely and start to record the session. Open the device remotely and record the steps that you perform to conduct exploratory testing. You can then download a file with the steps. For reservations, this action follows the same behavior as Open device remotely. For details, see Manual testing .

Note that recording steps is not supported on AWS Device Farm devices.

Remove device. Remove a Disconnected device. To remove a device with another status, it must first be disconnected from UFT Mobile.

Unlock device. Release a device that is locked.
For example, if a device was not automatically unlocked when the test finished, or if a specific device is required by another tester for performing some urgent validation of an app on a specific device model, the administrator may need to unlock a device.

Dev Access. Download Dev Access.
Dev Access enables you connect to devices in the UFT Mobile lab, from within your developer IDE. For details, see Dev Access and Dev Access CLI tool. Note that Dev Access is not supported on ADF devices and on emulators.

Device Health. The readiness of the device represented by its conformance with the defined thresholds. Hover over the icon to see details about the exceeded threshold. This indicator is only displayed if one of the metrics exceeds the defined threshold. Admins can configure the thresholds for all device health indicators in the Administration Settings.

More Information: Opens the Device Information window.

The top section contains general information about the device: its ID, name, network connectivity level, workspace, and availability.

The network connectivity level represents the latency between the client and connector to which the device is connected. Hover over the latency icon to view its value, for example, Remote view latency: 18 ms. For optimal remote view performance, select a device with good latency. The latency is considered good if it is less than 100 ms (green), mediocre if it ranges between 100 and 200 ms (yellow), poor if it ranges between 200 and 300 ms (red), and bad if it exceeds 300 ms (gray).

This window has four tabs:

  • Details. The URL of the device in remote view, and other device information such as the Agent version, connector, storage, OS, and so forth.

    Tip: Share a specific device with your testers using the device's URL string. They can access the device directly with the URL string, without having to open the UFT Mobile lab and manually navigate to the device.

  • Metrics. Provides admins and users with additional information to help understand the device health and if it is ready and capable to run tests. Metrics include details such as:
    • latency
    • available disk space
    • WiFi metrics (SSID, signal strength, WiFi state). To view these metrics on Android devices running on version 9 and above, Location services must be enabled in the device settings. For iOS, SSID is supported only for versions 11 and below.
    • screen brightness
    • device temperature ( iOS only)
    • thermal state (iOS only, version 11 or higher). On iOS devices, the thermal states are classified as Nominal, Fair, Serious, and Critical. For more details on the four thermal states, see the Apple Developer documentation.
    • battery health and temperature (Android only).

    You can also get an alert when a device metric such as WiFi connectivity or temperature deviates from a configured threshold value. For details, see Administration Settings.

  • Reservations. A list of current reservations for the device, and an option to create a new reservation.
  • Actions. Interact with the device:

    • Restart device: For an admin user, restarts all devices, including devices that are in use. For non-admin users this action is only enabled for available devices, or devices reserved for or in use by you.
    • Reconnect device: Re-launch the Agent on the device. If this fails, you may need to access the actual device.

Tip: Access the Device Information window by clicking the lower section of a device card (for example, where it says "Available").

Back to top

View and manage connectors (Admin only)

Click DEVICE LAB>CONNECTORS to see a list of all connectors and their properties. The grid displays the connector details such as its name, host, and the number of connected devices. Admin users can view all connectors connected to the UFT Mobile server.

To view the devices associated with a specific connector, click the X Devices link in the row of the desired connector. The Devices view opens with the devices filtered for the selected connector. If you enabled UFT Mobile Hosted Device Lab integration in the Administration Settings, you will also see the hosted device lab connectors. You can also see when the Agent Apps were last distributed to connectors, and by hovering over the icon, the versions of the Agent apps that were last distributed.

Use the action buttons above the grid to:

  • Distribute Agents to selected connectors.
  • Reconnect Devices, a step required after the Agent app distribution status is complete. Select multiple rows to perform this action on several connectors at once.
  • Remove a connector from the list. This can only be done for a disconnected connector. The button only removes the connector from the list of connectors; it does not delete the physical connector installed on a remote machine. When a connector that has been removed is restarted, it will be displayed again in the grid.

Tip: You can select multiple connectors and apply the actions to all the selected connectors.

To add a new connector:

Click Download Connector. Alternatively, expand the Help menu, and select Download Connector. Download the connector for your version.

To allow non-admins to install connectors and connect devices, the administrator needs to provide them with access keys. For details, see Access key management.

For more details on installing connectors, see Install the connector on a Windows machine, Install the connector on a Linux machine or Install the connector on a Mac machine.

To distribute Agents:

  1. Select the required connectors in the grid and click Distribute Agents.
  2. The distribution will begin. Refresh the page to see the distribution status in the Last Distributed column of the grid.
  3. When the distribution status is complete, you need to reconnect the devices. Do one of the following:
    • Select the relevant connectors in the grid and click Reconnect devices.
    • From the Lab console, restart the iOS devices associated with that connector.
    • Physically disconnect and reconnect the devices.
    The new Agent apps will be copied from the connector to the connected devices.

Back to top

View and manage device reservations

Click DEVICE LAB > RESERVATIONS to view and manage reservations for a device. This page also provides details about the current reservations: Running Now, Coming Up (next 24 hours), and Future Reservations. By hovering over a reservation, you can edit or delete it. Admin users can toggle between Mine and All reservations.

You can make a reservation for a specific device, provided that you have access to the workspace. Your administrator can set up workspaces and assign you to one or more of them.

For a new reservation, click to open the Create Reservation window. Once you reserve a device, it will be locked for you at that time.

Here are some guidelines to remember:

  • You can specify a start and end time for your reservation, an open-ended reservation with no end time, or a reservation until the end of the test.
  • By default, reservations are active for 15 minutes and extendable for 5-minute intervals. Your administrator can modify these values or edit specific reservations.
  • After you reserve a device, the Reservations page indicates that you reserved it, and shows the start and end times.

A triangular emblem at the bottom right of the device indicates its status. For details, see Device display - Reservations.

Back to top

Working with Genymotion Cloud emulators

The emulated devices will be indicated by Emulator icons in the top corner of their cards.

To connect a Genymotion Cloud emulator to UFT Mobile:

In card view, move the ON/OFF toggle to ON. Wait for the card to show the Connected status. The emulator is now ready to be used for automated or manual testing.

The clock icon lets you see when the emulator was connected.

To stop using an emulated device, move the ON/OFF toggle on the device to OFF.

To add more emulators, see Genymotion Cloud integration. To remove the emulated devices, disable the integration in the Administration Settings.

Back to top

Working with AWS Device Farm devices

You can use Amazon Device Farm (ADF) devices in all your testing scenarios:

  • To add an ADF device, add it to the UFT Mobile lab, as described in this section.
  • Using your Micro Focus tool, such as UFT One or Sprinter, open the UFT Mobile wizard to open the device selection window.
    Note that with this option, the device is connected at the beginning of a test and disconnected at the end. We do not recommend using this option if you want to use a device for more than one test because you will need to wait for the device to connect for each test.
  • If you are using ADF device pools, when creating a pool, set the filter for Android devices to OS versions higher than version 4.4.4.

  • To use an ADF device in CI (Continuous integration) testing, connect it using REST API calls. For details, see Use ADF devices with CI.

To add an ADF device to the lab:

  1. Set up the AWS Device Farm integration.
  2. In the DEVICE LAB tab, click + Device. If no devices are connected to the lab, Click Connect Device on the initial Devices page.
  3. Choose Select a device from ADF from the dropdown. This option will only be enabled if the AWS Device Farm integration is valid.
  4. In the How To popup, click Connect Device to open the ADF device selection wizard.  
    1. Connect a device to your lab according to the following guidelines:

      You can use capabilities to select a device. Set the desired capabilities and choose an OS, an OS version, manufacturer, model and fleet type: public or private. The list of matching devices, and their availability, are displayed.

      Tip: Populate the desired capabilities fields according to the characteristics of a specific device, by clicking the icon next to the device. To clear the set capabilities, click CLEAR at the top of the capabilities section.

      Select a specific device from the list of matching devices or have UFT Mobile automatically select the device. When using automatic selection, the device with the best availability status will be allocated.
    2. In the APPS tab of the wizard, select the Apps to install on the device, and click CONNECT DEVICE.

      Note: The ADF signing service for iOS devices can only be used while setting up the device. You will not be able to install apps on public iOS devices at a later time.

    The device's card shows an icon indicating that it is an ADF device. A clock icon lets you see when the ADF device was connected.

    When connecting a device from the lab console, the device will remain connected until selecting Remove, or until the ADF project execution timeout is reached. When the ADF device reaches its maximum usage time, its status will indicate that it is disconnected.

    ADF devices will no longer appear in the lab if the:

    • ADF connector is disabled
    • AWS settings become invalid

Back to top

Use ADF devices with CI

To use an ADF device in CI (Continuous integration) testing, connect it using REST API calls. First make sure you have enabled AWS as described in AWS Device Farm integration.

Before running CI tests, you need to get the device ID. Obtain the device ID with one of the following API calls:

  • POST /rest/v2/awsDevice. Check the response for the deviceID value.
  • GET /rest/device/{deviceID}, using a temporary parameter deviceID. Continue to poll the status until the device becomes registered.

After you have the deviceID value, this indicates that the device is connected. Pass the parameter storing the Device ID to your REST calls in your CI job.

  • Make sure the total expected duration of the tests you plan to run on a connected device, does not exceed the ADF timeout.
  • After the tests are complete, remove the ADF device from UFTM using the remove device API.

For details about using the REST API, see REST API reference for UFT Mobile.

Back to top

Download a video recording of the test

After a test run, you can download a video recording of the test from the Video section of the page.

You can also download the connector log for the ADF host. For details, see Troubleshooting

Back to top


Back to top

See also: