Install and Register Launchpads

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

Launchpad Installer Types

There are two types of Launchpad installers available for MAM:

  Mass deployment installer Interactive installer
Platform

Mac

Windows

Mac

Windows
Single or Multiple Launchpads

Configure multiple Launchpads at once.

See Mass Deployment Installers

 Single Launchpads as part of a test
Registration details

Automatically generates a registration token upon downloading

Registration tokens are managed in Admin > Launchpads > Launchpad Registration Tokens for Mass Deployment. See Manage Launchpad Registration Tokens for Mass Deployment.

 Must be manually registered to your organization
Distribution method(MDM/Command-line)

Mac - automatically generates a registration configuration profile for MDM distribution.

Windows - automatically generates a command line string that your desktop engineering team will use to automatically install and register the Launchpads to your organization.

 Manual distribution
Automatic registration to server/organization

Automatically registers the Launchpad to the correct server and organization using the generated registration tokens.

 Interactive registration
MAM roles Console admins only

Console users, devices managers and Launchpad-only roles

Mass Deployment Installers

  1. Log into the MAM admin console, go 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: 1 month, 6 months, 1 year, 2 years.

      This indicates the date that the registration token will expire.

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

      IMPORTANT:

      The registration configuration profile for macOS mass deployment can only be distributed via MDM to Mac Launchpads.

      1. Click Download to download the Mac registration configuration profile. The MAM_LP_Registration_<token>.mobileconfig profile is downloaded.

        where

        <token> corresponds to the first four digits of its registration token. This makes it easier to identify the correct Mac registration configuration profile and registration token in your environment.

      2. Click Download to download the installer for Mac. The GroundControl Launchpad.dmg file is downloaded.

      3. Extract the GroundControl Launchpad.pkg file from the GroundControl Launchpad.dmg.

      4. Upload the Mac registration configuration profile and the GroundControl Launchpad.pkg file to your MDM and distribute it to your Mac Launchpads.

      5. On launch, the Launchpads are registered.

        NOTE:

        Resetting the Launchpad will automatically relaunch and re-register to the same organization, as long as the auto registration profile remains installed on the Mac.

      For Windows mass deployment installers, MAM generates a command line string for automatically registering the Launchpads.

      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:

      Copy 
      msiexec /i "MAMMassInstaller-x64-7.0.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.

      GCPROXY= Optional Unauthenticated proxy:port (if missing, no proxy is used)
      GCLPNAME= Optional Launchpad name (if missing, the PC name is used)

      Transfer the installer to your Desktop Engineering team, along with the appropriate command line strings (Windows).

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, go 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.

      • The Download Launchpad dialog displays the MAM Server and the MAM Org ID. Click () to copy to clipboard.
        Take note of them for use during interactive registration.

        Org ID is optional. This is only required if the user registering the Launchpad has a role in more than one organization, the server will register the Launchpad to the specific organization.

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

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

  4. Transfer the .app to the /Application directory. Requires macOS Admin.

  5. Double-click the GroundControl Launchpad.app.

  6. Accept the prompt to open the software.

  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 go 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.

      • The Download Launchpad dialog displays the MAM Server and the MAM Org ID. Click () to copy to clipboard.
        Take note of them for use during interactive registration.

        Org ID is optional. This is only required if the user registering the Launchpad has a role in more than one organization, the server will register the Launchpad to the specific organization.

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

  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.

      NOTE:

      Android-only MAM environments do not require Apple MobileDevice components.

Register the Launchpads

After installation, you must register the Launchpad using a MAM user account and password. Depending on your organization's needs, use the instructions for interactive registration or automated registration.

NOTE:

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

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

    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.

      Enter the MAM server name as shown on the installer download dialog. For example: us.groundctl.com, uk.groundctl.com.

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

  1. Click Next.

  2. Enter your Mobile Access Management email address.

  3. Enter the password for your account.

  4. In the Organization ID box, enter the ID for your organization that you saved earlier.

    Click to enlarge

    • The Organization ID is only required when the user registering the Launchpad has a role in more than one organization. The MAM server will register the Launchpad to the organization specified.

    • Launchpads running 7.0 or earlier do not support the input of an Organization ID.

    • If the user registering the Launchpad only has a role in a single organization, the MAM server registers the Launchpad without needing the Organization ID.

    • If the user registering the Launchpad has a role at more than one organization, and omits the Organization ID, the MAM server fails the registration and sends an error message to the Launchpad.

  5. Click Start.

    The app tests connectivity and connects to the MAM server.

DEPRECATED:

This method has been deprecated. Imprivata recommends using the Mass Deployment workflow instead.

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

Use a text file to automatically register a Launchpad.

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.

Allow MAM to Use a Proximity Badge Reader - macOS

Applies to macOS Launchpads only.

When using the MAM Check Out feature and a proximity badge reader, your Mac may display an additional security prompt of ""Applications" would like to receive keystrokes from any application".

To use a proximity badge reader, you must grant permission for Input Monitoring to the Launchpad app.

  1. Choose Apple menu > System Settings, then click Privacy & Security in the sidebar. You may need to scroll down.

  2. Click Input Monitoring.

  3. Locate the GroundControl Launchpad app in the list and turn the ability to monitor your input devices on.

    If the Launchpad app is running, you are prompted to restart the app in order for the changes to take effect.

    Click to enlarge

Downgrade the Launchpad Software

Downgrading Launchpad software requires that you reset the Launchpad before you install the earlier software release.