Install the connector on a Mac machine

The Device Connector is a standalone component for connecting devices to UFT Mobile. The connector is automatically installed on the UFT Mobile server machine as part of the installation process. However, you can also install the connector as a standalone component on a Mac machine, and configure it to connect to the UFT Mobile server. In this way, devices connected to distributed Mac machines become part of the UFT Mobile device pool.

This section describes how to install the connector on a Mac machine for testing iOS or Android phones.

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

For information on the recommended system requirements and display settings for the Mac machine, see connector requirements.

Before you start

The standalone connector for UFT Mobile3.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 UFT Mobile server machine.
  2. You need to have network connectivity to the UFT Mobile server when installing and starting the
    Tip: Ping the server to check the connection.
  3. Check that your devices are supported
  4. Obtain an access key for the device from your admin. You will be prompted for the key during the connector installation.

Set up your Mac machine

  1. The following are prerequisites for installing the connector: OpenSSL-1.1.0h or LibreSSL-2.2.7.
  1. Set up your Mac machine to detect the devices you want to connect to UFT Mobile by performing the following steps:

  1. Connect your devices to your machine via a USB port. For a new installation of Mac OS, make sure that you open iTunes before plugging in a device.

    On some devices, when you connect the device via USB, the device issues a security alert. Accept the warning.

    Tip: Some phones have USB settings (Swipe left on the app list, tap Settings, and look for a USB option) that allow the data connection to be enabled separately from the charging connection. If your phone has this option, check the settings to ensure your USB data connection is enabled.

  2. Download the Mac connector in one of the following ways:

    • For admins, Select Download Connector in the CONNECTORS page.
    • 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 .app file.

  4. Double-click on the .app 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:

    Authentication
    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.

Back to top

Install the connector with Terminal

To install the connector:

  1. Log in as root or admin user.
  2. Note: Accept any popups that UFT Mobile is trying to install a new helper tool, by entering your user password.

  3. Obtain an access keyfor the connector as described above.
  4. Copy the connector installation zip file to your desktop and extract the contents to the CONNECTOR folder:
    unzip <name of macOS connector installation file>.zip –d <CONNECTOR>
  5. Run the following command to move the CONNECTOR folder from the desktop to the Applications folder:
    cp –r desktop/CONNECTOR /Applications
  6. Navigate to the following folder:
    cd /Applications/CONNECTOR/install.app/Contents/MacOS

  7. Run ./install. The wizard is launched. Press Enter and Y/N when prompted to do so, for example to accept the license agreement.
  8. Fill in the information or answer the questions in each of the Installation wizard pages following these guidelines:

    Authentication
    Enter your credentials. For UFT Mobile, enter the access key provided by your admin.
    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.
  9. For details on how to change the configuration after the installation, see Reconfigure the Mac connector.

    Back to top

Verify device connection and connect devices

After the installation, if you have Xcode installed, you can check whether the machine recognizes an iOS device using the instruments command:

instruments -s devices

The result of this command should be a list of devices IDs (UDID). If your device is not listed when connected to the USB port, this may mean that:

  • The USB port is not working (hardware problem).
  • You are not using the most up-to-date version of iTunes. You should upgrade your version of iTunes

To connect iOS devices through a Mac connector to UFT Mobile:

  1. Codesign the Agent apps and distribute them to the connector machine. For details, see Re-sign the Agent apps.
  2. If the Mac connector is running, restart it.

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

Start or stop the Mac connector

When you run the installation, by default the Mac connector is installed as a Mac service. You are prompted to start this service at the end of the installation. To stop the service, perform an uninstall.

If you chose not to start the service at the conclusion of the installation, you can stop and start the connector at a later time as follows:

From the Terminal window, change directory to /opt/UFTMobile/scripts and run:

  • To start the connector (method 1) : sudo launchctl load /Library/LaunchDaemons/UFTM.plist
  • To start the connector (method 2) : sudo /Users/<user name used when installing the connector>/UFTM_service start
  • To restart the connector: sudo /Users/<user name used when installing the connector>/UFTM_service restart
  • To stop the connector: sudo /Users/<user name used when installing the connector>/UFTM_service stop

Note: These commands require root access.

Back to top

Reconfigure the Mac connector

If you need to modify your connector details , for example to switch between an on-premises UFT Mobile server or a UFT Mobile hosted device lab, of if you need to change the server or connector details, you can reconfigure the connector’s settings without having to reinstall it.

To reconfigure from the Mac OS:

Double-click UFTM_Update in the machine's Applications > UFT Mobile Connector folder.

To reconfigure from a terminal:

  1. Change directory to the installation folder. cd /opt/UFTMobile/installation/
  2. Run the upgrade script:
    ./UFTM_update.command

Back to top

Uninstall the Mac connector

You can remove the connector for Mac by running the uninstall program on the Mac OS machine, or via terminal. The uninstall requires root or admin permissions.

Note: If you installed the connector via terminal (PuTTY), you can only uninstall it from a terminal.

To uninstall from the Mac OS:

Double-click UFTM_Uninstall in the machine's Applications > UFT Mobile Connector folder.

To uninstall from a terminal window:

  1. Change directory to the installation folder. cd /opt/UFTMobile/installation/
  2. Run the uninstall script:
    ./UFTM_uninstall.command

See also: