Coexistence Manager for GroupWise 1.7 - FBC Configuration Guide

GroupWise F/B Connector | Quest Web Services

| Quest Web Services

This information applies only if you are configuring CMG’s FBC for Outlook 2003 clients, which requires CMG’s Autodiscover and EWS for Exchange queries to GroupWise for F/B information. This information does not apply if you are configuring for Outlook 2007 or later clients, with Microsoft’s (not CMG’s) Autodiscover and EWS.

•

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 the configuration. (See the Configure DNS step of your scenario’s configuration instructions for more information.) 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 Quest Autodiscover Url and Quest 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 the web services certificates step of your scenario’s configuration instructions.)

•

Quest 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.

Appendix: Configuring and troubleshooting the FBC 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

•

Commands to troubleshoot the F/B Connector

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.

Table 3.

Command

Parameter

Set-CmgAutodiscoverConfig

[-CMxEwsUrl] <String>
[-IsRedirectEnabled]

•

CMxEwsUrl: The URL of the EWS (i.e., Availability) service.

•

IsRedirectEnabled: $True or $False. Is Autodiscover redirection enabled or not?

Table 4.

Command

Parameter

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.

Table 5.

Command

Parameter

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.

Table 6.

Command

Parameter

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.

Table 7.

Command

Parameter

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:

$key = Read-Host "Enter Key" –AsSecureString

•

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.