Install BES 5.0.1 MR1 or higher in an Exchange 2010 Environment
Install BES 5.0.1 MR1 or higher in an Exchange 2010 Environment
Note: In an Exchange 2010 environment BlackBerry Enterprise Server should NOT be installed on the mail server. Also before installing BES you MUST have public folders enabled and have an Offline Address book configured in Exchange 2010.
STEP 1
On the server you have selected to load BlackBerry Enterprise Server download and install “Microsoft Exchange Server MAPI Client and Collaboration Data Objects 1.2.1” (Exchange 2010 requires version 6.5.8147 or higher and Exchange 2010 SP1 requires version 6.5.8211.0 or higher) which is available from the Microsoft Download site (a.k.a ExchangeMapiCdo.EXE). This will install the CDO and MAPI DLLs which is a prerequisite for BES to operate correctly. This replaces the previous requirement to have Exchange System Manager installed in Exchange 2000 or 2003 environments. The current download link is as follows: Download details: Microsoft Exchange Server MAPI Client and Collaboration Data Objects 1.2.1
STEP 2
Log onto your Exchange Server using an account which has permissions to create an new account. Open the Exchange Management Console and create a new account and mailbox for a user called BESadmin.
STEP 3
From the Exchange 2010 server open the “Exchange Management Shell” which can be found in the Exchange program group run the following two scripts to set the required delegate control and permissions:
Add-RoleGroupMember “View-Only Organization Management” -Member “BESAdmin”
Get-MailboxDatabase | Add-ADPermission -User “BESAdmin” -AccessRights ExtendedRight -ExtendedRights Receive-As, ms-Exch-Store-Admin
STEP 4
Now you need to set the Send AS permissions using the command below:
Add-ADPermission -InheritedObjectType User -InheritanceType Descendents -ExtendedRights Send-As -User “BESAdmin” -Identity CN=Users,DC=,DC=,DC=”
Example:
Add-ADPermission -InheritedObjectType User -InheritanceType Descendents -ExtendedRights Send-As -User “BESAdmin” -Identity “CN=Users,DC=bbforums,DC=local”
Note: It is common for this command to fail and you will receive the error below. If this error appears please refer to the workaround provide that is listed under the error code below.
Active Directory operation failed on Domain ***Controllor Name***. This error is not retriable. Additional information: Access is
denied.
Active directory response: 00000005: SecErr: DSID-031521D0, problem 4003 (INSUFF_ACCESS_RIGHTS), data 0
+ CategoryInfo : WriteError: (0:Int32) [Add-ADPermission], ADOperationException
+ FullyQualifiedErrorId : DA172DD1,Microsoft.Exchange.Management.RecipientTa sks.AddADPermission
Workaround 1
Assign Send As permissions to all users via Active Directory
1. Open Active Directory.
2. Select the “View” menu and ensure “Advanced Features” is checked.
3. Right mouse click on your domain name and select Properties
4. Select the Security tab
5. Press the Advanced button at the bottom on the security tab
6. Select “Add” and enter your Blackberry Service Account name (e.g. BESadmin) and select OK
7. When the permissions screen appears change “Apply onto:” to “User Objects” (or “Descendant User Objects” on Server 2008)
8. In the permissions box scroll down and check the Allow box beside “Send As” and press OK
9. Press Apply and OK to exit
Workaround 2
Individually assign Send As permissions to a user via the Exchange Management Shell:
Add-ADPermission “BES User Mailbox Name” -User “DomainBESadmin” -Extendedrights “Send As”
Example: Add-ADPermission “Gary Cutri” -User “DomainBESadmin” -Extendedrights “Send As”
STEP 5
We need to turn off client throttling in Microsoft Exchange 2010 as it enforces bandwidth limits which will affect the BlackBerry Server. To do this run the following three commands from the Exchange Management Shell.
NOTE:
RESOLVED: OpenMsgStore failed (8004011d) error in Exchange 2010
NOTE: If you followed the official BES 5.0.1 install guide you would have issued the following two commands:
New-ThrottlingPolicy BESPolicy
Set-Mailbox “BESAdmin” -ThrottlingPolicy BESPolicy
These two commands would have created a new policy and added BESadmin with all the default settings (RCAMaxConcurrency = 20) which will cause the “OpenMsgStore failed (8004011d)” error to occur once multiple users are added to the BES.
To correct this error please enter the commands below into the Exchange Management Shell:
1. Change the RCAMaxConcurrency setting to unlimited (default is 20) using the following command:
Get-ThrottlingPolicy | where {$_.IsDefault -eq $true} | Set-ThrottlingPolicy -RCAMaxConcurrency $null
2. Display a list of your Throttling Policies using the following command:
Get-ThrottlingPolicy
3. From the “Get-ThrottlingPolicy” output locate and copy the “DefaultThrottlingPolicy” name.
Example: “DefaultThrottlingPolicy_a1f84187-7a42-4ece-9276-06c704be21e7”
4. Now enter the command below but paste in your DefaultThrottlingPolicy name.
Set-Mailbox “BESAdmin” -ThrottlingPolicy
Example: Set-Mailbox “BESAdmin” DefaultThrottlingPolicy_a1f84187-7a42-4ece-9276-06c704
5. Now we need to remove the BESPolicy that isn’t required by issuing the command below:
Remove-ThrottlingPolicy BESPolic
New-ThrottlingPolicy BESPolicy
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
Set-Mailbox “BESAdmin” -ThrottlingPolicy BESPolicy
If the Microsoft Exchange Server is 2010 SP1, complete the following steps:
New-ThrottlingPolicy BESPolicy -CPAMaxConcurrency $NULL -CPAPercentTimeInCAS $NULL -CPAPercentTimeInMailboxRPC $NULL -RCAMaxConcurrency $null -RCAPercentTimeInAD $null -RCAPercentTimeInCAS $null -RCAPercentTimeInMailboxRPC $null -EWSMaxConcurrency $null -EWSPercentTimeInAD $null -EWSPercentTimeInCAS $null -EWSPercentTimeInMailboxRPC $null -EWSMaxSubscriptions $null -EWSFastSearchTimeoutInSeconds $null -EWSFindCountLimit $null
Set-Mailbox “BESAdmin” -ThrottlingPolicy BESPolicy
STEP 6
NOTE: This step is not required in Exchange 2010 SP1 as it is now managed with the Throttling Policy (i.e. -CPAMaxConcurrency $NULL -CPAPercentTimeInCAS $NULL -CPAPercentTimeInMailboxRPC $NULL)
Now we need to increase the maximum number of connections Exchange 2010 allows to the Address Book service. By default this is set to 50 and to increase this navigate to “Program FilesMicrosoftExchange ServerV14Bin” and open the microsoft.exchange.addressbook.service.exe.config file with Notepad. Now change the MaxSessionsPerUser entry to 100000 and then save the file and restart the Address Book service.
Note: By default you may not have permission to edit this file so edit the permissions > add the administration account you are using > grant this account access to edit the file.
STEP 7
You have the ability to allow the BES to use Exchange Web Services to manage calendars on the devices, in order to utilize this service you need to configure a management role by running the following command from the
Exchange Management Shell:
New-ManagementRoleAssignment -Name “BES Admin EWS” -Role ApplicationImpersonation -User “BESAdmin”
Get-Mailbox -Server “” | Set-CalendarProcessing -ProcessExternalMeetingMessages $true
STEP 8
Make BESadmin a local Administrator of the server where you will be installing the BES software. This is done by right mouse clicking My Computer and selecting “Manage”. From Computer Management expand “Local Users & Groups” and select Groups (or in Server 2008 right click Computer > From Server Manager expand Configuration and select “Local Users & Groups” > Select Groups). From Groups double click “Administrators” and add BESadmin.
STEP 9
On the BES server go to “Administrative Tools” and open “Local Security Policy” and then expand the “Local Policies” and “User Right Assignment”. You need to add BESadmin to “Log on Locally” and “Log on as Service”.
STEP 10
Log onto the server where you will be installing the BES using the BESadmin account. Extract the install files and run the setup file. When making your selection please note that the Monitoring service should be installed on a separate machine and the MDS Integration Service is only required for application development (note: the standard MDS service is installed by default). During the install you will be prompted to reboot, please ensure after the restart you logon as BESadmin again as the installation will continue. During the final part of the installation when you enter your SRP ID, Auth Key and CAL please ensure you select the verify option as apart from validating the info it confirms that Port 3101 is opened correctly.
Note: If you are installing BES onto server with existing services that use port 443 during the BES install change the HTTPS Service Port to a port that does not conflict with any other applications e.g. 643 or 3443. For further information on issues that prevent access to BAS please refer to the link below:
The Unofficial BlackBerry Support Forum – Threads Tagged with bas
STEP 11
Once the installation is completed and the service have started log onto the Blackberry Administration Service. Please note that the BAS-AS services needs to reach approximately 385MB of memory usage (you can check this via task manager) before it can be accessed.
Note: If you are unable to logon to the BAS using Active Directory credentials please run the attached “AddBASAuthentication.sql” script below as this will create a local “BlackBerry Administration Service” account with the username: admin and the password: blackberry.
STEP 12
In order to get you up to speed on adding users and performing activations please refer to the video tutorial below:
Tutorial – BlackBerry Administration Service
Extra Details:
Send As Permissions
Unlisted message error or Desktop email program unable to submit message
Note: For sites running Exchange 2010 SP1 you must be running BES 5.0.2 MR4 and MAPICDO Client 1.2.1 version 6.5.8211.0 or above to prevent latency issues (More Info: Guide: BES 5.0.2 and Exchange 2010 SP1 Latency Issues)
RESOLVED: OpenMsgStore failed (8004011d) error in Exchange 2010
NOTE: This post is now outdated and has been updated in the install guide above.
If you followed the official BES 5.0.1 install guide you would have issued the following two commands:
New-ThrottlingPolicy BESPolicy
Set-Mailbox “BESAdmin” -ThrottlingPolicy BESPolicy
These two commands would have created a new policy and added BESadmin with all the default settings (RCAMaxConcurrency = 20) which will cause the “OpenMsgStore failed (8004011d)” error to occur once multiple users are added to the BES.
To correct this error please enter the commands below into the Exchange Management Shell:
1. Change the RCAMaxConcurrency setting to unlimited (default is 20) using the following command:
Get-ThrottlingPolicy | where {$_.IsDefault -eq $true} | Set-ThrottlingPolicy -RCAMaxConcurrency $null
2. Display a list of your Throttling Policies using the following command:
Get-ThrottlingPolicy
3. From the “Get-ThrottlingPolicy” output locate and copy the “DefaultThrottlingPolicy” name.
Example: “DefaultThrottlingPolicy_a1f84187-7a42-4ece-9276-06c704be21e7”
4. Now enter the command below but paste in your DefaultThrottlingPolicy name.
Set-Mailbox “BESAdmin” -ThrottlingPolicy
Example: Set-Mailbox “BESAdmin” DefaultThrottlingPolicy_a1f84187-7a42-4ece-9276-06c704
5. Now we need to remove the BESPolicy that isn’t required by issuing the command below:
Remove-ThrottlingPolicy BESPolicy