Install & Register Launchpads

Installation Requirements

• Launchpad can be installed on any Mac running a supported Mac OS release. For additional information, see System Requirements.
• Launchpads requires 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 Interactive Mac Launchpad

Download the interactive Launchpad Mac DMG:

1. Log into the MAM admin console and navigate to the Launchpads tab and click Download Launchpad.
   1. In the Download Launchpad dialog, select Interactive Launchpad installer and select Mac from the OS list.
   2. Click Download to download the interactive installer.
2. After the installer is downloaded, distribute it to your Mac Launchpad.
3. Double-click the GroundControl 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.

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

Install the Interactive Windows Launchpad

Download the interactive Launchpad Windows EXE:

1. Log into the MAM admin console and navigate to the Launchpads tab and click Download Launchpad.
   1. In the Download Launchpad dialog, select Interactive Launchpad installer and select Windows from the OS list.
   2. Click Download to download the interactive installer.
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:

GroundControl Launchpad: /i
The Launchpad MSI also allows for parameters to set Launchpad name, host name, and proxy.

For example:

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

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

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

1. Launch the MAM Launchpad app. An unconfigured Launchpad prompts for registration.
   • The Launchpad Name is used to identify this Launchpad computer to the MAM server. The Mac or PC computer name is entered by default.
   • The default server hostname “launchpad.groundctl.com” is correct for most organizations. If you are using a dedicated cluster, enter the correct name for your organization here.
   • If your network requires an unauthenticated proxy to access the MAM server, add that information here.
2. Click Next.
3. On the next screen, enter your MAM user name and password and click Login.
   The app will test connectivity and connect to the 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.

After 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 will skip the usual interactive registration steps, and automatically register and start up. If registration is successful, Mobile Access Management will delete the file from the temporary folder as it is no longer needed.

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