Chat now with support
Chat with Support

Coexistence Manager for GroupWise 1.7 - User Guide

About the CMG documentation suite Introduction CMG Directory Connector
Directory Connector overview Installation and configuration DC Management Console Connector Creation Wizard Connector Advanced Settings Running and stopping the Directory Connector service
CMG Mail Connector CMG Free/Busy Connector The Log Viewer Appendix A: Known limitations Appendix B: Troubleshooting Appendix C:Configuring CMG logging

Management Console screen:GroupWise F/B Connector | GroupWise Free/Busy

The fields on this screen are necessary to configure CMG’s GroupWise F/B Connector service, for Exchange queries for GroupWise F/B information.

GroupWise Soap Service Host Name: IP address or full DNS hostname for the GroupWise server.

GroupWise Soap Service Port Number: The SOAP port for the GroupWise server. CMG prefills this field with the GroupWise default, 7191, but be sure to change it if your SOAP service is assigned to a different port.

GroupWise Request Retry Delay: Number of seconds to wait between retrying Free/Busy requests to the GroupWise system. This number should be significantly less than the GroupWise Request Timeout value (below).

GroupWise Request Timeout: Number of seconds the GroupWise Free/Busy Connector should run before timing out and returning the results it has obtained up until the timeout. Note that Outlook Free/Busy requests timeout at about 25 seconds so this number should be a few seconds less than that.

GroupWise User Name: User name for the GroupWise SOAP logon process.

GroupWise Trusted Application Name: Name of the trusted application (for example, QuestFreeBusy) by which the GroupWise User Name specified above will access the GroupWise Post Office.

GroupWise Trusted Application Key: An authentication code that permits access to GroupWise data and features by the GroupWise User Name specified above. This Key is associated with a particular Trusted Application Name, specified in the field above. You can create the key with ConsoleOne (in GroupWise 8.01 SP1 or later), or simply run a command from the Windows command prompt:

SMTP Domain Mappings: Used when the domain specified in GroupWise for a GroupWise user's email address is different from the domain specified for the same GroupWise user on an Exchange system. For example, if the user’s email address in GroupWise is JohnSmith@gwsitraka.com, and his email address in Exchange is JohnSmith@exsitraka.com, then an SMTP domain mapping would be created for exsitraka.com=gwsitraka.com. Then when Outlook does a F/B search for JohnSmith@exsitraka.com, the CMG F/B Connector translates it as a request to GroupWise for JohnSmith@gwsitraka.com. SMTP Domain Mappings are used only for Exchange-to-GroupWise F/B queries.

Management Console screen:GroupWise F/B Connector | Quest Web Services

The fields on this screen configure CMG’s Autodiscover web service.

Web Service Prefix: The first element of the Autodiscover Url (below) for CMG's Autodiscover web service. The default value is autodiscover, but you can designate an alternate web service prefix for the GroupWise Free/Busy Connector. This field accommodates F/B coexistence with Exchange 2013 or Office 365 (Wave 14 or 15), where the prefix is configurable.
Web Service Host Name: From the Autodiscover Host A Record, this is the Host Name obtained from your DNS configuration entries in an earlier step of your configuration. This field is prefilled by CMG, assuming the Autodiscover service is installed on the same computer as the CMG GroupWise Free/Busy Connector service, but the value may be edited for a non-standard configuration.
The CMG Autodiscover Url and CMG EWS Url fields are both filled by CMG, derived from the Web Service Prefix and Web Service Host Name values (above), and cannot be changed.
Autodiscover Certificate Wizard: Button to launch the wizard, which automates much of the process of installing the necessary autodiscover certificate for the Free/Busy Connector. For more information about this wizard, see Obtain and install web services certificates in the FBC configuration instructions for your FBC scenario (in the FBC Configuration Guide).
CMG GroupWise Free/Busy Connector Host Name: Prefilled by CMG with localhost—the appropriate value for a typical CMG configuration. In a typical configuration, the CMG EWS subcomponent is installed on the same computer as the CMG GroupWise Free/Busy Connector service, so the generic relative value localhost will suffice in this context. If the CMG EWS is installed on a different computer, then enter the correct Host Name here.
In either case, CMG derives the Endpoint field value from the Host Name value. The Endpoint field value cannot be edited.

