Administration Guide

Local Navigation

Configuring the BlackBerry Enterprise Server to use Microsoft Exchange Web Services or MAPI and CDO libraries

By default, the BlackBerry® Enterprise Server uses Microsoft® Exchange Web Services to manage calendars on BlackBerry devices. The BlackBerry Enterprise Server monitors periodically whether a user account can use Microsoft Exchange Web Services. If a user account cannot use Microsoft Exchange Web Services, for example, because of a configuration error in Microsoft Exchange, the BlackBerry Enterprise Server uses MAPI and CDO libraries to manage calendars on devices. A BlackBerry Messaging Agent on the BlackBerry Enterprise Server can include a dynamic mix of user accounts that use Microsoft Exchange Web Services and user accounts that use MAPI and CDO libraries.

You can use the BlackBerry® Enterprise Trait Tool to configure the BlackBerry Enterprise Server to use only Microsoft Exchange Web Services or only MAPI and CDO libraries to manage calendars on devices. You can configure a specific BlackBerry Messaging Agent instance, a specific BlackBerry Enterprise Server, or all BlackBerry Enterprise Server instances that share one BlackBerry Configuration Database.

To use Microsoft Exchange Web Services, your organization's environment must include Microsoft® Exchange 2007 SP1 or later.

For more information about Microsoft Exchange Web Services, visit http://msdn.microsoft.com/en-us/library/bb204119.aspx.

Prerequisites: Configuring the BlackBerry Enterprise Server to use Microsoft Exchange Web Services

  • Install an SSL certificate on a BlackBerry® Enterprise Server so that the BlackBerry Enterprise Server can communicate with Microsoft® Exchange Web Services. You must export the SSL certificate from the client access server for Microsoft® Exchange and import the SSL certificate to the BlackBerry Enterprise Server. The BlackBerry Enterprise Server supports a self-signed security certificate or a certificate that a certificate authority issues. For more information about installing an SSL certificate, visit support.microsoft.com to read article KB 962624.
  • Configure Microsoft® Exchange Impersonation for a BlackBerry Enterprise Server administrator account. For more information about configuring Microsoft Exchange Impersonation, visit msdn.microsoft.com/en-us/library/bb204095.aspx and select the appropriate tab for Microsoft Exchange 2007 or Microsoft Exchange 2010.
  • Assign IIS permissions to a BlackBerry Enterprise Server administrator account on the Microsoft® Exchange Server that hosts the client access server role. For more information about assigning IIS permissions, visit support.microsoft.com to read article KB 816117.
Back To Top

Turn off client throttling in Microsoft Exchange 2010

By default, Microsoft® Exchange 2010 uses client throttling policies to track the bandwidth that each Microsoft Exchange user consumes and enforce bandwidth limits as necessary. The policies affect the performance of the BlackBerry® Enterprise Server, so you should turn off client throttling for the Windows® account that has a Microsoft Exchange mailbox.
  1. On a computer that hosts the Microsoft Exchange Management Shell, open the Microsoft Exchange Management Shell.
  2. Type New-ThrottlingPolicy BESPolicy.
  3. Type the following command: Set-ThrottlingPolicy BESPolicy -RCAMaxConcurrency $null -RCAPercentTimeInAD $null -RCAPercentTimeInCAS $null -RCAPercentTimeInMailboxRPC $null -EWSMaxConcurrency $null -EWSPercentTimeInAD $null -EWSPercentTimeInCAS $null -EWSPercentTimeInMailboxRPC $null -EWSMaxSubscriptions $null -EWSFastSearchTimeoutInSeconds $null -EWSFindCountLimit $null
  4. Type Set-Mailbox "BESAdmin" -ThrottlingPolicy BESPolicy.
Back To Top

Configure the BlackBerry Enterprise Server to use Microsoft Exchange Web Services

You can configure the BlackBerry® Enterprise Server to use only Microsoft® Exchange Web Services to manage calendars on BlackBerry devices.

  1. Copy the BlackBerry Enterprise Server installation files to the computer that hosts the primary BlackBerry Enterprise Server.
  2. Extract the contents to a folder on the computer.
  3. At a command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:
    • To configure a specific BlackBerry Messaging Agent on a specific BlackBerry Enterprise Server to use Microsoft Exchange Web Services, type traittool -server <server_name> -agent <agent_id> -trait EWSEnable -set true, where <server_name> is the name of the BlackBerry Enterprise Server and <agent_id> is the ID for the BlackBerry Messaging Agent. If you configured high availability, configure only the primary BlackBerry Enterprise Server.
    • To configure all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server to use Microsoft Exchange Web Services, type traittool -server <server_name> -trait EWSEnable -set true, where <server_name> is the name of the BlackBerry Enterprise Server. If you configured high availability, configure only the primary BlackBerry Enterprise Server.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances to use Microsoft Exchange Web Services, type traittool -global -trait EWSEnable -set true.
  5. Restart the BlackBerry Messaging Agent instances that you made changes to.
After you finish:

In the logs folder verify that the file named <server_name>_CALH_<agent_id>_<date>.txt appears. In the file name, <server_name> is the name of the BlackBerry Enterprise Server, <agent_id> is the ID of the BlackBerry Messaging Agent, and <date> is the date that you configured the BlackBerry Enterprise Server to use Microsoft Exchange Web Services.

Back To Top

Configure the BlackBerry Enterprise Server to use MAPI and CDO libraries

