How to Integrate Office Communications Server 2007 R2 with Exchange 2010

One of the new features of Outlook Web App (OWA) in Exchange 2010 is the ability for OWA to act as an IM client if you have Office Communications Server (OCS) in your environment. Once configured, you’ll be able to see and manage your buddy list, manage presence, as well as participate in IM conversations while logged in to OWA. Configuring this integration requires a number of steps on each of your Exchange 2010 Client Access Servers (CAS’). Many of the changes discussed in this blog post will cause brief service interruptions so it is highly recommended that you perform this work during a maintenance window where these interruptions are tolerable.

You’ll need to download two packages in order to proceed:

You can simply run the first download on one machine as it will extract the contents to C:\WebService Provider Installer Package (by default). Inside of this folder will be a number of installers which you’ll need to execute (in order) on each of your CAS servers:

  1. Visual C++ Redistributable (vcredist_x64.exe)
  2. Unified Communications Managed API (ucmaredist.msi)
  3. OCS Service Provider (cwaowassp.msi)

Finally, you’ll need to patch the UC Managed API by installing ucmaredist.msp.

Note: If you have User Account Control (UAC) enabled on your CAS servers, you should execute all of these packages from an elevated command prompt.

Once these packages are installed, you’re ready to configure OWA for integration with OCS. You’ll need to have the name of the OCS Pool which you plan to have your CAS servers connect to on hand as well as some information about the certificate on each CAS server which will be used to secure communications between the CAS server and OCS. Specifically, you’ll need to collect the certificate issuer string as well as the certificate’s serial number. You can do this using the following PowerShell command:

Get-ExchangeCertificate | fl Subject,Issuer,SerialNumber

You should get text returned back similar to the following:

Subject      : CN=mail14.briandesmond.net, OU=IT, O=“Brian Desmond Consulting, LLC”, L=Chicago, S=Illinois, C=US
Issuer       : CN="DigiCert Global CA", OU=www.digicert.com, O=DigiCert Inc, C=US
SerialNumber : 478C52B6B53E467F9331BB8CB4B2BDB8
Note: If you are using different certificates on each CAS server in your array, you’ll need to collect this data individually on a per CAS server basis.

Make note of the issuer and serial number values for the certificate. You’ll need to tell OWA to use this certificate for communications with OCS. To do this, browse to C:\Program Files\Microsoft\Exchange\V14\ClientAccess\Owa and open the web.config file with notepad. Scroll down and find the following section:

<add key="IMPoolName" value="" />
<add key="IMCertificateIssuer" value="" />
<add key="IMCertificateSerialNumber" value="" />

These are the three values you’ll need to populate for OWA to make the connection to OCS. The first value should be the FQDN of the OCS pool you want to connect to, and the following two values should be copied out of the Get-ExchangeCertificate spew collected earlier as shown below:

<add key="IMPoolName" value="ocspool01.briandesmond.net" />
<add key="IMCertificateIssuer" value='CN="DigiCert Global CA", OU=www.digicert.com, O=DigiCert Inc, C=US ' />
<add key="IMCertificateSerialNumber" value="47 8C 52 B6 B5 3E 46 7F 93 31 BB 8C B4 B2 BD B8" />
Warning: There are three extremely important things you need to do when customizing the configuration settings shown above:
  1. If your certificate’s issuer includes any double quotes (as mine does), you must enclose the data in single quotes instead of the default double quotes as shown above.
  2. You must insert the spaces in between each octet in the serial number as shown above.
  3. You must remember to update these values when you renew or replace the certificate on a CAS server.

Once OWA is configured, you’ll need to configure your OCS pool to trust the CAS servers. To do this, access the OCS Administration Pool, and open the Front End Properties of the pool (right click the pool, Properties>Front End Properties). On the Host Authorization tab, add an entry reflecting the certificate you configured in the web.config file in the previous step. You’ll also want to check the “Treat As Authenticated” and “Throttle As Server” checkboxes as shown below:

image

In order for this change to take effect immediately, you may need to restart the services on your OCS Front Ends. Doing this will disconnect any currently connected clients so it may instead be advantageous to wait for caches to refresh. The final step is to enable OCS IM integration for the OWA virtual directory. To do this, run the following PowerShell command:

Get-OwaVirtualDirectory -Server YourCasServer | Set-OwaVirtualDirectory -InstantMessagingType OCS

Users who are enabled for OCS should see their buddy list as well as a jelly bean to manage presence next time they login:

image image

 

In summary, there are four key steps you’ll need to take in order to enable OCS integration with Outlook Web App in Exchange 2010. First, you’ll need to download the service provider and latest rollup for the components in the service provider download. Next, you’ll need to install the components downloaded on each Client Access Server. You’ll then collect certificate information from each CAS server and configure that information along with your OCS pool information in the OWA web.config file. Finally, you’ll add the CAS certificate to the list of trusted hosts in OCS and enable OCS integration on the OWA virtual directory.

Since writing this post, I’ve added a couple additional posts which may be worth reviewing: Firewall Requirements for Integrating OCS and OWA.

Posted Sunday, March 07 2010 3:43 PM by Brian Desmond | 8 Comments
Tagged as: , , , ,

Comments, Trackbacks, & Pingbacks

#1 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

Friday, April 16 2010 8:46 AM by Hunter Coleman

Brian-

Thanks for the post...very helpful in getting it going for our environment. I'm unclear on one part: for the IMCertificateIssuer section of the web.config file, for your example should that be "CN=DigiCert Global CA, OU=www.digicert.com, O=DigiCert Inc, C=US "?

#2 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

Friday, April 16 2010 9:47 AM by Brian Desmond

Yes - good catch. I'll fix the post.

#3 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

Tuesday, June 15 2010 9:36 AM by Italian translation

Excellent instructions and very easy to follow.

#4 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

Monday, June 21 2010 10:22 AM by Steve

Nice write up.

I am having few problems getting this to work. Let me explain my set up.

I have two cas servers 01 and 02 in a NLB and resolve to CAS and Webmail alias

I have done host authentication for all address Cas01,cas02,cas and webmail

Made the change owa-VirtualDirectory change and checked the setting to make sure they have applied.

But I am still unable to see the IM settings in OWA

Any ideas where I might gone wrong?

Thanks

Steve

#5 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

Wednesday, July 07 2010 2:30 PM by business intelligence

This is some helpful tutorial,nice

#6 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

Thursday, July 22 2010 5:35 AM by Maziar

Hi,

I followed your instructions exactly... But I get the "Instant Messaging isn't available..." in OWA... I checked, I rechecked, and I checked again, everything done exactly as you mentioned, where do you think I should check?

I don't have any firewalls protecting my servers from each other and my certificate authority is self signed, meaning I'm not using commercial certs.

Thanx in advance.

#7 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

July 4, 2010 7:17 PM by Firewall Requirements for Integrating OCS and OWA

If you follow my directions for integrating Office Communications Server 2007 R2 with Exchange Server

#8 re: How to Integrate Office Communications Server 2007 R2 with Exchange 2010

July 6, 2010 4:16 PM by Firewall Requirements for Integrating OCS and OWA : Brian Desmond's Blog

Pingback from Firewall Requirements for Integrating OCS and OWA : Brian Desmond's Blog

Leave a comment