Administration Guide

Local Navigation

BlackBerry Manuals & Help  >  Documentation for Administrators  >  BlackBerry Enterprise Server Express  >  BlackBerry Enterprise Server Express for Microsoft Exchange  >  Administration Guide - BlackBerry Enterprise Server Express for Microsoft Exchange - 5.0.1

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

By default, the BlackBerry® Enterprise Server Express uses Microsoft® Exchange Web Services to manage calendars on BlackBerry devices. The BlackBerry Enterprise Server Express 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 Express uses MAPI and CDO libraries to manage calendars on devices. A BlackBerry Messaging Agent on the BlackBerry Enterprise Server Express 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 Express 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 Express, or all BlackBerry Enterprise Server Express 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.

Configure the BlackBerry Enterprise Server Express to use Microsoft Exchange Web Services

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

  1. Copy the BlackBerry Enterprise Server Express installation files to the computer that hosts the BlackBerry Enterprise Server Express.
  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 Express 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 Express and <agent_id> is the ID for the BlackBerry Messaging Agent.
    • To configure all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server Express 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 Express.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server Express 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 Express, <agent_id> is the ID of the BlackBerry Messaging Agent, and <date> is the date that you configured the BlackBerry Enterprise Server Express to use Microsoft Exchange Web Services.

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 Express installation files to the computer that hosts the BlackBerry Enterprise Server Express.
  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 Express 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 Express and <web_address> is the web address of the Microsoft Autodiscover service.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server Express 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 Express instances will use, type traittool -global -trait EWSSCPURL -set https://server.company.com/Autodiscover/Autodiscover.xml

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 Express installation files to the computer that hosts the BlackBerry Enterprise Server Express.
  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 Express 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 Express and <web_address> is the web address for the Microsoft Exchange client access server.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server Express 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.

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.

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 Express installation files to the computer that hosts the BlackBerry Enterprise Server Express 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 Express 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 Express and <agent_id> is the ID for the BlackBerry Messaging Agent.
    • To configure all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server Express 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 Express.
    • To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server Express instances to look up the user's status using only Microsoft Exchange Web Services, type traittool -global -trait EWSUserAvailabilityAccess -set EWS.
  5. Press ENTER.
Next topic: Correcting calendar synchronization errors on devices
Previous topic: Managing calendars

Was this information helpful? Send us your comments.