You can configure the BlackBerry® Enterprise Server to use only MAPI and CDO libraries to manage calendars on BlackBerry devices.

  1. Copy the BlackBerry Enterprise Server installation files to the computer that hosts the primary BlackBerry Enterprise Server.
  2. Extract the contents to a folder on the computer.
  3. At a command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:
    • To configure a specific BlackBerry Messaging Agent on a specific BlackBerry Enterprise Server to use MAPI and CDO libraries, type traittool -server <server_name> -agent <agent_id> -trait EWSEnable -set false, where <server_name> is the name of the BlackBerry Enterprise Server and <agent_id> is the ID for the BlackBerry Messaging Agent. If you configured high availability, configure only the primary BlackBerry Enterprise Server.
    • To configure all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server to use MAPI and CDP libraries, type traittool -server <server_name> -trait EWSEnable -set false, where <server_name> is the name of the BlackBerry Enterprise Server. If you configured high availability, configure only the primary BlackBerry Enterprise Server.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances to use MAPI and CDO libraries, type traittool -global -trait EWSEnable -set false.
  5. Restart the BlackBerry Messaging Agent instances that you made changes to.
Back To Top

Configure the BlackBerry Messaging Agent instances to use a web address for a specific Microsoft Autodiscover service

You can configure the BlackBerry® Messaging Agent instances to use a specific Microsoft® Autodiscover service to search for a client access server for Microsoft® Exchange by specifying the web address for the service. You can use the web address of the service if the default Microsoft Autodiscover service does not find an appropriate client access server for Microsoft Exchange or if you want to use a different client access server for Microsoft Exchange.
  1. Copy the BlackBerry® Enterprise Server installation files to the computer that hosts the primary BlackBerry Enterprise Server.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:
    • To configure all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server to use a web address for a specific Microsoft Autodiscover service, type traittool -server <server_name> -trait EWSSCPURL -set <web_address>, where <server_name> is the name of the BlackBerry Enterprise Server and <web_address> is the web address of the Microsoft Autodiscover service. If you configured high availability, configure only the primary BlackBerry Enterprise Server.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances to use a web address for a specific Microsoft Autodiscover service, type traittool -global -trait EWSSCPURL -set <web_address>, where <web_address> is the web address of the Microsoft Autodiscover service.
  5. Restart the BlackBerry Messaging Agent instances that you made changes to.

Example:

To specify a web address for a specific Microsoft Autodiscover service that all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances will use, type traittool -global -trait EWSSCPURL -set https://server.company.com/Autodiscover/Autodiscover.xml

Back To Top

Configure the BlackBerry Messaging Agent instances to use a specific web address for a client access server for Microsoft Exchange

You can configure the BlackBerry® Messaging Agent instances to use a specific client access server for Microsoft® Exchange to connect to Microsoft Exchange Web Services. You can use the specific web address for the client access server if you do not have access to the Microsoft® Autodiscover service or if you do not want to use the client access server for Microsoft Exchange that the Microsoft Autodiscover service selects. If you configure the BlackBerry Messaging Agent instances to use the web address for the client access server, the BlackBerry Messaging Agent instances do not use the Microsoft Autodiscover service to search for a client access server for Microsoft Exchange.
  1. Copy the BlackBerry® Enterprise Server installation files to the computer that hosts the primary BlackBerry Enterprise Server.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:
    • To configure a specific BlackBerry Enterprise Server to use a specific web address for a client access server for Microsoft Exchange, type traittool -server <server_name> -trait EWSCASURL -set <web_address>, where <server_name> is the name of the BlackBerry Enterprise Server and <web_address> is the web address for the Microsoft Exchange client access server. If you configured high availability, configure only the primary BlackBerry Enterprise Server.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances to use a specific web address for a client access server for Microsoft Exchange, type traittool -global -trait EWSCASURL -set <web_address>, where <web_address> is the web address for the Microsoft Exchange client access server.
  5. Restart the BlackBerry Messaging Agent instances that you made changes to.
Back To Top

Configuring the BlackBerry Messaging Agent instances to look up the user's status using only Microsoft Exchange Web Services

You can configure the BlackBerry® Messaging Agent instances to use only Microsoft® Exchange Web Services to determine the user's status, for example, whether a user is available, busy, or offline. By default, the BlackBerry Messaging Agent instances can determine the user's status using Microsoft Exchange Web Services unless the user is an external user or the user's email address is a distribution list. If the BlackBerry Messaging Agent instances cannot determine the user's status using Microsoft Exchange Web Services and Microsoft Exchange public folders that are in your organization's environment, the BlackBerry Messaging Agent instances can search the Microsoft Exchange public folders for the user's status. If your organization's environment is running Microsoft Exchange 2007, it does not include public folders and the BlackBerry Messaging Agent instances write error messages to the log files because they cannot find the public folders.

You can configure the BlackBerry Messaging Agent instances to look up the user's status using only Microsoft Exchange Web Services to avoid the BlackBerry Messaging Agent instances writing error messages to their log files.

Back To Top

Configure the BlackBerry Messaging Agent instances to look up a user's status using only Microsoft Exchange Web Services

  1. Copy the BlackBerry® Enterprise Server installation files to the computer that hosts the primary BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:
    • To configure a BlackBerry Messaging Agent on a BlackBerry Enterprise Server to look up the user's status using only Microsoft® Exchange Web Services, type traittool -server <server_name> -agent <agent_id> -trait EWSUserAvailabilityAccess -set EWS, where <server_name> is the name of the BlackBerry Enterprise Server and <agent_id> is the ID for the BlackBerry Messaging Agent.
    • To configure all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server to look up the user's status using only Microsoft Exchange Web Services, type traittool -server <server_name> -trait EWSUserAvailabilityAccess -set EWS, where <server_name> is the name of the BlackBerry Enterprise Server.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances to look up the user's status using only Microsoft Exchange Web Services, type traittool -global -trait EWSUserAvailabilityAccess -set EWS.
  5. Press ENTER.
Back To Top
Previous topic: Managing calendars

Was this information helpful? Send us your comments.