BlackBerry Support for Microsoft Office Communications Server 2007 R2, Lync 2010, and Lync 2013

Article ID: KB36122

Type: Support Content

Last Modified: 07-16-2014

 

Product(s) Affected:

  • BlackBerry Enterprise Service 10
  • BlackBerry Enterprise IM for BlackBerry 10
  • BlackBerry Client for use with Microsoft Office Communications Server
  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
  • BlackBerry Enterprise Server for Novell GroupWise
  • BlackBerry Enterprise Server for Microsoft Office 365
CollapseEnvironment
  • BlackBerry Enterprise Server 5.0 SP3 to SP4
  • BlackBerry Enterprise Server for Microsoft Office 365
  • BlackBerry Enterprise Service 10
  • BlackBerry Collaboration Service
  • Microsoft Office Communications Server 2007 R2
  • Microsoft Lync 2010 to 2013
CollapseOverview

In order to properly communicate with Microsoft Office Communications Server 2007 R2, Lync 2010, or Lync 2013, the BlackBerry Solution requires the use of the BlackBerry Collaboration Service, various Microsoft components, a valid certificate that is trusted by the Microsoft front end pool servers and the local server hosting the BlackBerry Collaboration Service, and provisioning records in Microsoft Active Directory.

Note : The BlackBerry Collaboration Service only supports on-premise Microsoft Office Communications Server 2007 R2, Lync 2010, or Lync 2013. Hosted or cloud-based Lync environments are not supported.

The BlackBerry Collaboration Service is a UCMA 2.0 Trusted Application Server developed on the UCMA 2.0 Software Development Kit. The BlackBerry Collaboration Service, therefore, is a middleware product that handles all of the interactions with the Microsoft on-premise instant messaging infrastructure via Unified Communications Managed API 2.0. Active endpoints are created at the BlackBerry Collaboration Service on behalf of the mobile users when they login from the handheld client applications. Microsoft Lync 2010 and 2013 are backwards compatible with UCMA 2.0 Trusted Application Servers, therefore there is no requirement to use UCMA 3.0 or higher.

The only supported Windows Server versions for this implementation of the BlackBerry Collaboration Service are Windows Server 2003 64-bit and Windows Server 2008 64-bit. Windows Server 2012 does not support the installation of the UCMA 2.0 platform.

In order for the BlackBerry Collaboration Service to properly function when communicating with Microsoft Office 2007 R2, Lync 2010, or Lync 2013 Front End Pool servers, very specific Microsoft components must be installed. These components are not included in the installation packages from BlackBerry (except for Microsoft SQL client and Visual C++).

  • Microsoft Office Communications Server 2007 R2, Core Components, version 3.5.6907.xxx (ocscore.msi)
  • Microsoft Office Communications Server 2007 R2, Microsoft Unified Communications Managed API 2.0 Core Redist 64-bit, version 3.5.6907.xxx (ucmaredist.msi)
  • Microsoft Visual C++ 2008 Redistributable - x64 (vcredist_x64.exe)
  • Microsoft SQL Server Native Client (sqlcli_x64.msi)
  • Microsoft .NET Framework 3.5 SP1

Microsoft has made these components available via the Microsoft Unified Communications Managed API 2.0 SDK (64 bit). These are also available in the original installation media that comes with Microsoft Office Communications Server 2007 R2.

To obtain the above Microsoft components for manual installation, follow these Tasks on any Windows server or workstation that is 64-bit (does not have to be the server hosting the BlackBerry Collaboration Service, as the installation of this Software Development Kit does not install the prerequisites listed above):

Task 1

  1. Open a web browser and navigate to Microsoft's Download Center at www.microsoft.com/download.
  2. In the open search box at the top of the page, enter Microsoft Unified Communications Managed API 2.0 SDK (64 bit).
  3. Click on the link Microsoft Unified Communications Managed API 2.0 SDK (64 bit)
  4. Click Download
  5. Click the checkbox beside UcmaSdkWebDownload.msi
  6. Click Next
  7. Once the download has completed, use Windows Explorer to locate the downloaded file.
  8. Double-click the file to execute the installation process.
  9. Follow the on-screen steps to install the Software Development Kit. This installation will include a destination folder that defaults to C:\Microsoft Unified Communications Managed API 2.0 SDK Installer package. Take note of this folder location.
  10. Once the Software Development Kit installation is completed, open Windows Explorer and navigate to the folder location noted above.
  11. Double-click on the amd64 folder
  12. Copy these files to the server hosting the BlackBerry Collaboration Service:
    • vcredist_x64.exe
    • sqlncli_x64.msi
    • dotnetfx35setup.exe
  13. Double-click on the setup folder
  14. Copy these files to the server hosting the BlackBerry Collaboration Service:
    • ocscore.msi
    • ucmaredist.msi
  15. Once this has been completed, the Software Development Kit can be uninstalled/removed.

