Riva CRM Integration - Documentation and Knowledge Base

Prepare for an Enterprise GroupWise 2014 Connection

Article ID: 1150
Last updated: 22 Oct, 2015

To prepare for an Enterprise GroupWise 2014 connection

  1. Ensure that the system requirements have been met
  2. Prepare the Windows system hosting the Riva server
  3. Prepare the Riva connection user accounts for e/Directory/GroupWise
  4. Prepare the target user GroupWise mailbox accounts
  5. Configure firewall support

Step 1: Ensure that the System Requirements Have Been Met

Supported GroupWise systems. Riva Enterprise GroupWise connections can be used for the following certified GroupWise systems:

  • Certified GroupWise Systems: GroupWise 2014+

    GroupWise 2014 has removed the dependency on eDirectory, and Riva includes a new connection type for GroupWise 2014+ systems. If the target GroupWise version is 7.03+, 8 or 2012, see Prepare for an Enterprise GroupWise connection.

  • GroupWise Patches: Latest GroupWise 2014 patches.

Step 2: Prepare the Windows System Hosting the Riva Server

Confirm that the following has been completed:

  • Install and test the following client software: Windows GroupWise 2014 client to match the GroupWise 2014 system version. Log in to the GroupWise system as a valid mailbox user.

  • Create a local user account (for example, Riva), and add it to the local Administrators group. Ensure that the account password is set to never change and to not expire. The Riva CRM Agent service will be configured to log on as this user.

Step 3: Prepare the Riva Connection User Accounts for eDirectory/GroupWise

The Riva Enterprise connection for GroupWise 2014 uses the trusted application key name as the user name for the connection. Riva administrators must create a trusted application key generated in GroupWise 2014 to provide approved full access to target user mailboxes.

Step 4: Prepare the Target User GroupWise Mailbox Accounts

Riva requires several key actions to be completed for each target mailbox:

  • First logon to GroupWise - Target users that Riva will sync must log in to their GroupWise mailbox using a GroupWise client at least once. This will ensure that the required folders are created in the target mailbox.

  • Primary SMTP Email Address - Riva relates the GroupWise mailbox to the corresponding CRM user account using the user's email address. Each user's primary SMTP email address value in GroupWise must match the primary email address value for the corresponding CRM user account.

  • Visibility - The target user mailbox must be visible in the GroupWise system address book.

Step 5: Configure Firewall Support

Firewalls must allow:

  • GroupWise connection - Typically TCP port 1677. (Confirm network ports assigned to each post office.)

  • Data Transfer - Enable SOAP via HTTP or HTTPS protocols between the Riva Host system and the GroupWise server(s) configured in the Riva connections to GroupWise. (Refer to the POA settings for SOAP ports.)

Article ID: 1150
Last updated: 22 Oct, 2015
Revision: 4
Views: 6934
Also listed in