Share this page

# Install the connector on a Mac machine

The Device Connector is a standalone component for connecting devices to OpenText Functional Testing Lab. You can install the connector as a standalone component on a Mac machine, and configure it to connect to the OpenText Functional Testing Lab server. Devices connected to distributed connector machines become part of the OpenText Functional Testing Lab device lab.

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 your connectors, see View and manage connectors.

In this topic:

## Before you start

The standalone connector can be installed as a full installation, or as an upgrade to an existing installation of the connector.

Before installing or updating the connector, check that your machine complies with the recommended system requirements and that your devices are supported. For details, see Connector requirements in the Support matrix, Connect devices, and Installation and configuration best practices.

Back to top

## Considerations for iOS 17 and later

To connect devices running on iOS 17 and later, internet access is required to fetch a signature key from Apple from time to time. The server machine must have access to the following:

- http://gs.apple.com
  OpenText recommends allowing access to all *.apple domains.

If the server machine accesses the internet via a proxy server, configure the proxy server details in in the Administration settings. For details, see Proxy settings in Administration settings.

If access to the internet is not permitted on the server machine, make sure that the connector can access the Apple servers. If the connector uses a proxy server, configure the following proxy server details in the connector.properties file located in <installation_dir>/connector or server/conf/:

- APPLE_HTTP_PROXY_HOST=<proxy host name>

- APPLE_HTTP_PROXY_PORT=<proxy port number>

- APPLE_HTTP_PROXY_USERNAME= <username for connecting to the proxy server>

- APPLE_HTTP_PROXY_PASSWORD= <password for connecting to the proxy server>

See the Support matrix for supported operating systems and additional considerations that should also be taken into account.

Back to top

## Prerequisites

Before installing the connector, ensure that the following prerequisites are met:

New installation only

1. The server should be accessible to the connector. Go to: http/s://<OpenText Functional Testing Lab server IP address>:<server port> and check that you can access OpenText Functional Testing Lab.
2. Make sure that the time and time zone on the connector machine matches that of the OpenText Functional Testing Lab server.
3. Obtain an access key for the connector from the OpenText Functional Testing Lab server. You are prompted for the key during the connector installation.
   - Admin user: select the Access Keys tab. Click Generate New and provide a name, type (Connector), expiration date, description (optional). Then, click Generate.
   - Non-admin user: request one from your admin. Select Contact Your Admin from the Help menu (upper right).

Back to top

## Set up your Mac machine

1. To use an existing user for the connector installation, the user needs to be in Primary Group 1. To add an existing user to Primary Group 1, run the following command:
   `sudo dscl . -create /Users/<userName> PrimaryGroupID 1`
2. The following are prerequisites for installing the connector: OpenSSL-1.1.0h or LibreSSL-2.2.7.
3. When installing the connector on a Mac machine with an Apple Silicon processor, Apple Rosetta must be installed on the machine. The Mac machine requires access to Apple update services to install this program.

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

- Admin user: Click Download Connector in the CONNECTORS page.
- Non-admin user: Select Download Connector from the Help menu in the upper right corner of the lab console.
  macOS Catalina and later: If the connector is downloaded directly to your Mac from an OpenText official web site, remove the metadata in the downloaded file by running the following command:

Terminal: `xattr -c fileName.zip`

Example: `xattr -c install-connector-macos-x64-X.XX-XXXXX.zip`

5. Extract the files:
   Terminal: `unzip <name of macOS connector installation file>.zip –d <target folder>`
6. Move the connector installation folder to the Applications folder.
   Terminal: `cp –r desktop/<target folder> /Applications`
7. Change folder permissions using Terminal:
   1. Change permissions on the connector installation folder and subfolders:

   sudo chmod -R 777 /Applications/<target folder>

   1. Change permissions on the folder that you are using for temporary files during the installation (Default: tmp):

   `sudo chmod -R 777 /private/tmp`

8. macOS Mojave and later: Verify that the installer has full disk permissions:

   1. Open System Preferences
   2. In Security & Privacy, select the Privacy tab
   3. Select Full Disk Access, then click the lock icon. Use your Touch ID or enter your system administrator credentials and click Unlock.
   4. Click the + button and add the OpenText Functional Testing Lab install app.

Back to top

## Install with the installation wizard

1. In the Applications folder, go to your connector installation folder and locate the install file (.app file).

2. Run the file as root or admin user.

Note: Accept any popups that a new helper tool is trying to be installed, by entering your user password.

3. The Installation wizard opens. Read the contents and click Next.

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

   Authentication
   Enter your credentials. For OpenText Functional Testing Lab, enter the access key provided by your admin. OpenText Core Functional Testing Lab: 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 allows 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 with Terminal

1. Navigate to the following folder:
   `cd /Applications/<Connector installation folder>/install.app/Contents/MacOS`

2. Run `sudo ./install`. Press Enter and Y/N when prompted to do so, for example to accept the license agreement.

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

   Authentication
   Enter your credentials. For OpenText Functional Testing Lab, enter the access key provided by your admin. OpenText Core Functional Testing Lab: 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 allows you to effectively filter devices based on connector names. Enter the Connector's IP address or FQDN, or accept the defaults.

4. For details on how to change the configuration after the installation, see Reconfigure the Mac connector.