Task 2

It is also a requirement for stable functionality to apply the latest Microsoft UCMA 2.0 Hotfix to the server after the above items are installed.

  1. Open a web browser and navigate to Microsoft's Download Center at www.microsoft.com/download.
  2. In the search box at the top of the page, enter Microsoft Office Communications Server 2007 R2 Hotfix KB 968802 and press enter.
  3. Click on the resulting reference to Microsoft Office Communications Server 2007 R2 Hotfix KB 968802
  4. Click Download
  5. Select ServerUpdateInstaller.exe
  6. Click Next
  7. Once the download completes, copy the downloaded item to the server hosting the BlackBerry Collaboration Service.

Task 3

On the server hosting the BlackBerry Collaboration Service:

Install Microsoft .NET Framework 3.5 SP1

Note: If BlackBerry Enterprise Service 10 is already installed where Microsoft .NET Framework 4.0 is installed, and Microsoft .NET Framework 3.5 SP1 needs to be installed, .NET 4.0 needs to be removed. However, .NET 4.0 is required for the Universal Device Service to properly function. Refer to KB34127 for more information on this concern.

If using Windows Server 2003:

  1. Open the Control Panel.
  2. Click on Add/Remove Programs.
  3. Confirm if Microsoft .NET Framework 3.5 SP1 is installed. If so, skip to installing the remaining software below.
  4. Open Windows Explorer.
  5. Locate the files copied from the above steps.
  6. Double-click dotnetfx35setup.exe to install Microsoft .NET Framework 3.5 SP1

If using Windows Server 2008:

  1. Open Windows Server Manager.
  2. In the left frame, click on Features.
  3. If .NET Framework 3.5.1 Features is listed in the center frame, then skip to installing the remaining software below.
  4. Click Add Features
  5. Expand .NET Framework 3.5.1 Features
  6. Click the checkbox for .NET Framework 3.5.1
  7. Click Next
  8. Click Install
  9. Click Close
  10. Close the Windows Server Manager.

Note: PowerShell can also be used to install this feature for Windows Server 2008:

  1. On the Windows Server 2008 server, click Start.
  2. Move the mouse over All Programs and click on Accessories
  3. Expand Windows PowerShell, right-click Windows PowerShell, and select Run as administrator.
  4. Click Yes
  5. In the PowerShell command window, enter these two commands:
    • Import-Module ServerManager
    • Get-WindowsFeature as-net-framework
  6. If the feature is not installed, then run this command:
    • Add-WindowsFeature as-net-framework
  7. Close this PowerShell command window when completed.

Task 4

Install remaining software:

  1. Open Windows Explorer.
  2. Locate the files copied from the above steps.
  3. Open Windows Explorer.
  4. Locate the files copied from the above steps.
  5. Double-click on vcredist_x64.exe to install this Visual C++ item. This item may already be installed of this is being performed on a server already hosting BlackBerry Enterprise Server or BlackBerry Enterprise Service components.
  6. Double-click on sqlncli_x64.msi to install this SQL Client item. This item may already be installed of this is being performed on a server already hosting BlackBerry Enterprise Server or BlackBerry Enterprise Service components.
  7. Double-click on ocscore.msi to install this OCS Core Components item.
  8. Double-click on ucmaredist.msi to install this UCMA 2.0 Platform item.
  9. Double-click on ServerUpdateInstaller.exe to apply this update to the OCS Core Components and UCMA 2.0 Platform. Once the updates are complete, click on the graphical user interface that was initially presented to then see the status and access the Close button (this may be behind the command window that opens during the patching process).
  10. Review the information in Programs and Features or Add/Remove Programs to confirm the correct application items are installed and the versions are indeed updated.

To obtain a valid certificate that is required for the BlackBerry Collaboration Service to properly communicate with the Microsoft Office Communications Server 2007 R2 or Lync front end pool servers, please review KB24960.

For the BlackBerry Collaboration Service to be fully authorized as a Trusted Server in the Microsoft Office Communications Server 2007 R2 or Lync topology, please review the Knowledge Base articles and documentation that discuss Automatic or Manual Provisioning (KB32188 and KB28474).

CollapseAdditional Information

The prerequisites are listed in detail in the Installation and Administration Guides for BlackBerry Collaboration Service 10 and Installation and Configuration Guides for BlackBerry Enterprise Server 5.

Documentation is available at docs.blackberry.com

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.