Install the connector on a Mac machine

The Device Connector is a standalone component for connecting devices to Mobile Center. The connector is automatically installed on the Mobile Center 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 Mobile Center server. In this way, devices connected to distributed Mac machines become part of the Mobile Center 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 Mobile Center 3.2 can be installed as an upgrade to a Mobile Center 3.0 Connector.

  1. You will need the IP address or FQDN (Fully Qualified Domain Name) of Mobile Center server machine.
  2. You need to have network connectivity to the Mobile Center 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 token for the device from your admin. You will be prompted for the token 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 Mobile Center 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:

    Select Download Connector from the Help menu in the upper right corner of the Mobile Center console. Download the appropriate Mac connector from Mobile Center on ADM Marketplace.

  3. Obtain an access token for the connector:

    • For admins, in the Mobile Center Lab management console, click in the Connectors page of the DEVICE LAB tab. In the Generate New Token box, provide a name and description, and click GENERATE.
    • For a non-admin user, request one from your admin. Select Contact Your Admin from the Help menu (upper right).

Install the connector with Terminal

To install the connector:

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

  3. Obtain an access tokenfor 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 Mobile Center, enter the access token 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.

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 Mobile Center:

  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 Mobile Center, 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/mc/scripts and run:

  • To start the connector: sudo launchctl load /Library/LaunchDaemons/mobilecenter.plist
  • To stop the connector: sudo /Users/<user name used when installing the connector>/mc_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 Mobile Center server or a Mobile Center 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 MC_Update in the machine's Applications > Mobile Center Connector folder.

To reconfigure from a terminal:

  1. Change directory to the installation folder. cd /opt/mc/installation/
  2. Run the upgrade script:
    ./MC_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 MC_Uninstall in the machine's Applications > Mobile Center Connector folder.

To uninstall from a terminal window:

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

See also: