Install the connector on a Linux machine
The Device Connector is a standalone component for connecting devices to Mobile Center.
For details on how to see all of your connectors, see View and manage connectors.
Before you start
- You will need the IP address or FQDN of the Mobile Center server machine. Your administrator can help with these details. The FQDN must begin with an English alphabetical character. FQDNs beginning with numbers are not supported.
- You also need to be connected to the Mobile Center server when installing and starting the connector.
- Make sure that a Mobile Center server is not already installed on the machine.
- For information on the recommended system requirements, see system requirements.
Tip: Ping the server to check that it is up.
Install the connector
The standalone connector for Mobile Center 3.0 can be installed as a full installation, or as an upgrade on top of an existing installation of the connector for Mobile Center 2.80. The installer checks what files are already present, and installs or updates the relevant files.
To install the connector:
Download the Linux 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.
- On your Linux machine, log in as root or as a user in the Linux sudoers file.
- Copy the file to your Linux machine and extract the installation files:
unzip <name of Linux connector installation file>.zip –d <Target directory Name>
- Change directory to the CONNECTOR directory in the Target directory:
cd <Target directory name>/CONNECTOR
- Run the connector installer:
./<install_connector-x64 file name>.bin
- Read the License Agreement, and select Y to accept the terms and proceed with the installation. Fill in the information or answer the questions in each of the Installation sections following these guidelines:
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 that you are connecting to was configured to work without SSL, you need to also install the connector with a non-secure connection. For non-SSL, enter n to indicate that the selected port is not an SSL port.
When prompted for a port, note that the default secure port using SSL is 8443. For a non-secure server, the default is port 8080.
Connect to StormRunner Functional (SRF). To access the lab via SRF, paste your credentials when prompted. To obtain cloud credentials, open StormRunner Functional. In MOBILE LAB> CONNECTORS, click . In the Add Device Connector dialog box, click Generate Credentials.
|Enter y to use an existing Linux user, or enter n to use the default new user "mc". Enter the password for this user.|
Mobile lab specifications:
For details on how to change the configuration after the installation, see Change the configuration of the connector.
|If connecting over a proxy, enter y and specify the proxy details. When working in SSL mode, proxy user credentials are not required.|
Enter your Mobile Center user name (email) and password. If Mobile Center has been configured to work with LDAP, you must provide either the email@example.com user or your LDAP user name and password.
Caution: If you are performing an upgrade from a previous version of the connector, do not modify these values.
|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.|
|Specify the connector port or use the default , and the port to be used internally (Default 8081).|
Review the pre-installation summary and press Enter to continue with the installation of the connector.
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.
Connect and verify devices
If you have not already done so, make sure to follow the steps for initial device configuration when connecting Android and iOS devices .
- Connect the device to the connector machine using a USB cable. On some devices, when you connect the device, there may be notification, trust, or location pop-ups. Accept these pop-ups.
- Wait until the Agent is running on the device.
If the Agent does not start up on the device, verify that the devices are recognized:Android devices
Run the following command on the Linux connector machine (If you are a root user, change directory to
All your connected devices should be listed. The status of the device should be "device" and not any other state, for example "unauthorized".
Tip: If you are connecting with a C-Type USB device, such as One Plus, Nexus 5, etc, the idVendor value may not have been recognized.
dmesgto obtain the idVendor value, beginning with 0x. Run
sudoto switch to the mc user provided during installation. Run the
~/add_android_vendor.sh <idVendor>script.iOS devices
- Navigate to:
The result of this command should be a list of devices IDs (UDID). If the command returns an empty result or ERROR message, try the following:
- On the
Mobile Center server orconnector machine, log in as root or as a user on the Linux sudoers list.
- Locate the process ID of “usbmuxd”"
ps aux | grep '[u]sbmuxd'
- Kill the process:
kill –9 <processID>
- Start usbmuxd again:
idevice_id –lagain to see if the device is recognized.
If the devices are connected correctly, try to manually launch the MC Launcher app. If you see an Untrusted App Developer notification:
- Click Trust.
- Disconnect the device.
- Wait 5 seconds and then reconnect the device.
- Navigate to:
Additional considerations for iOS devices
If you have not already done so, enable UI Automation on the device in Settings >Developer> Enable UI Automation. Disconnect the device, wait 5 seconds, and then reconnect it.
Users who install apps signed with an Enterprise certificate (that do not use a Mobile Device Management (MDM) solution) will be prompted to trust the Enterprise developer the first time the app is installed. To trust the profile, go to Settings > General > Device Management, select the Enterprise developer profile, and trust it. These actions can be performed remotely on the device.
All users who install your enterprise-signed app for the first time will also need an internet connection. Once an Enterprise developer profile has been trusted on a device, additional apps with the same profile do not need to be trusted again, provided that the devices on which they are opened are connected to the internet. If the Enterprise developer profile of the application under test is not trusted, the Agent will not be able to open the app and a 1009 Error: "Cannot communicate with AUT " will result.
You can stop and start the connector with the following commands:
- To start the connector:
service mc start
- To stop the connector:
service mc stop
- To restart the connector:
service mc restart
To display system apps (apps that are used to run the device itself) in a supported language other than English, after installing the connector, navigate to
/opt/mc/connector/conf/connector.properties and uncomment the following line in the file:
Uninstall the connector
You can uninstall the connector for Linux as follows:
Log into the Linux connector machine as root user, or as a user in the Linux sudoers file.
- Change directory to the connector installation directory:
cd <path to installation folder>(Default
- Run the uninstall script by entering the following command:
- Press enter to proceed with uninstalling the Mobile Center connector.
Note: If you installed or upgraded the connector using an existing Linux user, you will be asked during the uninstall whether or not to remove this user. If you used the default new user created by Mobile Center during the installation ("mc"), this user will be deleted automatically.
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
On-premises Mobile Center server details:
IP address or FQDN
Secure or non secure connection (SSL)
StormRunner Functional Mobile Lab:
Mobile Center Connector details:
Connector IP address
To change the configuration of the connector:
- On the connector machine, log in as root or as a user in the Linux sudoers file.
- Navigate to your connector installation directory.
- Run the following command:
- When prompted, specify the new details.
- Restart the connector at the end of the process to allow the change to take effect.
- SSL access only: When you modify the connector details following a change to the server details, a new certificate is generated for the connector. Testing tool users will also need to reconfigure their SSL access Mobile Center.