Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Work 2.19
  3. Configuring Office 365 Modern Authentication for BlackBerry Dynamics Apps
  4. Appendix A: Understanding the BEMS-Connect configuration file

Appendix A: 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.
After updating the configuration parameters, you must restart the 
BEMS
 machine 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/
http://*:8080/
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 
Microsoft Lync Server
 or 
Skype for Business
 server is federated (connected) with your company’s 
Microsoft Lync Server
 or 
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 
Microsoft Lync Server
 2013 or 
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 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_HOST
—
FQDN of the 
Microsoft Exchange Server
 to which the 
BlackBerry Connect
 server writes conversation histories.
EWS_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
  • 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://gp.myCompany.com:17433.
IS_ON_LINE_ENABLED
—
This setting specifies that the 
Connect
 service is configured to work with 
Skype for Business Online
.
False
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
The 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