Install the connector on a Mac machine
The Device Connector is a standalone component for connecting devices to Mobile Center.
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
Before you start
The standalone connector for Mobile Center 3.2 can be installed as an upgrade to a Mobile Center 3.0 Connector.
- You will need the IP address or FQDN (Fully Qualified Domain Name) of Mobile Center server machine.
- You need to have network connectivity to the Mobile Center server when installing and starting the
Tip: Ping the server to check the connection.
- Check that your devices are supported
- 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
- The following are prerequisites for installing the connector: OpenSSL-1.1.0h or LibreSSL-2.2.7.
- Set up your Mac machine to detect the devices you want to connect to Mobile Center by performing the following steps:iOS devices
- Check that you have an updated version of iTunes on your Mac.
- If you haven't already done so, follow the steps for setting up iOS devices.
- 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 http://developer.android.com/tools/extras/oem-usb.html 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.
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.
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.
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:
- Log in as root or admin user.
an access tokenfor the connector as described above.
- 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>
- Run the following command to move the CONNECTOR folder from the desktop to the Applications folder:
cp –r desktop/CONNECTOR /Applications
Navigate to the following folder:
./install. The wizard is launched. Press Enter and Y/N when prompted to do so, for example to accept the license agreement.
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.
For details on how to change the configuration after the installation, see Reconfigure the Mac connector.
Note: Accept any popups that Mobile Center is trying to install a new helper tool, by entering your user password.
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:
- 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.
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.
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.
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
To reconfigure from the Mac OS:
Double-click MC_Update in the machine's Applications > Mobile Center Connector folder.
To reconfigure from a terminal:
- Change directory to the installation folder.
- Run the upgrade script:
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:
- Change directory to the installation folder.
- Run the uninstall script: