Appendix: Understanding the BEMS-Connect configuration file

Configuration settings can be manually updated in the Connect configuration file (GoodConnectServer.exe.config) located in <drive>\Program Files\BlackBerry\BlackBerry Enterprise Mobility Server\Good Connect. However, best practice for updating the file should use the BEMS admin console. If you manually update the configuration file, complete this task on each computer that hosts the Connect service.
Note: Stop the Good Technology Connect service before you update the configuration file, make your changes, and start the service on BEMS for the changes to take effect.

Parameter name

Required

Description

Default setting

ACK_TIME_WAIT

—

Time (in milliseconds) that the BlackBerry Connect server waits for acknowledgment from client for a message received before sending message failed to deliver.

90 000

ACTIVE_DIRECTORY_CACHE

_REFRESH_SECS

√

The number of seconds the BlackBerry Connect server waits before synchronizing with the Microsoft Active Directory (any value smaller than 7200 is disregarded in favor of 7200 seconds).

86,400 (24 hours)

ACTIVE_DIRECTORY_SEARCH

_RESULT_MAX

√

The upper limit on the number of hits from a search of the company directory.

50

AD_USERS_SOURCE

—

Parameter indicates if the Connect service should connect to Microsoft Active Directory Global Catalog servers or use the distinguished name to a local Domain Controller for loading SIP-enabled users. This value can be “GC” or “LDAP”. By default, the value is LDAP if the value is empty.

AD_USERS_SOURCE_DOMAIN

√

If users source is GC

The Active Directory Domain in the Global Catalog to query. This value can be the distinguished name of the domain or the fully qualified domain name; for example, DC=EXAMPLE,DC=COM or EXAMPLE.COM, respectively.

APN_BADGE

√

Determines whether or not to use the badge graphic for Apple push notifications.

True

APN_SLEEP_TIME

√

The number of milliseconds the BlackBerry Connect server waits in between queued Apple push notifications.

100

APN_SOUND

√

Play sound when an Apple device receives a push notification.

BASE_URL

√
Web address for the Connect service which takes one of the following values:
  • http://*:8080/
  • https://*:8082/

https://*:8082/

BUILD_VERSION

√

The version number of the BlackBerry Connect server build.

Auto-populated

DB_PURGE_HOURS

—

Any IMs from invitations are obfuscated. In addition to obfuscation, the integer value representing the maximum age, in hours, of missed messages and invitations before they are automatically deleted (purged) is set with DB_PURGE_HOURS.

For example, <add key="DB_PURGE_HOURS" value="72" />

If Connect is started 7/8/2015 @ 12:31pm, then on 7/9/2015 @ 12:31pm a process removes all invitations and all missed messages older than 72 hours. Connect continues to run every 24 hours thereafter.

0

DB_RECONNECT_TRY_NUM

√

Number of times the Connect server tries reconnecting to the database after a failure to connect to database.

3

DB_RECONNECT_WAITTIME_SEC

√

Number of seconds the Connect server waits before trying to reconnecting to database.

300

DB_SESSION_TIMEOUT_SECS

√

Time limit for search Lync/OCS database as defined by LYNC_DB_CONNECTIONSTRING.

300

DISABLE_MESSAGEUPDATE

—

Disable message not delivered errors which may potentially be due client and network latencies.

False

DISABLE_SSL_CERT_CHECKING

—

Disables certificate validation when the Connect service connects to the Notifications service.

For example, <add key="DISABLE_SSL_CERT_CHECKING" value="true" />

False

ENABLE_SOURCE_NETWORK

—

Labels address book contacts as "external" if they do not belong to your organization. These are federated contacts. A federated contact is a member of a company whose Skype for Business server is federated (connected) with your company’s Skype for Business server.

False

ENABLE_PERSISTENT_CHAT

—

Enables persistent chat features in BEMS, enabling users to create and participate in group discussions. Requires that the feature is enabled in Skype for Business Server.

For more information about enabling persistent chat, see the BlackBerry Connect Administration content.

False

EWS_HISTORY_INTERVAL

_MINUTES

—

Defines the number of intervals in minutes the BlackBerry Connect server waits before writing to Conversation history. 0 means that conversation history is written only after conversation has been terminated.

5

EWS_HISTORY_FOLDER_NAME

—

Name of the folder in users' Microsoft Exchange mailbox where conversations are saved and accessible by the users.

For more information about enabling conversation history, see Configure BEMS to access on-premises Microsoft Exchange Server conversation histories.

EWS_HOST

—

FQDN of the Microsoft Exchange Server to which the BlackBerry Connect server writes conversation histories.

WS_VERSION

—
EWS_Version parameter number and corresponding Microsoft Exchange Server version
  • 1 = Microsoft Exchange Server 2010
  • 2 = Microsoft Exchange Server 2010 SP1
  • 3 = Microsoft Exchange Server 2010 SP2
  • 4 = Microsoft Exchange Server 2010 SP3
  • 5 = Microsoft Exchange Server 2013
  • 6 = Microsoft Exchange Server 2016 and Microsoft Exchange Server 2019
  • 100 = Microsoft Exchange Online

2

GD_APN_HTTP_URL

√

Web Service web address for BlackBerry Dynamics Apple Push Notifications Service (APNS).

GD_APN_PROXY_AUTH_DOMAIN

—

Web Proxy Domain

Deprecated

GD_APN_PROXY_AUTH

_PASSWORD

—

Web Proxy Password

Deprecated

GD_APN_PROXY_AUTH

_USERNAME

—

Web Proxy Username

Deprecated

GD_APN_PROXY_HTTP_HOST

—

Web Proxy Host

GD_APN_PROXY_HTTP_PORT

—

Web Proxy Port

GD_APN_PROXY_TYPE

—

Web Proxy Authentication Mechanisms. Acceptable values are:

"" (empty string for no proxy)
 "Basic No Auth"
 "Basic"
 "Digest"

""

GD_APNS_BLACKLIST_RETRY

_NO

√

Specifies the number retries after the server receives APNS response where the token is blacklisted

3

GD_URL

√

Complete web address of the proxy server, with protocol, fully qualified domain name, and port. For example: https://example.com:17433.

IS_ON_PREM_ENABLED

—

This setting specifies that the Connect service is configured to work with Skype for Business on-premises.

False

IS_TRUSTED_APP_MODE

—

This setting specifies that the Connect service is configured to work with Skype for Business on-premises and uses trusted application mode to obtain user information.

True

LONG_INVITATION_TIME_DELAY

—

Time (in milliseconds) that a Connect client waits for invitation received to confirm or ignore a request to a conversation.

60 000

LYNC_SERVER

√

The FQDN of the Microsoft Lync Front-End server or Front-End server pool.

LYNC FQDN

LYNC_PORT

he port number of the MIcrosoft Lync Front-End server or Front-End server pool.

5061

PCHAT_DEFAULT_CATEGORY_ID

—

Specifies the default persistent chat category for users.

For more information about enabling persistent chat, see the BlackBerry Connect Administration content.

RESTRICT_CERT_BY_FRIENDLY

_NAME

—

Allows naming of certificate so that the BlackBerry Connect can load correct certificate; the certificate friendly name must match the name specified here.

SEND_TIME_WAIT

—

Time (in milliseconds) the BlackBerry Connect server waits after sending message before reporting message failed to deliver.

120 000

SESSION_TIMEOUT_SECS

√

The number of seconds a client is allowed to remain idle

Note: The minimum SESSION_TIMEOUT_SECS is 600, even if you put in 60 seconds or 1 second. This was done to mitigate stress related race conditions.

86,400 (24 hours)

UCMA_APPLICATION_NAME

√

Name of application as defined through the installation provisioning process.

Generated during application provisioning

UCMA_APPLICATION_PORT

√

The fixed port used by the BlackBerry Connect server to receive messages from the enterprise IM server.

49555

UCMA_GRUU

√

GRUU = Globally Routable User-Agent URI that uniquely defines the Session Initiation Protocol (SIP) URI for the application.

Generated during application provisioning