Install the connector on a Windows machine

The Device Connector is a standalone component for connecting devices to your mobile lab.

For example, the connector can be installed on a testing engineer's PC, and configured to connect to the UFT Mobile server machine. In this way, devices connected to distributed connector machines become part of the UFT Mobile device pool.

For details on how to see all of your connectors, see View and manage connectors (Admin only).

Before you start

The standalone connector for UFT Mobile can be installed as a full installation, or as an upgrade on top of an existing installation of the connector for UFT Mobile as follows

Version 3.4 can be installed as an upgrade to a UFT Mobile 3.0 Connector.

  1. You will need the IP address or FQDN (fully qualified domain name) of the UFT Mobile server machine. The FQDN must begin with an English alphabetical character. FQDNs beginning with numbers are not supported.
  2. Make sure that a UFT Mobile server is not already installed on the machine.
  3. You need to be connected to a UFT Mobile server when installing and starting the connector.
  4. Tip: Ping the server to check that it is up.

  5. Check that your devices are supported.

Back to top

Install the connector

Before installing the connector, make sure your machine meets the connector requirements.

To install the connector:

  1. Obtain an access key for the connector.

    • For admins, in the UFT Mobile Lab management console, click Generate New Key in the Connectors page of the DEVICE LAB tab. Provide a name and description (optional), and click GENERATE.
    • For a non-admin user, request a connector key from your admin. Select Contact Your Admin from the Help menu (upper right).
  2. Download the connector (32-bit or 64-bit) from UFT Mobile on ADM Marketplace.

    • For admins, Select Download Connector in the CONNECTORS page. Download the appropriate connector (32-bit or 64-bit) from UFT Mobile on ADM Marketplace.
    • For a non-admin user, select Download Connector from the Help menu in the upper right corner of the UFT Mobile console.
  3. Extract the contents of the connector installation file to a folder on your computer. Locate the .exe file.

  4. Double-click on the .exe file to open the Installation wizard. Read the contents and click Next.

  5. Fill in the information or answer the questions in each of the Installation wizard pages following these guidelines:


    Enter your credentials. For UFT Mobile, enter the access key provided by your admin.

    UFTM SaaS: The SSL Enabled option should be selected.

    If connecting over a proxy, select Server address in the proxy section, and specify the server, port, and credentials if required.
    Connector configuration
    Provide a meaningful name for the connector, as this will allow you to effectively filter devices based on connector names. Enter the Connector's IP address or FQDN, or accept the defaults.

For details on how to change the configuration after the installation, see Modify a connector.

Caution: To insure integrity and confidentiality of the information stored with UFT Mobile, we strongly recommend that you incorporate filesystem monitoring on the installation and temporary folders.

Back to top

Prepare devices

Set up your Windows machine to detect the devices you want to connect to UFT Mobile by performing the following steps:

Back to top

Connect devices and verify the connection

  1. Connect your devices to your computer via USB cable. Accept all notification, trust, or location pop-ups that may be displayed when you connect a device.
  2. When the connector is running, the following items are automatically installed on the devices plugged into the connector machine:
    • Remote viewer services
    • The Agent application

      Wait until the Agent is running before interacting with the device. If the Agent crashes, try to unplug the device and then plug it in again. For additional troubleshooting information, see Troubleshoot the Windows connector.

      Tip: If you unplug a device, wait 5 seconds before reconnecting it to allow the system to stabilize.

  1. If the Agent app does not start up after you connect the devices, check if the devices are recognized:

Additional considerations for iOS devices

Back to top

Start, stop, and restart the connector

When the installation is complete, the setup program prompts you to start the connector service.

If you chose not to start the connector service after installing it, you can perform a manual Start, Stop, and Restart from the Services console, or directly from the machine's Start menu:

  • Start > UFT Mobile Connector > Start UFT Mobile service
  • Start > UFT Mobile Connector > Stop UFT Mobile service
  • Start > UFT Mobile Connector > Restart UFT Mobile service

Back to top

Modify a connector

If you need to modify your connector details, for example to switch between an on-premises UFT Mobile server or the UFT Mobile hosted device lab, or to change the server or connector port, you can modify them using the Modify configuration tool.

To access the tool, select Start > UFT Mobile Connector > Modify configuration. The configuration wizard opens.

When running, the wizard stops the Connector service. The wizard's final page prompts you to start the service again.

When working with servers that use SSL, and you change the server details, you do not need to reinstall the connector. First run the generateSelfSignCertificate script on the server and then run the Modify configuration tool. Testing tool users will also need to reconfigure their SSL access to UFT Mobile. For details, see Working with SSL and certificates.

Note: The Modify configuration utility is not supported for connectors using a CA certificate, connecting to a UFT Mobile server with SSL. If you want to modify the connection to the server after importing the CA certificate to the connector, you must remove the existing connector and then reinstall it.

Back to top

Enable localization

To display system apps (apps that are used to run the device itself) in a supported language other than English, after installing the connector, navigate to <path to your Windows connector folder>\conf\ and uncomment the following line in the file:

Back to top

Troubleshoot the Windows connector

This section provides some tips and guidelines for getting your connector to work.

Back to top

Uninstall a connector

You can uninstall the connector via the Start menu or through the standard Windows Programs and Features > Uninstall or change a program interface.

If certain applications were open during the uninstall process, some old connector files will remain. This may affect a future installation. It is therefore recommended that you check that all connector files were removed. Otherwise, remove all files and folders manually, located by default at C:\Program Files\UFT Mobile Connector\connector.

Back to top

See also: