Skip Navigation

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