How to connect OSO LX/MX V3 with Microsoft Lync

How To | How to collection and tutorials for OpenScape Office MX/LX



Preface
This How To describes the connection of OpenScape Office and Microsoft Lync in order to:


 * Exchange presence status and instant messages between OpenScape Office myPortal and Lync Office Communicator users (UC Federation).

It is written on base of OSO version V3R3. Deviations may occur, if higher versions of OSO are used. Within this How the focus is laid on OpenScape Office capabilities and related settings.

All data shown here and also the screenshots are examples only, which are used to demonstrate the capabilities.

UC Federation
Before you start to establish the UC federation link, you have to check some prerequisites otherwise the connection fails.

HW Prerequisites
OSO HW depends on used OpenScape Office plattform, no additional PC HW is required.

Lync HW, depends on customer demands, for further information use Microsoft documentation.

SW Prerequisites
In order to exchange presence status and instant messaging XMPP protocol is required on both sides


 * XMPP Server within OpenScape Office LX / MX / HX from V3R3 on
 * Microsoft Lync with XMPP Gateway, for further information use Microsoft documentation

License Prerequisites
Within OSO Within Lync
 * OSO base license package, no additional licenses
 * See Microsoft documentation for correct licensing.

Instant Messaging
The “built in” XMPP server of OpenScape Office can be connected to the XMPP Gateway of Microsoft Lync. This enables the user of myPortal and Office Communicator to chat with each other.

Subscription for IM
Subscription message for Instant Messaging is done automatically by my Portal at the moment, when an IM is sent out. In case that Office Communicaor is active and my Portal is stated the first time a subscription request is sent out be Lync XMPP Gateway which has to be confirmed by myPortal user. Subscription status of an Instant Messaging contact can by checked e.g. within the myPortal Favorites list by right mouse click to the desired contact. If contact is not subscribed for IM. Subscription can be directly out of the dialogbox.



Presence status
The “built in” XMPP server of OpenScape Office can be connected to the XMPP Gateway of Microsoft Lync. This enables the user of myPortal and Office Communicator to exchange and display presence status.

Mapping of Presence Status
XMPP protocol is able to transmit presence status. It differentiates up to four different statuses.



As MyPortal and Office Communicator support more than 4 statuses a status mapping between client status and XMPP status mapping is done within each system. XMPP supports transfer of additional text (note) to provide more information about the transferred status. The text, which is used, depends on the specific XMPP client or system.

Within the following the overall mapping between OSO myPortal status and Lync Office Communicator status and related text is show.

Mapping of OSO myPortal status to Lync Office Communicator status
OpenScape Office transmits additional status related text via XMPP to Lync. The text is either added automatically as it is bound fix to a status or entered individually by the user of myPortal.



Mapping of Lync Office Communicator status to OSO myPortal status
Display of the Presence Status of a Lync Communicator user is updated earliest in myPortal after status has been changed once within Lync Communicator. The note / text which can be entered with the Communicator to provide more information about the status is not transferred via the Lync XMPP Gateway to Open Scape Office myPortal.



OSO settings for Instant Messaging and presence
In following examples it is assumed that

OSO XMPP server is located within the domain:  mydomain.com

Lync XMPP Gateway is located within the domain: msocfcom.pdb

OSO System
XMPP server has to be enabled configured properly within the OpenScape Office:

Therfore enter Admin Portal --> Expert Mode --> Web Services –-> XMPP

On the XMPP settings page, the domain name of the OpenScape Office system and the XMPP server name, which should always be identical to the OpenScape Office system name, have to be entered.It is mandatory that this domain name can be resolved by the MS Lync XMPP gateway server. If the connection is not local, but via internet, this can be ensured by using the OSO DYNDNS service.



Within OSO XMPP Settings, “Secure Connections” has to be disabled. This flag is availble since OpenScape Office V3R3. Older OSO versions are not compatible to MS Lync!

myPortal Settings
Within myPortal a contact with a valid Lync XMPP address has to be entered in the personal myPortal directory or has to be imported into the external directory by system adminsitrator.

e.g. rodman@msofcom.pdb



In case that you are using myPortal for outlook ypu have to choose the default IM address for the Lync User within the Favorite list in addition



Instant Messaging and Presence Prerequisites •	OSO V3R3 with myPortal or myPortal for Outlook •	Microsoft Lync with XMPP Gateway

OpenScape Office settings System •	OSO System is connected to the internet and addressable by a full qualified domain name •	XMPP Server is active •	XMPP Domain Name is configured

MyPortal A contact with a valid Lync XMPP address is entered within the myPortal directory e.g. rodman@msofcom.pdb

Set the default IM address for the Lync User within the Favorite list (myPortal for Outlook only)

Lync XMPP gateway Settings




Within the following XMPP configuration dialog the radio button “TCP dialback” has to be selcted !!