Configuring and troubleshooting the F/B Connector with PowerShell

You may use these PowerShell commands (instead of CMG’s Management Console) to configure CMG Free/Busy Connector subcomponents and/or troubleshoot F/B Connector issues.

Commands to configure the F/B Connector

Note that for every set-cmg* command listed here, there is a corresponding get-cmg* command that takes no parameters.

Set‑CmgAutodiscoverConfig

[-QuestEwsUrl] <String>
[-IsRedirectEnabled]

QuestEwsUrl: The URL of the EWS (i.e., Availability) service.
IsRedirectEnabled: $True or $False. Is Autodiscover redirection enabled or not?

Set‑CmgAvailabilityConfig

[[-HostName] <String>]
[[-PortNumber] <Int32>]

HostName: Name of server hosting the GroupWise F/B Connector Service.
PortNumber: Port number the GroupWise F/B Connector Service is located on.

Set‑CmgExchangeFreeBusyConfig

[[-HostName] <String>]
[[-PortNumber] <Int32>]
[-ShowTentativeAsBusy]
[[-ExchangeEwsUrl] <String>]
[[-Credentials] <PSCredential>]
[-ValidateRedirect]
[[-ValidRedirectUrlList] <String[]>]

HostName: Name of the server hosting Exchange F/B Connector Service.
PortNumber: Port number the Exchange F/B Connector Service is located on.
ShowTentativeAsBusy: $True or $False. Show Tentative Busy as Busy?
ExchangeEwsUrl: The URL of the Exchange Web Service.
Credentials: Credentials to access the Exchange Service. Use Get-Credential to get the credentials.
ValidateRedirect: $True or $False. Can Autodiscover redirect to a different domain?
ValidRedirectUrlList: Comma-separated list of valid EWS URLs to which Autodisover can redirect.

Set‑CmgFreeBusyBridgeConfig

[[-ExchangeFreeBusyServiceHostName] <String>]
[[-ExchangeFreeBusyPortNumber] <Int32>]
[[-DaysOfFreeBusy] <UInt32>]

ExchangeFreeBusyServiceHostName: Name of the server hosting the Exchange F/B Connector Svc.
ExchangeFreeBusyPortNumber: Port number of the Exchange F/B Connector Service.
DaysOfFreeBusy: Number of days of F/B to be retrieved from Exchange.

Set‑CmgGroupWiseFreeBusyConfig

[[-QuestFreeBusyServiceHostName] <String>]
[[-QuestFreeBusyServicePortNumber] <Int32>]
[[-GroupWiseSoapServiceHostName] <String>]
[[-GroupWiseSoapServicePortNumber] <Int32>]
[[-SmtpDomainMappings] <String[]>]
[[-SessionLoginName] <String>]
[[-TrustedApplicationKey] <SecureString>]
[[-TrustedApplicationName] <String>]
[[-GroupWiseRetryDelayInSeconds] <Int32>]
[[-GroupWiseTimeoutInSeconds] <Int32>]

QuestFreeBusyServiceHostName: Name of the server where the GroupWise F/B Connector Svc resides.
QuestFreeBusyServicePortNumber: Port for the GroupWise F/B Connector Service.
GroupWiseSoapServiceHostName: Name of the server hosting the GroupWise SOAP service.
GroupWiseSoapServicePortNumber: Port for the GroupWise SOAP service.
SmtpDomainMappings: Comma separated list of SMTP domain mappings.
SessionLoginName: User name for the GroupWise SOAP logon.
TrustedApplicationKey: The key must be entered as a SecureString, so use the following PowerShell command to create the key:
TrustedApplicationName: Name of the Trusted Application.
GroupWiseRetryDelayInSeconds: Number of seconds to wait between retrying F/B requests to GroupWise. This number should be significantly less than the GroupWiseTimeoutInSeconds value.
GroupWiseTimeoutInSeconds: Number of seconds the GroupWise connector service should run before timing out and returning the results it has obtained up until the timeout. Note that Outlook Free/Busy requests timeout at 25 seconds, so this number should be a few seconds less than that.
Related Documents