Install the connector on a Windows machine

The Device Connector is a standalone component for connecting devices to your mobile lab.

For example, the connector can be installed on a testing engineer's PC, and configured to connect to the Mobile Center server machine. In this way, devices connected to distributed connector machines become part of the Mobile Center device pool.

For details on how to see all of your connectors, see View and manage connectors.

Before you start

The standalone connector for Mobile Center can be installed as a full installation, or as an upgrade on top of an existing installation of the connector for Mobile Center as follows

Version 2.70 can be installed as an upgrade to a Mobile Center 2.60 Connector.

  1. You will need the IP address or FQDN (fully qualified domain name) of the Mobile Center server machine. The FQDN must begin with an English alphabetical character. FQDNs beginning with numbers are not supported.
  2. Make sure that a Mobile Center server is not already installed on the machine.
  3. You need to be connected to a Mobile Center server when installing and starting the connector.
  4. Tip: Ping the server to check that it is up.

  5. Check that your devices are supported.
  6. For information on the recommended system requirements, see system requirements.

Back to top

Install the connector

To install the connector:

  1. Download the appropriate connector (32-bit or 64-bit) in one of the following ways:

    • In the Mobile Center Lab management console, click in the Connectors page of the DEVICES tab.
    • Navigate directly to Mobile Center on ADM Marketplace from your browser and select your version of Mobile Center.
  2. Extract the contents of the connector installation file to your computer.

  3. Open the folder that you extracted above, and locate the .exe file. Double-click on the file to open the Installation wizard. Read the contents and click Next.

  4. Fill in the information or answer the questions in each of the Installation wizard pages following these guidelines:

    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, paste your credentials in the Credentials to StormRunner Functional (SRF) field. To obtain cloud credentials, open StormRunner Functional. In the MOBILE LAB > CONNECTORS tab, click . In the Add Device Connector dialog box, click Generate Credentials.

    For details on how to change the configuration after the installation, see Modify a connector.

    If connecting over a proxy, select Enable in the proxy section, and specify the server, port, and credentials if required.
    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 admin@default.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.

    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.
    Indicate whether or not the connector should be private. A private connector only allows the current user and the administrator access to the connector's devices.

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

Prepare devices

Set up your Windows machine to detect the devices you want to connect to Mobile Center by performing the following steps:

Back to top

Connect devices and verify the connection

  1. Connect your devices to your computer via USB cable. Accept all notification, trust, or location pop-ups that may be displayed when you connect a device.

    Windows Phone devices: Before plugging in the device, run the WP-start-hpmc.bat file as an administrator (right-click menu). This script is typically located in the C:\Program Files\Mobile Center Connector\connector folder.
    Wait until the device displays Connected on its screen. Refer to Considerations for Windows Phone devices for additional guidelines.
  2. When the connector is running, the following items are automatically installed on the devices plugged into the connector machine:
    • Remote viewer services
    • The Agent application

      Wait until the Agent is running before interacting with the device. If the Agent crashes, try to unplug the device and then plug it in again. For additional troubleshooting information, see Troubleshoot the Windows connector.

      Tip: If you unplug a device, wait 5 seconds before reconnecting it to allow the system to stabilize.

  1. If the Agent app does not start up after you connect the devices, check if the devices are recognized:

Additional considerations for iOS devices

Back to top

Start, stop, and restart the connector

When the installation is complete, the setup program prompts you to start the connector service.

If you chose not to start the connector service after installing it, you can perform a manual Start, Stop, and Restart from the Services console, or directly from the machine's Start menu:

  • Start > Mobile Center Connector > Start Mobile Center service
  • Start > Mobile Center Connector > Stop Mobile Center service
  • Start > Mobile Center Connector > Restart Mobile Center service

Back to top

Modify a 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, or to change the server or connector port, you can modify them using the Modify configuration tool.

To access the tool, select Start > Mobile Center Connector > Modify configuration. The configuration wizard opens.

When running, the wizard stops the Connector service. The wizard's final page prompts you to start the service again.

When working with servers that use SSL, and you change the server details, you do not need to reinstall the connector. First run the generateSelfSignCertificate script on the server and then run the Modify configuration tool. Testing tool users will also need to reconfigure their SSL access to Mobile Center. For details, see Working with SSL and certificates.

Note: The Modify configuration utility is not supported for connectors using a CA certificate, connecting to a Mobile Center server with SSL. If you want to modify the connection to the server after importing the CA certificate to the connector, you must remove the existing connector and then reinstall it.

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 <path to your Windows connector folder>\conf\connector.properties and uncomment the following line in the file:
ENABLE_LOCALIZATION=true

Back to top

Troubleshoot the Windows connector

This section provides some tips and guidelines for getting your connector to work.

Back to top

Uninstall a connector

You can uninstall the connector via the Start menu or through the standard Windows Programs and Features > Uninstall or change a program interface.

Back to top

See also: