Install the connector on a Linux 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 different Linux machine, and configure it to connect to the Mobile Center server. In this way, devices connected to distributed Linux connector machines become part of the Mobile Center device lab.

For details on how to see all of your connectors, see View and manage connectors (Admin only).

Before you start

  1. 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.
  2. You also need to be connected to the Mobile Center server when installing and starting the connector.
  3. Tip: Ping the server to check that it is up.

  4. Make sure that a Mobile Center server is not already installed on the machine.
  5. Check that your machine complies with the recommended system requirements. For details, see system requirements.
  6. Obtain an access key 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 Key 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).

Download the connector

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

Install the connector

The standalone connector for Mobile Center 3.2 can be installed as a full installation, or as an upgrade on top of an existing installation of the connector for Mobile Center 3.0. The installer checks what files are already present, and installs or updates the relevant files.

  1. On your Linux machine, log in as root or as a user in the Linux sudoers file.
  2. Copy the file to your Linux machine and extract the installation files: 
    unzip <name of Linux connector installation file>.zip –d <Target directory Name>
  3. Change directory to the CONNECTOR directory in the Target directory:
    cd <Target directory name>/CONNECTOR
  4. Run the connector installer:
    ./<install_connector-x64 file name>.bin
  5. 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:
  6. Authentication
    Enter your credentials. For Mobile Center, enter the access key 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 Change the configuration of the connector.

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.

Back to top

Connect and verify devices

  1. If you have not already done so, make sure to follow the steps for initial device configuration when connecting Android and iOS devices .
  2. 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.
  3. Wait until the Agent is running on the device.
  4. If the Agent does not start up on the device, verify that the devices are recognized:

Additional considerations for iOS devices

Back to top

Start and stop the connector

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

Back to top

Enable localization

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:
ENABLE_LOCALIZATION=true

Back to top

Uninstall the connector

You can uninstall the connector for Linux as follows:

  1. Log into the Linux connector machine as root user, or as a user in the Linux sudoers file.

  2. Change directory to the connector installation directory:
    cd <path to installation folder> (Default /opt/mc/)
  3. Run the uninstall script by entering the following command:
    ./MC_uninstall
  4. 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.

Back to top

Change the configuration of the connector

If you need to modify your connector details, for example to switch between an on-premises Mobile Center server or the Mobile Center hosted device lab,, of if you need to change the server or connector details, you can use the Mobile Center update tool. When you run the tool, you can update any of the following :

Mobile Center server details:

  • IP address or FQDN

  • Port

  • Secure or non secure connection (SSL)

  • Proxy information

Mobile Center Connector details:

  • Credentials

  • Connector name

  • Connector IP address

  • Connector port

To change the configuration of the connector:

  1. On the connector machine, log in as root or as a user in the Linux sudoers file.
  2. Navigate to your connector installation directory.
    Default opt/mc/
  3. Run the following command:
    ./MC_update
  4. When prompted, specify the new details.
  5. Restart the connector at the end of the process to allow the change to take effect.
  6. 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.

Back to top

See also: