Mobile Center - Windows Installation

This section describes how to install the server on a Windows machine. For specific information about installing the server on a Linux machine, see Mobile Center - Linux Installation.

Before you start

Before installing Mobile Center, make sure that:

  • Your server machine meets the system requirements.
  • You have administrator privileges.
  • The host name of the server machine must be accessible. Check this by running the following from a Windows command line:
    ping -n 1 "hostname"
  • You have installed the USB drivers for your Android devices, or iTunes for iOS devices.

Note that a server installation on a USB stick or flash drive is not supported.

Install Mobile Center on a Windows machine

Follow these steps to install Mobile Center as a full installation where no previous version is installed:

  1. Make sure that a connector is not installed on your machine. If it is, you need to remove it before installing the Windows server. For details, see Troubleshooting the Windows server installation.
  2. Use an extraction tool to extract the contents of the installation archive file install-server-windows-x64-2.xx-x.zip to your computer.
  3. Log in to your machine as administrator.
  4. Locate the extracted .exe file. Make sure it is on a local drive and not a network shared drive.
  5. Click on the setup file and choose Run as administrator from the right-click menu. The installation wizard opens to the Introduction page. Read the contents and click Next.
  6. Fill in the information in each of the Installation wizard screens following these guidelines:

    • In the Server & Database Configuration screen:
      • Use the automatically detected values or modify them as needed. When using the Fully Qualified Domain Name (FQDN), the FQDN must begin with a character from the English alphabet. FQDNs beginning with numbers are not supported.
      • Follow the password rules displayed on the screen—at least six characters, both lower and upper case, at least one digit, and only letters or numbers except for a space or the "@" symbol.
      • Deselect the SSL only check box to work with a non-secure HTTP connection (non SSL). The default is a secure SSL connection using port 8443.

        Note:  

        • The SSL setting affects all connectors and testing tools that integrate with the server. When configuring the Mobile Center settings in connectors and tools, make sure that your selection matches that of the server.
        • When you specify SSL only, the setup installs a self-signed SSL certificate. To use a CA certificate, import it manually after the installation. For details, see Using SSL certificates issued by a Certification Authority (CA).
      • Accept or edit the default internal port, 8081, that will not be included in the machine's firewall. Make sure that this port is available and that it is not externally accessible.
      • For the PostgreSQL database: When the PostgreSQL server is first installed, a superuser account postgres is automatically created. The superuser is needed to create the Mobile Center database schema, and to add a user for administering the database. The superuser can override all access restrictions within the database, so it is best to carry out most operations using a non-superuser role.

        The installation creates an additional user for administering the database. This user is not a superuser and only has permissions to perform operations on the Mobile Center database. The default name is MCadmin; do not use postgres as a user name.

      • Use external PostgreSQL database: You can choose to connect Mobile Center to an existing external PostgreSQL database. This feature lets your organization manage and utilize existing database resources. Note that Mobile Center 2.80 supports PostgreSQL version 9.60.

        When you select this option, the Next button opens the External PostgreSQL Database Configuration screen, where you enter the connection parameters. When you move to the next screen, the installation checks your connection information and prompts you to create a password.

Completing the Installation

When the installation is complete, the wizard displays a message that the server was successfully installed, and provides options to:

  • start the service automatically when you press Next.
  • allow data collection for the improvement of the product. You can modify your selection for this option in the Administration Settings . To view the privacy policy, see the Privacy Statement.

After the service has started, the Mobile Center console opens in the default browser window. Log in with the credentials you provided earlier. Follow the instructions on the screen to connect devices and begin working.

The installation creates a new shortcut on the desktop, Mobile Center Server, to the server's installation folder.

Caution: To insure integrity and confidentiality of the information stored with Mobile Center, we strongly recommend that you:

  • Change the account running the Mobile Center service, instead of the default LocalService account. Make sure that this account has full access to the Mobile Center installation folder. For details, see the Windows documentation.
  • Incorporate filesystem monitoring on the Mobile Center installation and temporary folders.

Back to top

Upgrade the server

Mobile Center 2.80 can be installed as an upgrade to Mobile Center 2.70. If you are using an earlier version of Mobile Center, first upgrade to version 2.70.

To ensure a smooth upgrade, see Best practices for upgrades.

Packaged apps: 
To run the app packager upgrader on iOS apps, you must have already set up your Mac machine as described in set up automatic app packaging and signing services .

If your apps were packaged manually from the command line and then uploaded to Mobile Center, the upgrader will not be able to upgrade the apps. You will need to repackage your apps using the latest version of the MC Enabler (iOS) or the Android Enabler, before uploading them to Mobile Center.

To upgrade from Mobile Center:

  1. Perform the steps described above to obtain and extract the setup file.
  2. Run the setup file. When you begin the installation, the wizard detects that you are performing an upgrade and warns you about losing existing apps. It also prompts you for the database password. When you upgrade from 2.70, all existing apps remain associated with their corresponding workspaces.
  3. In the Packaging upgrade configuration screen, indicate whether you want to automatically run the app packager upgrader at the end of the setup. If you choose not to, you can run it manually at the end of the setup. For details, see Upgrade packaged apps with the app upgrader.
  4. If you choose to upgrade the apps, the next screen prompts you to specify the credentials for the Mobile Center server, and to select the operating systems of the apps you want to upgrade.
  5. If you are upgrading from 2.70 and you want to use an external postgreSQL database in the 2.80 installation:

    1. Create a backup of the original database in the form of a hp4m.bin file. For details, see Export the original database.
    2. Create the following roles in the external database: mc_sa, mc_security, and MCadmin.
    3. Restore the database on the machine, specifying the external database location. For details, see Prepare your new server.
  6. When the installation is complete, the wizard displays a message that the server was successfully installed, and provides options to:

    • start the service automatically when you press Done.
    • allow data collection for the improvement of the product. You can modify your selection for this option in Administration Settings.
  7. Click Done. The installation program removes the previous version.

