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.

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.0 can be installed as an upgrade to a Mobile Center 2.80 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

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:

    • In the Mobile Center Lab console, click in DEVICE LAB > CONNECTORS.
    • Navigate directly to Mobile Center on ADM Marketplace from your browser and select your version of Mobile Center

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. 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>
  4. Run the following command to move the CONNECTOR folder from the desktop to the Applications folder:
    cp –r desktop/CONNECTOR /Applications
  5. Navigate to the following folder:
    cd /Aplications/CONNECTOR/

  6. Run ./install. The wizard is launched. Press Enter and Y/N when prompted to do so, for example to accept the license agreement.
  7. Proceed through the wizard following these guidelines:

    User configuration
    Enter y to use an existing user, or enter n to use the default new user "mc". Enter the password for this user.
    Server configuration

    Mobile lab specifications:

    • Connect to Mobile Center. For connecting to the lab via an on-premises Mobile Center server, enter the IP address or the fully qualified domain name (FQDN) of the Mobile Center server machine. If the server was installed using an FQDN, use that same name here.

      If the server was configured to work without SSL, disable the Use SSL option and specify the non-secure port, 8080 by default.

    • Connect to StormRunner Functional (SRF). To access the lab via SRF, upload the credentials file in the Credentials to StormRunner Functional (SRF). field. To obtain cloud credentials, open StormRunner Functional. In the MOBILE LAB tab, click . In the Add Device Connector dialog box, click Generate Credentials.

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

    If connecting over a proxy, select Enable in the proxy section, and specify the server, port, and credentials.
    Certificate configuration

    Enter your Mobile Center user name (email) and password. If Mobile Center has been configured to work with LDAP, you must provide either the user or your LDAP user name and password.

    Caution: If you are performing an upgrade from a previous version of the Mobile Center connector, do not modify these values.

    Connector configuration
    Enter the Connector's IP address or FQDN. The FQDN must begin with an English alphabetical character. FQDNs beginning with numbers are not supported.
    Provide a meaningful name for the connector, as this will allow you to effectively filter devices based on connector names.

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 (HP4M-Agent.ipa, and HPMC-AgentLauncher.ipa WebDriverAgentRunner-Runner.ipa and WebDriverAgentRunner-Runner_xcode9.ipa) using the MC Enabler tool.
  2. Rename the files by removing -Codesigned from the file name. For example, the Agent file should be renamed from HP4M-Agent-Codesigned.ipa to HP4M-Agent.ipa
  3. Copy the re-signed apps over to the Agent folder on the Mac connector machine.
  4. Run the following commands in the Agent folder:
  5. sudo chown mc HP4M-Agent.ipa

    sudo chown mc HPMC-AgentLauncher.ipa

    sudo chown mc WebDriverAgentRunner-Runner.ipa

    sudo chown mc WebDriverAgentRunner-Runner_xcode9.ipa

    sudo chmod 755*

  6. 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 the StormRunner Functional mobile 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:

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:

See also: