Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Enterprise Mobility Server 3.7
  3. Configuring the BlackBerry Connect service
  4. Appendix: Understanding the BEMS-Connect configuration file

Appendix: Understanding the
BEMS-Connect
 configuration file

Configuration settings can be manually updated in the
BEMS
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.
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
 2015 server.
For more information about enabling persistent chat, see the
BlackBerry Connect
 Administration content.
False
EWS_HISTORY_INTERVAL
_MINUTES
—
Defines the number of interval 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.
For information on changing the Conversation History folder name to a localized name (for example, Historique des conversations), visit http://support.blackberry.com/community to read article 71402.
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
Good 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-premise.
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
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