Set Up an Office Communications Server 2007 R2 Federation Clearinghouse
This article provides some guidance about how to set up a Microsoft Office Communications Server 2007 R2 federation clearinghouse deployment. The goal of the clearinghouse is to simplify Public IM Connectivity (PIC) (such as AOL, The Microsoft Network (MSN), and Yahoo) with existing on-premise Office Communications Server 2007 R2 deployments. The clearinghouse model also facilitates relationships between member organizations.
Author: Wajih Yahyaoui
Publication date: May 2010
Product version: Microsoft Office Communications Server 2007 R2
This article shows you how to set up a Microsoft Office Communications Server 2007 R2 federation clearinghouse deployment. This clearinghouse is a central location that manages federation connections between enterprises. The goals of the clearinghouse are to simplify the following:
- Public IM Connectivity (PIC) (such as America Online (AOL), The Microsoft Network (MSN), and Yahoo)
- Existing on-premise Office Communications Server 2007 R2 deployments
The clearinghouse model also facilitates relationships between member organizations. Companies can federate more easily with each other without setting up explicit pair-wise federation relationships.
Configure a Clearinghouse
Here is how to configure an Office Communications Server 2007 R2 Access Edge Server to be a clearinghouse or route Session Initiation Protocol (SIP) traffic to a clearinghouse.
Routing outbound SIP traffic to a clearinghouse is usually done by configuring a default route on the Office Communications Server 2007 R2 Access Edge Server. All federated outbound SIP traffic will be routed by using the default route.
Note: A default route cannot be specified at the same that that an Access Edge Server is being configured to be a clearinghouse.
- At the command prompt, type wbemtest. A dialog box appears.
- Click Connect.
- In the Namespace box, type root\cimv2.
- Click Connect, and then click Query.
- In the box for Query, type Select * from MSFT_SipFederationExternalEdgeSetting. Click Apply.
- Double-click the result that was returned.
- On the Object Editor tabbed page, double-click the DefaultRoute property.
- On the Value tabbed page, click Not Null.
- In the Value box, type the fully qualified domain name (FQDN) of the Clearinghouse Access Edge Server.
- Click Save Property, and then click Save Object.
- Click Close, Close, and then click Exit to close wbemtest.
Troubleshooting
Acting as a clearinghouse and using a clearinghouse are special attributes that cannot be used in conjunction with other attributes. Following is a list of common issues that may arise when you attempt to configure a clearinghouse:
- The IsClearingHouse attribute and the DefaultRoute properties cannot at the same time be configured in Windows Management Instrumentation (WMI); otherwise, a WMI error is thrown.
- The issues for using a default route to a clearinghouse are as follows:
- Attempting to use automatic discovery at the same time as a default route results in a misconfiguration. It is logged as an error to the event log.
- Attempting to simultaneously use closed enhanced federation or an IM provider and a default route is considered a misconfiguration. If this occurs, a warning appears in the event log. A misconfiguration could lead to unpredictable behavior.
Note: If WMI throws a generic error code, the administrator should find the code's meaning by using lcserror, the command-line tool that shipped with the Microsoft Office Communications Server 2007 R2 Resource Kit.
When an Access Edge Server is configured to act as a clearinghouse or configured to use a default route to a clearinghouse, the administrator won't be able to access the Microsoft Management Console (MMC) property pages on the Access Edge Server by using MMC.
To update partner entries, the administrator has the following options:
If an array of Access Edge Servers is being used, wbemtest or a custom script should be used.
If an array of Access Edge Servers isn't being used, WMI can be used to manually create or edit instances of the MSFT_SIPFederationPartnerTable class.
Summary
This article describes how to configure Office Communications Server 2007 R2 to support a clearinghouse. Keep in mind, however, that these configuration steps are specific to Office Communications Server 2007 R2 and might not work in future releases of Office Communications Server.
Additional Information
For more information, check out the following articles:
Configure Federation at go.microsoft.com/fwlink/?linkid=157767.
Configuring Federation, Remote User Access, and Public IM Connectivity for Individual Users at go.microsoft.com/fwlink/?linkid=150673.
Communications Server Resources
Visit the Communications Server main page at go.microsoft.com/fwlink/?LinkId=132607.
View the complete Communications Server documentation library at go.microsoft.com/fwlink/?LinkId=132106.
Download the Communications Server content as Word documents at go.microsoft.com/fwlink/?LinkId=133609.
Download the Communications Server documentation as a compiled help file at go.microsoft.com/fwlink/?LinkId=160355. (Scroll down to the Additional Information section and download OCSDocumentation.chm.)
Read weekly articles for Communications Server IT professionals on Next Hop at go.microsoft.com/fwlink/?LinkId=181907.
Read Next Hop articles in the Technical Library at go.microsoft.com/fwlink/?LinkId=185344.
Subscribe to Next Hop feeds on the OPML List for Next Hop page at go.microsoft.com/fwlink/?LinkId=185345.
Read weekly articles for Communications Server developers on UCode at go.microsoft.com/fwlink/?LinkId=177892.
Follow tweets from the Communications Server team at go.microsoft.com/fwlink/?LinkId=167909.
We Want to Hear from You
- To give us feedback about this article or to propose a topic for an article, e-mail us at NextHop@microsoft.com.
- You can also send us a tweet at <www.twitter.com/DrRez>.