Back to top

## Connect devices

1. Codesign the Agent apps and distribute them to the connector machine. For details, see Re-sign the Agent apps. If the Mac connector is running, restart it.
2. Set up your Mac machine to detect the devices you want to connect to OpenText Functional Testing Lab by performing the following steps:

   Device OS | Details
   --- | ---
   iOS | macOS El Capitan (10.11.6) - macOS Mojave (10.14.6): iTunes 12.8 or later is required for syncing to the Mac machine. Check that you have an updated version of iTunes on your Mac. For macOS Catalina (10.15) and later, only Finder is required for syncing. Make sure that your iOS devices are supported. For details, see Support matrix. Follow the steps for Initial device configuration
   Android | Install the USB drivers for your devices. Each device manufacturer has its own USB drivers for Mac. Follow the instructions from the device manufacturer. See the Android Developers documentation for a list of links to Original Equipment Manufacturers (OEM) USB Drivers. If you haven't already done so, follow the steps for the initial configuration of Android devices.

3. Connect your devices to your machine using a USB port.

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

   Tip: Some phones have USB settings 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.

   macOS El Capitan (10.11.6) - macOS Mojave (10.14.6): For a new installation of macOS el Capitan - Mojave, make sure that you open iTunes before plugging in a device.

4. Wait until the Agent is running on the device.

Caution: To ensure integrity and confidentiality of the information stored with OpenText Functional Testing Lab, we strongly recommend that you incorporate file system monitoring on the installation and temporary folders.

1. (Optional) 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. Upgrade your version of iTunes.

2. After connecting the device, perform any additional configurations that may be required for your specific device. For more details, see Known device issues.

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.

If connecting iOS 17 devices, note that the Start option in the Installer UI does not fully start all related processes. To ensure that all processes for supporting iOS 17 devices are started, run the following command to start the service:

Copy code

    sudo /Users/<user name used when installing the connector>/DL_service restart

If you choose not to start the service at the conclusion of the installation, you can stop and start the connector at a later time in Terminal.

To start, restart, or stop the connector:

In Terminal, change directory to /opt/FunctionalTestingLabForMobileAndWeb/scripts and run the following commands. These commands require root access.

Action | Command
--- | ---
Start the connector | `sudo /Users/<user name used when installing the connector>/FTLab_service start`
Restart the connector | `sudo /Users/<user name used when installing the connector>/FTLab_service restart`
Stop the connector | `sudo /Users/<user name used when installing the connector>/FTLab_service stop`

Back to top

## Reconfigure the Mac connector

If you need to modify your connector details, for example to change the server or connector details, you can reconfigure the connector’s settings without having to reinstall it.

To reconfigure the connector:

Double-click Modify Configuration in the machine's Applications >Functional Testing Lab for Mobile and Web Connector folder.

To reconfigure from Terminal:

1. Change directory to the installation folder. `cd /opt/FunctionalTestingLabForMobileAndWeb/installation/`
2. Run the upgrade script:
   `./FTLab_update.command`

Back to top

## Troubleshooting the Mac connector

For tips and guidelines on troubleshooting the Mac connector to work, see Mac connector.

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 using Terminal. The uninstall requires root or admin permissions.

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

To uninstall the connector:

Double-click Uninstall Functional Testing Lab for Mobile and Web in the machine's Applications > Functional Testing Lab for Mobile and Web Connector folder.

To uninstall using Terminal:

1. Change directory to the connector installation folder. `cd /opt/FunctionalTestingLabForMobileAndWeb/installation/`
2. Run the uninstall script:
   `./FTLab_uninstall.command`

Back to top

## Updates

From time to time, updates are released that include enhancements and fixes.

Product | Details
--- | ---
OpenText Functional Testing Lab | To benefit from the latest enhancements and fixes, install the latest patch for your current version. Server patches can be downloaded from Software Licenses and Downloads. The latest patch includes the content of any previous patches. There is no need to install previous patches. Follow the patch installation instructions included in the patch release notes. Important: If you use the remote iOS signing service, this should be upgraded before you upgrade the server. When upgrading the server to the latest patch, the following must also be upgraded: All connectors. OpenText recommends enabling the auto-update setting for connectors. This eliminates the need for manual updates to connectors when you install an update to the server. For details, see General in Administration settings. Manual signing tools (if applicable). iOS Enabler for manual signing of iOS apps. After installing the server patch, the iOS enabler is available in the Agent folder or from the ADM Marketplace. Android Enabler for manual signing of Android apps. After installing the server patch, the updated Android enabler is available in the server folder or from the ADM Marketplace.
OpenText Core SDP | When OpenText deploys an update to the server, connectors must also be upgraded. OpenText recommends enabling the auto-update setting for connectors. For details, see Administration settings. Note: If you use the iOS or Android Enabler for manual signing of apps, these need to be upgraded when the server is updated. You can download the latest available version from the ADM Marketplace.

See also:

- Manage devices
- Install the connector on a Linux machine
- Install the connector on a Windows machine

https://admhelp.microfocus.com/Functional Testing Lab 8942
Tips to improve your search results... OpenText™ Functional Testing Lab for Mobile and Web Help Center OpenText™ Functional Testing Lab Help 25.2 All View Local Help Center View Online Help Center Version: