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.
For information on the recommended system 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.
- 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
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
- 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:
- 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:
- Log in as root or admin user.
- 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.
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 firstname.lastname@example.org 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.
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 (HP4M-Agent.ipa, and HPMC-AgentLauncher.ipa WebDriverAgentRunner-Runner.ipa and WebDriverAgentRunner-Runner_xcode9.ipa) using the MC Enabler tool.
- 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
- Copy the re-signed apps over to the Agent folder on the Mac connector machine.
- Run the following commands in the Agent folder:
If the Mac connector is running, restart it.
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*
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 the StormRunner Functional mobile 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: