Академический Документы
Профессиональный Документы
Культура Документы
December 2009
Document Version 1.8
Copyright Notice
Copyright© 2009 BroadSoft, Inc.
All rights reserved.
Any technical documentation that is made available by BroadSoft, Inc. is proprietary and
confidential and is considered the copyrighted work of BroadSoft, Inc.
This publication is for distribution under BroadSoft non-disclosure agreement only.
No part of this publication may be duplicated without the express written permission of
BroadSoft, Inc. 220 Perry Parkway, Gaithersburg, MD 20877.
BroadSoft reserves the right to make changes without prior notice.
Trademarks
BroadWorks® and BroadWorks Assistant–Enterprise™, BroadWorks Call Center™,
BroadWorks Communicator™, BroadWorks Receptionist™, and BroadWorks
Deployment Studio™ are trademarks of BroadSoft, Inc.
Microsoft, MSN, Windows, and the Windows logo are registered trademarks of Microsoft
Corporation. Other product names mentioned in this document may be trademarks or
registered trademarks of their respective companies and are hereby acknowledged.
This document is printed in the United States of America.
1.1 Initial version for Microsoft OCS 2007 Release 14.sp7 testing.
1.7 Added Acme Packet SBC configuration instructions for domain mapping between OCS and BroadWorks
when OCS domain does not match the BroadWorks user domain.
1 Overview.......................................................................................................................................... 6
4 BroadWorks Configuration.........................................................................................................14
4.1 BroadWorks UC-Connect Configuration .................................................................................. 14
4.1.1 BroadWorks XSP System CLI Configuration.................................................................. 14
4.1.2 BroadWorks UC-Connect CAP CLI Configuration ......................................................... 14
4.2 BroadWorks Application Server Configuration ........................................................................ 15
4.2.1 BroadWorks Application Server CLI Configuration......................................................... 15
4.2.2 BroadWorks Application Server CLI Configuration Example ......................................... 15
4.2.3 BroadWorks Application Server User Configuration ...................................................... 15
5 Microsoft OCS 2007 RCC Configuration ..................................................................................17
5.1 Microsoft OCS 2007 User Configuration.................................................................................. 18
5.2 Microsoft OCS 2007 Route Configuration................................................................................ 19
5.3 Microsoft OCS 2007 Authenticated Host Configuration .......................................................... 20
5.4 Microsoft OCS 2007 OCS Front End Server Transport Configuration................................... 21
6 Solution for Non-Matching User IDs .........................................................................................22
6.1 Option 1: Modify the BroadWorks User ID .............................................................................. 22
6.2 Option 2: Use Acme Packet to Map between User IDs ......................................................... 22
6.2.1 Many-to-One Domain Mapping ....................................................................................... 22
6.2.2 One-to-One Domain Mapping ......................................................................................... 27
References .............................................................................................................................................29
This document describes the configuration procedures required for the Microsoft Office
Communications Server (OCS) 2007 to be interoperable with BroadWorks.
The integrated solution allows the Microsoft Office Communicator (OC) client to perform
remote call control of office phones registered with BroadWorks.
Microsoft OCS can be deployed as a premise-based or hosted solution. Hosted OCS is a
component of Microsoft Hosted Messaging and Collaboration (HMC 4.5) solution. The
configuration description provided in this document applies to both the premise-based and
hosted deployment models.
It is assumed that Microsoft OCS 2007 and BroadWorks are already installed and working
independently. This document describes only the configuration required to link these
components as a solution. Build-up of the individual components is outside the scope of
this document.
This guide describes the specific configuration items that are important for use with
BroadWorks. It does not describe the purpose and use of all Microsoft OCS configuration
items. For those details, see the Microsoft® Office Communications Server 2007
Administration Guide [1].
This section provides the known interoperability status of the Microsoft OCS 2007 with
BroadWorks. This includes the version(s) tested and known issues.
Interoperability testing validates that the device interfaces properly with BroadWorks via
the SIP interface. Qualitative aspects of the device or device capabilities not affecting the
SIP interface such as display features and performance are not covered by interoperability
testing. Requests for information and/or issues regarding these aspects should be
directed to Microsoft.
NOTE: Interoperability testing is normally performed with the latest generally available (GA)
device firmware/software and the latest GA BroadWorks release and service pack at the time the
testing occurs. If there is a need to use a non-verified mix of BroadWorks and device software
versions, customers can mitigate their risk by self-testing the combination using the BroadWorks
Microsoft Office Communicator 2007 RCC Interoperability Test Plan [6].
Intergroup Yes
PSTN Yes
Intergroup Yes
PSTN Yes
PSTN Yes
PSTN Yes
Operator Yes
International Yes
Smart Tag NT
Outlook NT
Intergroup Yes
PSTN Yes
The following table provides a description of each issue and, where possible, identifies a
workaround. The verified partner device versions are listed with an “X” indicating that the
issue occurs in the specific release. The issues identified are device deficiencies or bugs,
so typically not BroadWorks release dependent.
The Issue Number is a BroadSoft ExtraView partner issue number if the testing was
performed by BroadSoft. If the testing was performed by the partner or a third party, the
partner may or may not supply a tracking number.
For more information on any issues related to the particular partner device release, see
the partner release notes.
OCS 2007
EV 69845 Three-Way Conference fails, resulting in the conferenced X
party ending up on hold.
In Three-Way Conference scenarios where the phone controls
and mixes the conference locally, the original called party ends
up on hold when the Three-Way Conference should be active. In
this scenario, the Microsoft OC client is requested to display two
active calls, which it does not support, so it automatically puts the
first call on hold.
Workaround: Configure the phone for network conference. In
this configuration, BroadWorks mixes the conference.
The solution diagram in Figure 1 shows the test environment of the integrated
components: Microsoft OCS 2007 and BroadWorks. The Microsoft OCS server in the
diagram represents either the hosted HMC 4.5 or premise-based OCS solutions. Note
that the desk phone in the following solution diagram would normally be behind an SBC in
a deployed scenario, but that interface has been omitted from the diagram.
The solution message flow is explained as follows. For remote call control performed by
Mike using his Microsoft Office Communicator client, a CSTA message is generated and
sent over SIP by OCS to the CSTA gateway. The UC-Connect application on the
BroadWorks XSP performs the CSTA gateway function which converts the CSTA
message to CAP; BroadWorks then performs the requested function, for example, alerting
Mike’s desk phone.
Likewise, when Mike receives a call, BroadWorks generates a CAP message indicating
an incoming call and sends it to the UC-Connect server. The UC-Connect server converts
the CAP message to CSTA over SIP and sends the message to OCS, resulting in a pop-
up toast on Mike’s computer for the incoming call.
The BroadWorks XSP can optionally be fronted by the Acme Packet SD for TLS
termination and/or NAT traversal. The TLS and NAT Traversal configuration are outside
the scope of this document. Refer to the Acme Packet Net-Net® Session Director
Configuration Guide [8] and the BroadSoft Partner Configuration Guide Acme Packet Net-
Net® Session Director [9] for SD configuration detail. Note that each CSTA session
traversing the Acme Packet SD consumes a SD session license.
The following sections describe how to configure the solution components to enable this
configuration. Note that it is assumed that Microsoft OCS 2007 and BroadWorks are
already installed, configured, and working independently as those configuration details are
not provided here.
This section identifies the BroadWorks configuration required to integrate Microsoft OCS
2007 for third-party call control. A detailed description for enabling BroadWorks for third-
party call control can be obtained from the BroadWorks External Portal Integration Guide
[7]. This configuration is not unique to the Microsoft OCS 2007 integration, but is provided
here for completeness.
Step 2 Add BroadWorks XSP address(es). Add each BroadWorks XSP Server
address to the external authentication
AS_CLI/System/NetworkAccessLists table to allow CAP logins from the
/ExtAuth> add <bw-xsp-address> XSP to bypass authentication.
UC-Connect
Microsoft OCS 2007 RCC is configured through Windows Administration Tools. The
following configuration example is based upon an installation of Microsoft OCS 2007
Standard Edition, referred to as OCS in the following sections.
The capabilities of the OCS RCC have been verified for use with BroadWorks based on
the settings described in the following section. For more information on the meaning,
purpose, and applicability of the individual configuration items see the Microsoft® Office
Communications Server 2007 Enterprise Voice Planning and Deployment Guide [2].
In this section, CSTA Gateway refers to the BroadWorks UC-Connect server.
Figure 7 Microsoft OCS 2007 OCS Front End Server Transport Configuration
The configuration described throughout this document requires the BroadWorks User ID
and MOC Sign-In address to match. This section identifies solution configuration options
when they do not.
cbillings@company1.com cbillings@service-provider.com
swu@company2.com swu@service-provider.com
agonzales@company3.com agonzales@service-provider.com
The many-to-one domain mapping scenario may also require mapping the OCS
username to the user’s number, if the BroadWorks user ID is created as phone-
number@domain, as shown in the following table.
Many-to-One Domain Map with Username to Number Map
cbillings@company1.com 18134441000@service-provider.com
swu@company2.com 16973331000@service-provider.com
agonzales@company3.com 17552221000@service-provider.com
sip-manipulation
name toUC-Connect
description OCS ==> Acme ==> UC-Connect
header-rule
name toURI
header-name To
action store
comparison-type pattern-rule
match-value [0-9]{11}
msg-type request
new-value
methods
header-rule
name frURI
header-name From
action manipulate
comparison-type case-sensitive
match-value
msg-type request
new-value
methods
element-rule
name origOcsUser
parameter-name
type uri-user
action store
match-val-type any
comparison-type case-sensitive
match-value
new-value
element-rule
name origOcsHost
parameter-name
type uri-host
action store
match-val-type any
comparison-type case-sensitive
match-value
new-value
element-rule
name imsUser
parameter-name
type uri-user
action replace
match-val-type any
comparison-type case-sensitive
match-value
new-value $toURI.$0
element-rule
name imsHost
parameter-name
type uri-host
action replace
match-val-type any
comparison-type case-sensitive
match-value
new-value ims.com
header-rule
name AddOcsOrigUri
header-name Contact
action manipulate
INFO
sip:12403331005@64.215.212.80:5060;opaque=user:epid:IKBNv8UyJlegSCoHEcarNgA
A;gruu;ocsOrigUser=fwei;ocsOrigHost=broadsoftuc.com;transport=tcp SIP/2.0
sip-manipulation
name toOCS
description UC-Connect ==> Acme ==> OCS
header-rule
name RURI
header-name request-uri
action manipulate
comparison-type case-sensitive
match-value
msg-type request
new-value
methods
element-rule
name origOcsUser
parameter-name ocsOrigUser
type uri-param
action store
match-val-type any
comparison-type case-sensitive
match-value
new-value
element-rule
name origOcsHost
parameter-name ocsOrigHost
type uri-param
action store
match-val-type any
comparison-type case-sensitive
match-value
new-value
element-rule
name ruriUser
parameter-name
type uri-user
action replace
match-val-type any
comparison-type boolean
match-value $RURI.$origOcsUser
new-value $RURI.$origOcsUser.$0
element-rule
name ruriHost
parameter-name
type uri-host
action replace
match-val-type any
comparison-type boolean
match-value $RURI.$origOcsHost
new-value $RURI.$origOcsHost.$0
element-rule
name delOcsOrigUser
parameter-name ocsOrigUser
type uri-param
action delete-element
match-val-type any
comparison-type case-sensitive
match-value
cbillings@company1.com cbillings@enterprise1.com
tjones@company1.com tjones@enterprise1.com
swu@company2.com swu@enterprise2.com
agonzales@company3.com agonzales@enterprise3.com
cbillings@company1.com chadb@enterprise1.com
tjones@company1.com terryj@enterprise8..com
swu@company2.com suew@enterprise4.com
agonzales@company3.com albertog@enterprise3.com
[1] Microsoft, Inc. July, 2007. Microsoft® Office Communications Server 2007
Administration Guide. Available from Microsoft at www.microsoft.com.
[2] Microsoft, Inc. July, 2007. Microsoft® Office Communications Server 2007 Enterprise
Voice Planning and Deployment Guide. Available from Microsoft at
www.microsoft.com.
[3] Microsoft, Inc. October, 2007. PBX Telephony Features (CSTA/RCC) Specification
for Microsoft Office Communicator 2007. Available from Microsoft at
www.microsoft.com.
[4] Microsoft, Inc. July, 2007. Integrating Telephony with Office Communications Server
2007. Available from Microsoft at www.microsoft.com.
[7] BroadSoft, Inc. BroadWorks External Portal Integration Guide, Release 15.0.
Available from BroadSoft at www.broadsoft.com/xchange.
[8] Acme Packet, Inc. February, 2008. Acme Packet Net-Net® Session Director
Configuration Guide, Release Version 5.1. Available from Acme Packet at
www.acmepacket.com.
[9] BroadSoft, Inc. BroadSoft Partner Configuration Guide Acme Packet Net-Net®
Session Director. Available from BroadSoft at www.broadsoft.com/xchange.