8.2 Setting Up Microsoft Outlook Clients

8.2.1 Supported Microsoft Outlook Clients

GroupWise Mobility supports the following Outlook clients:

  • Microsoft Outlook 2016, 2019, and 2021 for Windows

  • Microsoft Outlook App

8.2.2 Adding a GroupWise Account to the Microsoft Outlook Client

The Outlook client must be configured to access a user’s GroupWise account. The following instructions assume that the Outlook client is already installed on the desired machine.

  1. On the Windows machine, open Control Panel in the Category view and select User Accounts > Mail (Microsoft Outlook).

  2. (Conditional) If a Mail Setup dialog box is displayed, click Show Profiles to display the Mail dialog box.

  3. Click Add to create a new profile.

  4. Specify a name for the profile (for example, Outlook GroupWise Account), and click OK to display the Add Account Setup dialog box.

  5. Select Manual setup or additional server types, and click Next.

  6. Select Exchange ActiveSync, and click Next.

  7. Provide the following information, and click Next.

    Your Name: The GroupWise user’s full name (for example, Sarah McBride).

    E-mail Address: The user’s GroupWise address (for example, smcbride@acme.com).

    Mail Server: The GroupWise Mobility Server name or IP address (for example, gms.acme.com).

    User Name: The GroupWise user name.

    Password: The password associated with the user name.

  8. When the account settings have been verified, click Close to dismiss the verification dialog box.

  9. Click Finish to return to the Mail profiles dialog box.

  10. Select one of the following options, and click OK to save your changes.

    • Prompt for a profile to be used: Select this option if the Outlook client will be used to access multiple email accounts and the user wants to be prompted to select an account when starting the client.

    • Always use this profile: Select this option if the user wants to always open the GroupWise account when starting the client; then, select the Outlook GroupWise account in the list.

  11. Launch the Outlook client.

    The client begins synchronizing data from the GroupWise account.

8.2.3 (Optional) Configuring GroupWise Address Lookup in the Microsoft Outlook Client

There are two ways that you can configure address lookups in Outlook: the GroupWise System Address Book or LDAP.

Using the GroupWise System Address Book

To use the GroupWise System Address Book, complete the instructions in the following sections.

Create an Admin App in GroupWise

To create an admin app for Mobility using the GroupWise Admin service, do the following:

  1. Create the admin app by running the following curl command on your GroupWise primary domain server, replacing the items in the command by referring to the list that follows it.

    curl -k --user gw_sys_admin:admin_password -X POST -H "Content-Type:application/json" --data "{\"name\":\"admin_app\",\"password\":\"admin_app_password\",\"description\":\"app_description\"}" https://GW_domain_ip:9710/gwadmin-service/system/adminapps

    The following items need to be replaced in the curl command:

    • gw_sys_admin: Specify your GroupWise system admin username.

    • admin_password: Specify the password of your GroupWise system admin.

    • admin_app: Specify a name for your admin app.

    • admin_app_password: Specify a password for your admin app.

    • app_description: Specify the purpose of the admin app. In this case it is for GMS.

    • GW_domain_ip: Specify the IP address of your GroupWise primary domain server.

    NOTE:If you are running this command on a Windows server that does not have curl installed, you can download it here.

  2. Continue with the next section.

Create a New Address Book in Outlook

To create a new address book in Outlook:

  1. In Outlook, create a new Address Book using the following information:

    • Select Internet Directory Service (LDAP) for the address book type

    • For the Server Name, specify the DNS name or IP address of your GroupWise server.

    • For Logon Information, the user name is the Admin App name in the following format:


      The password is the password of the Admin App.

    • In More Settings > Search, specify the custom base as o=GroupWise_system_name, replacing GroupWise_system_name with the name of your GroupWise system.

  2. After saving, exit and restart Outlook to make the address book available.

Using LDAP

To configure LDAP:

  1. From the main Microsoft Outlook window, click File > Account Settings.

  2. Click the Address Books tab, and then click New.

  3. Select Internet Directory Service (LDAP), and click Next.

  4. Enter the server name (for example, ldap.myidomain.com).

  5. Enter additional settings as required by your configuration (port, SSL, credentials).

  6. Save the LDAP information.

  7. Exit and restart Outlook.

    The LDAP address book will be available for name search/selection from the Address Book list in Outlook.

8.2.4 (Optional) Configuring GroupWise Free/Busy Search in the Microsoft Outlook Client

Microsoft Outlook has not implemented the ActiveSync 14.x ability to look up contact availability (Free/Busy information).

However, GroupWise provides a Calendar Publishing Host that you can use to make Free/Busy information available in the Outlook client. For information, see Setting Up the GroupWise Calendar Publishing Host in the GroupWise Installation Guide.

To configure the Outlook client to use Free/Busy information made available by the GroupWise Calendar Publishing Host:

  1. From the main Microsoft Outlook window, click File > Options.

  2. In the left panel, click Calendar.

  3. In the Calendar Options section, click the Free/Busy Options button.

  4. Select the Publish at Location box, change the value in the box to 36 months or less, and then uncheck the Publish at Location box.

  5. In the Search Location field, enter the Free/Busy URL for your published Internet Free Busy path, replacing your user name with %NAME% and your domain with %SERVER%. For example:


    You can find your IFB in the GroupWise client, under Tools > Options > Calendar > Busy Search.

  6. Click OK to save the changes.

    When you go to Scheduling in the Outlook client and add a GroupWise user to the Attendees list, the user’s Free/Busy information is displayed.