3.3 Installing GroupWise Mobility Service

Before you run the Mobility Service Installation program, ensure that you have done the following:

The following sections step you through the process of installing the Mobility Service and configuring a Mobility system.

3.3.1 Obtaining the GroupWise Mobility Service 18 ISO

To download the GroupWise Mobility Service installation package:

  1. GroupWise Mobility Service software is available through the Micro Focus Customer Care Center.

  2. Download the GroupWise Mobility Service ISO to a convenient temporary directory on the Mobility server.

  3. Continue with Running the Mobility Service Installation Program.

3.3.2 Running the Mobility Service Installation Program

Mobility is supported on SLES 15 SP2, which uses an ISO based install.

If you encounter any problems during the installation, check the Mobility Service Installation program log file for information about the problem:


For additional assistance, see Section A.0, GroupWise Mobility Service Installation Troubleshooting.

  1. Before running the installation program, make sure your SLES 15 SP2 server meets all the of GroupWise Mobility Service System Requirements.

  2. Browse to the location where the Mobility Service ISO is located in a terminal and mount the ISO by running the following command:

    mount groupwise-mobility-service-18.4.x-x86_64-build_number.iso /mnt
  3. Browse to /mnt in the terminal and run the following command to run the install:


    The Mobility Service Installation program creates the following directories and files:

    /usr/sbin/gms (symbolic link)
  4. Once the files have installed, use the GroupWise Mobility Service Installation Worksheet to configure GroupWise Mobility Service.

3.3.3 Checking the Status of the Mobility Service

The Mobility Service Installation program starts the Mobility Service for you. If the installation proceeded normally, all components of the Mobility Service should be running.

  1. In a terminal window on the Mobility server, become root by entering su - and the root password.

  2. Use the following command to check the status of the Mobility Service:

    gms status
  3. Use the following commands to manually start and stop the Mobility Service:

    gms start
    gms restart
    gms stop

3.3.4 Using the Mobility Admin Console

The Mobility Service Installation program starts the GroupWise Sync Agent and the Device Sync Agent for you. Use the Mobility Admin console to check sync agent status.

  1. In your web browser, access the Mobility Admin console at the following URL:


    Replace mobility_server_address with the IP address or DNS hostname of the server where the Mobility Service is installed.

  2. Log in as the Mobility administrator.

    The sync agents should display a status of Running.

  3. (Conditional) If you encounter problems starting the sync agents, see the following troubleshooting resources:

  4. Skip to Adding Users to Your Initial Mobility System.

3.3.5 Uninstalling the Mobility Service

IMPORTANT:When you uninstall the Mobility Service software, certificate files are also deleted. If you have obtained commercially signed certificates for use in your Mobility system, back them up before you uninstall the Mobility Service software.

  1. In a terminal window on the Mobility server, become root by entering su - and the root password.

  2. Change to the following directory:

  3. Run the Mobility Uninstallation script:


    The Uninstallation script stops the Mobility Service, the sync agents, and the PostgreSQL database server. It also uninstalls all Mobility Service RPMs, drops the Mobility Service PostgreSQL database, and deletes the following directories and files from the Mobility server:

    /usr/sbin/gms (symbolic link)