Caution: To insure integrity and confidentiality of the information stored with Mobile Center, we strongly recommend that you:

  • Change the account running the Mobile Center service, instead of the default LocalService account. Make sure that this account has full access to the Mobile Center installation folder. For details, see the Windows documentation.
  • Incorporate filesystem monitoring on the Mobile Center installation and temporary folders.

Back to top

Stop, start, or restart the server

From the Windows Start menu, navigate to Mobile Center Server and choose the required action. In icon-based environments such as Windows 8.1, search for the required command: "Start Mobile Center service", "Stop Mobile Center service", or "Restart Mobile Center service".

Back to top

Best practices for upgrades

To ensure a smooth upgrade and prevent the loss of data, we highly recommend first performing an upgrade on a test machine, with the same operating system as your production machine. If the upgrade succeeds on the test machine, you can then proceed to upgrade your production server.

Prepare for the upgrade

Before you start the upgrade process, do the following:

  1. If you are using the iOS packager service, upgrade it to the new version before you run the upgrade process. For details, see set up automatic app packaging and signing services.
  2. Decide if you would like to upgrade your applications during the upgrade process, as you will be prompted during the setup.

    • If you upgrade your apps, take into consideration that it may add more time to the upgrade process.
    • If you do not want to upgrade your apps, to reduce the downtime of Mobile Center for your users, you can update the apps after the upgrade. For details, see Upgrade packaged apps with the app upgrader.
  3. Back up your existing Mobile Center database. For details, see Export the original database.
  4. Prepare a testing machine with the same operating system as your production environment. Other hardware parameters such as CPU and RAM can be different. This machine will serve as a test environment for the upgrade.

Perform the upgrade

To ensure a successful upgrade, we recommend that you perform an upgrade on the test machine that you prepared above. Follow these steps:

  1. Install your current Mobile Center server version on the test machine with the same operating system as your production environment.
  2. Import the original database to the test machine. For details, see Prepare your new server.
  3. Verify that the import was successful by logging into Mobile Center on the testing machine and verifying the apps, devices, settings, and so forth as indicated in the Upgrade checklist below. Note that you will not be able to communicate with those connectors, since they were configured to work with the production machine—not the test machine.

  4. Locate the server installation file for Mobile Center the newer version and extract its contents on the test machine.
  5. Run the setup file on the test machine as described in Upgrade the server. If you encounter any difficulties during the upgrade, contact Support.
  6. Verify that the import was successful by logging into Mobile Center on the test machine and verifying the apps, devices, settings, and so forth as indicated in the Upgrade checklist below.
  7. Optional: Attempt to run a test through one of the integrated testing tools.
  8. If all of the above information is correct on the test machine, proceed to Upgrade the server on your production machine.

Upgrade checklist

After the upgrade process has completed on the test machine, check the following items to ensure that the upgrade succeeded:

  • Login. Log in to Mobile Center as an admin user.
  • Users. Check that all the users were migrated to Mobile Center in the ADMINISTRATION > Users page.
  • Settings. Check that all the Administration Settings were migrated from the production environment.
  • Apps. If you chose to upgrade your applications during the upgrade process, make sure that all of your apps are visible in the APPS screen.
  • Connectors. Verify that all the connectors are visible in the DEVICES > Connectors page. Note that you will not be able to communicate with those connectors, since they were configured to work with the production machine—not the test machine.
  • Devices. Make sure that you see all of the production environment's devices.

If there are any missing items or if you encounter any other issues, contact Support.

Back to top

Troubleshooting the Windows server installation

  • For installation troubleshooting, refer to the installation log files located in the installation/Logs folder under the Mobile Center installation. Even if an installation hangs, you can view the intermediate log, installation/mc_install.log .”
  • If you need to change information about the Mobile Center server, see Reconfigure the Mobile Center server.
  • For troubleshooting tips regarding the connector, see Troubleshoot the Windows connector.
  • To uninstall the product, see Uninstall Mobile Center.
  • Before installing the Windows server, make sure that a Windows connector is not installed on the machine (C:\Program Files\Mobile Center Connector). If there is a connector, use the Uninstall command from the Start menu.

  • If you encounter problems with the setup:

    • Navigate to C:\Program Files and delete the Mobile Center Connector folder (after you have tried to run an uninstall) if it exists.
    • Delete the (hidden) Zero G Registry folder. If it is not visible, in the Windows Explorer, choose Organize > Folder and search options > View tab, and select Show hidden files, folders and drives.
    • If you began the server installation and it failed, delete the Windows server installation folder, C:\Program Files\Mobile Center Server, and restart the setup.
    • If the installation was successful, but you cannot access the Mobile Center server, check that the port is not being blocked by a firewall or your antivirus program.
    • Refer to the installation log file in the installation > Logs folder, and look for error messages.

Back to top

See also: