Install and Register Launchpads

The Launchpad is Mobile Access Management's software for Mac or Windows computers. This software receives instructions from the Mobile Access Management Server in the cloud. By installing the Mobile Access Management Launchpad software onto your organization’s Windows and Mac computers, you create many Launchpads for simultaneous, distributed device deployments.

Click to enlarge

Launchpad Installer Types

There are two types of Launchpad installers available for MAM:

  • Interactive Launchpad installers - for Mac and Windows.

    • You will need to manually register the Launchpad installed via the interactive installer.

    • Console users, device managers, and Launchpad-only roles only have access to the interactive installers.

    • Automated installation, using a SCCM system to package and distribute the Launchpad software and dependencies, is also supported by the interactive Launchpad installers.

  • Mass deployment installers - for Windows.

    • Use the mass deployment installers to configure multiple Launchpads at once within your organization. See Mass Deployment Installers.

    • When you download the Mass deployment installer, MAM automatically generates a registration token and a command line string that your desktop engineering team will use to automatically install and register the Launchpads to your organization.

    • Console admins can download Mass deployment installer builds and generate registration tokens.

      Tokens are managed in Admin > Launchpads > Launchpad Registration Tokens for Mass Deployment. For more information, see Manage Launchpad Registration Tokens for Mass Deployment.

Interactive Launchpad Installers

There are two tasks involved in using the interactive Launchpad installers:

  • Installing the Interactive Launchpad software

  • Registering the Launchpad

Below are instructions for interactive installation for Mac and Windows.

Installation Requirements

  • Mobile Access Management Launchpad can be installed on any Mac running a supported Mac OS release. For additional information, see the System Requirements.

  • Launchpads require that the local Mac user be a macOS local admin, or the GroundControl Launchpad.app must be installed in a directory the local user has full file permissions over.

Install the Mac Launchpad

  1. Download the interactive Launchpad Mac DMG:

    1. Log into the MAM admin console and navigate to the Launchpads tab, and click Download Launchpad.

      • In the Download Launchpad dialog, select Interactive Launchpad installer and select Mac from the OS list.

      • Click Download to download the interactive installer.

  2. After the installer is downloaded, distribute it to your Mac Launchpad.

  3. Double-click the Mobile Access Management Launchpad disk image to open.

  4. Double-click the GroundControl Launchpad app.

  5. Accept the prompt to open the software.

  6. Accept the prompt to copy the app to your Applications folder.

  7. Eject the disk image.

Installation Requirements

The Mobile Access Management Launchpad can be installed on any computer running a supported Windows operating system. For additional information, see the System Requirements.

Install the Interaction Windows Launchpad

  1. Download the interactive Launchpad Windows EXE:

    1. Log into the MAM admin console and navigate to the Launchpads tab, and click Download Launchpad.

      • In the Download Launchpad dialog, select Interactive Launchpad installer and select Windows from the OS list. Click Download to download the interactive installer.

  1. After the installer is downloaded, distribute it to your Windows Launchpad.

  2. Double-click the Mobile Access Management Launchpad EXE to install.

  3. Choose whether you will install for all users on the machine (recommended) or just for the local user.

  4. For iOS-only MAM environments:

    1. Extract and install MobileDevice components bundled with iTunes using these instructions. This is required on Windows.
      Alternately, install the Apple Devices app for Windows on the Windows Launchpads.

      NOTE:

      Android-only MAM environments do not require MobileDevice components.

Command Line Install

To silently install the Launchpad MSIs from the command line, install with the following switches:

Copy 
GroundControl Launchpad: /i

The Launchpad MSI also allows for parameters to set Launchpad name, host name, and proxy.

GCHOST= MAM Server hostname
GCPROXY= Unauthenticated proxy:port (if missing, no proxy is used)
GCLPNAME= Launchpad name (if missing, the PC name is used)
GCSHAREDDATA=1 Share configuration and cache with all users on this PC

For example:

Copy 
msiexec /i GroundControl.msi GCHOST=company.groundctl.com GCLPNAME="LaunchpadName" GCPROXY="192.168.1.1:8080"

Register the Launchpads

After installation, you must register the Launchpad using a Mobile Access Management user and password. Below are instructions for interactive registration and automated registration.

NOTE:

This method of automated registration does not apply to the Mass deployment installers.

  1. Launch the Mobile Access Management Launchpad app. An unconfigured Launchpad prompts for registration. 

    Click to enlarge

    • The Launchpad Name identifies this Launchpad computer to the Mobile Access Management server. The Mac or Windows computer name is entered by default.

    • The MAM Server.

      The default server MAM hostname "launchpad.groundctl.com" is correct for most organizations.

      If you are using a dedicated cluster, enter the server name of your organization.

    • If your network requires an unauthenticated proxy to access the Mobile Access Management server, add that information here.

  1. Click Next.

  1. Enter your Mobile Access Management email address.

  2. Enter the password for your account and click Start.

  3. The app tests connectivity and connects to the MAM server.

Use a text file to automatically register a Launchpad.

NOTE:

This method of automated registration does not apply to the Mass deployment installers.

First, obtain a Launchpad Registration Token from Imprivata Support. Include the following in your request:

    • The email address of the Mobile Access Management user for "Registered By".

    • An expiration date for your token, for example: 1 day or 30 days; 1 year or 2 years.

You may use the same token to register as many Launchpads as you like.

Once you have obtained the token, create a text file named gc-auto-reg.txt with the following:

server: launchpad.groundctl.com
token: ABCD123456789
launchpad: FN-2187

  • The server and token keys are required.

  • A launchpad key is optional.

    • If included, that value will be used for the Launchpad name. If included, a value must be specified.

    • If omitted, Mobile Access Management uses the Mac or Windows system name for the Launchpad name.

NOTE:

All Launchpads must have unique names.

Install the file gc-auto-reg.txt in the temporary folder of the Mac or Windows system:

  • Mac: /tmp/gc-auto-reg.txt

  • Win: %Temp%\gc-auto-reg.txt

Install this file before the Launchpad software is first run.

When this file is present and valid, the Launchpad app skips the usual interactive registration steps, and automatically registers and start up.

  • If registration is successful, Mobile Access Management deletes the file from the temporary folder because it is no longer needed.

  • If registration fails due to an invalid file or expired token, the Launchpad displays the standard interactive registration screens.

Mass Deployment Installers

  1. Log into the MAM admin console and navigate to the Launchpads tab, and click Download Launchpad.

    1. In the Download Launchpad dialog, select Mass deployment installer.

    2. Select the registration token expiration interval from the list.

    3. Select Windows from the Select OS list and click Download.

      The Mass deployment installer for Windows is downloaded to your local computer. MAM generates a command line string for automatically registering the Launchpad.

    4. Click the copy icon to copy the command line string to your clipboard. Save this information.

      The command line string should appear similar to the examples below:

      Windows:

      Copy 
      msiexec /i "MAMMassInstaller-x64-6.6.0 (12410).msi" GCHOST=groundctl.com GCTOKEN=12345abc-cede-4d9d-90b5-9de0ea78591e

      where:

      GCHOST= Required

      MAM Server hostname.

      For most organizations, this is groundctl.com. If you are using a dedicated cluster, use the correct name for your organization in the GCHOST argument.
      GCPROXY= Optional Unauthenticated proxy:port (if missing, no proxy is used)
      GCLPNAME= Optional Launchpad name (if missing, the PC name is used)

  2. Transfer the Windows installer to your desktop engineering team along with the saved command line strings.