Sametime Version 8.5.

Welcome to the IBM Sametime Client Yahoo ! Integration Feature

Edition Notice
Note: Before using this information and the product it supports, read the information in "Notices."

This edition applies to version 8.5.2 of IBM Lotus Sametime (program number 5724J23) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2007, 2011. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM Lotus Sametime 8.5.2

Release Notes

___________________________________________________________________________________

Welcome to the IBM Sametime Client Yahoo ! Integration Feature

__________________________________________________________________________________

Introduction
Sametime is making a client-side feature available that will provide the same level of functionality with Yahoo! that the Sametime Gateway currently does. Starting in June, 2011 Sametime users will no longer be able to interact with Yahoo! users through the Sametime Gateway. This guide will walk through the process of adopting the new Yahoo! Integration feature, including installation, configuration, new features, user experience, what to watch out for, etc.

Getting Started
Prerequisites
Personal Yahoo! accounts The client-side Yahoo! Integration feature uses your personal Yahoo! account to log in to Yahoo! and interact (chat, get awareness, etc.) with other Yahoo! users. This is a change from the Sametime Gateway implementation that worked with your Sametime account. To be able to use this new integration, you must have a personal Yahoo! account which you can create for free at: http://www.yahoo.com A supported Sametime client The following Sametime clients support the Yahoo! Integration feature: - Sametime Standalone 8.0.2 - Sametime Standalone 8.5.1 - Sametime Standalone 8.5.2 - Notes 8.5.x with Embedded Sametime Entitlement The Yahoo! Integration feature is not entitled to customers who are running Sametime Entry or have an Instant Messaging Limited Use version of Sametime.

Installation
To take advantage of this new feature, the first step is to get it and install it. Delivery Vehicle

IBM Lotus Sametime 8.5.2

Release Notes

The Yahoo! Integration feature can be installed using either an add-on installer (recommended) or an update site. Separate add-on installers are available per platform for standalone and embedded.
Yahoo Delivery Vehicle Overview Release Yahoo Delivery Vehicle ST 8.x.x sametime.yahoo.addon (1.0.0) Notes 8.5.x sametime.yahoo.embedded.addon (1.0.0) All sametime.yahoo.addon.update.site (1.0.0) Yahoo Kits Kit sametime.yahoo.addon.win32 (1.0.0) sametime.yahoo.addon.macosx (1.0.0) sametime-connect-yahoo-addon.deb (1.0.0) sametime-connect-yahoo-addon.rpm (1.0.0) sametime.yahoo.emb.addon.win32 (1.0.0) sametime.yahoo.emb.addon.macosx (1.0.0) sametime-connect-yahoo-emb-addon.deb (1.0.0) sametime-connect-yahoo-emb-addon.rpm (1.0.0) sametime.yahoo.addon.update.site (1.0.0)

Target Product ST802, ST851, ST852 ST802, ST851, ST852 ST802, ST851, ST852 ST802, ST851, ST852 Notes85X Notes85X Notes85X Notes85X Notes/ST via typical update site processes

Download Download the feature from here:

<Coming Soon when feature is released>

Installation Once you have the appropriate add-on installer for either standalone or embedded, run it to install the Yahoo! Integration feature. To install on Windows, run the setup.exe or setup.msi, for Linux install the RPM (or debian if using Ubuntu), and for Mac, execute the install package. If installing using the update site, use any of the typical methods for installing using an update site: Administrator update site policy, manual install using the installation UI in the client, etc.

Creating the Yahoo ! community

The connection to Yahoo! is now managed through a separate Yahoo! community. Like all other Sametime communities, you create this in the client, enter your Yahoo! credentials, etc. and login to connect to Yahoo!. This is different from the experience with the Sametime Gateway where contact with all external messaging systems was handled through a single Sametime community connected to the Gateway. After installing the Yahoo! Integration feature, start up the client and log into your default Sametime community. Now it's time to create the Yahoo! community: 1.) Go to the menu: File -> New -> Server Community Community action on the buddy list toolbar) 2.) Choose "Yahoo" as the server community type: (or use the New ... Server

IBM Lotus Sametime 8.5.2

Release Notes

3.) Enter your Yahoo! credentials in the user name and password fields. 4.) Optionally choose the options to remember password and automatically log in. 5.) Click OK to complete the process and login to Yahoo! NOTE: The community dialog allows you to specify many other options for a community including host name, connection type, etc. All of these options are not applicable to Yahoo! so although you can set / change these values, they are not used for a Yahoo! community. NOTE: The icon for a Yahoo! community will always be the Yahoo! bang icon: changed. , it cannot be

Logging in to Yahoo! from Sametime Embedded in Notes

Logging into Yahoo! for the first time in Notes using Sametime Embedded will trigger two "Issue Cross Certificate" security dialogs for the subjects: CN=login.yahoo.com/O=Yahoo! Inc.... CN=*.login.yahoo.com/OU=Yahoo! Inc/O=Yahoo! Inc.......

IBM Lotus Sametime 8.5.2 ase Notes

Click "Cross certify" on both of these dialogs to allow the login to Yahoo! to continue. This is not required in Sametime standalone. Administrators - this step can be mitigated by following the process outlined in the Domino Administrator InfoCenter topic: Pushing trusted certificates to Lotus Notes clients which can be found here:

http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domin o.admin85.doc/H_PUSHING_CERTIFICATES_TO_CLIENTS_STEPS.html

Yahoo! contacts and awareness

Now that you've created the Yahoo! community and logged in, you can start working with Yahoo! contacts.

Contact Authorization Process

IBM Lotus Sametime 8.5.2

Release Notes

Unlike in Sametime, you cannot just add a Yahoo! user to your contact list and get awareness on them. Yahoo! users will get a notification (wherever they are logged into Yahoo! or on their next login) that you are requesting to add them to your contact list and they must accept this request before you can see their status or chat with them. This is the same experience that you get in all Yahoo! based clients like Yahoo! Messenger or Yahoo! Mail. This is also the same experience that is in the Sametime Gateway today, but it is important concept to remember to avoid confusion when contacts you add appear offline initially. The new Yahoo! integration feature also provides the ability for you to respond to contact requests from other Yahoo! users. When another user attempts to add you to their contact list, a dialog will display in the Sametime client:

- Clicking Accept will allow the other user to add you to their contact list - Clicking Deny will prevent the other user from adding you to their contact list - Closing this window without choosing Allow or Deny will leave this as a pending request, so the next time you log in to Yahoo!, you will be prompted again. NOTE: In this release we do not provide the ability to block or report abuse, this is being evaluated for a future release. We also do not provide a way to customize the response text.

Import your existing Yahoo ! contact list

An important feature that was added in this integration is the ability to import your existing personal Yahoo! contact list. Taking this action will create a private group in your Sametime buddy list named "Yahoo! Contacts". This private group will get populated with all the contacts from your personal Yahoo! contact list - and because they are already members of your contact list, they have already authorized you so you can instantly see their status and chat with them. 1.) Go to the menu: File -> Import Sametime Contact List -> From Server... 2.) Choose your "Yahoo!" community:

IBM Lotus Sametime 8.5.2

Release Notes

3.) Click OK to import your existing contacts into a "Yahoo! Contacts" private group.

Adding new Yahoo! contacts to the buddy list

To add a new Yahoo! contact to the buddy list, follow the same steps as you would for adding a Sametime contact, but choose the Yahoo! community: 1.) Right-click on a private group and choose Add Contact... from the context menu, or choose the New Sametime Contact... action in the buddy list toolbar. 2.) Select the Yahoo! community in the Add Contact dialog that displays:

3.) Enter a user name (with or without the domain) and click Lookup. 4.) When the result window displays, click Add to add the contact to your buddy list.

IBM Lotus Sametime 8.5.2

Release Notes

5.) The user will display as offline until they approve the request (see Contact Authorization Process above) NOTE: When you add a Yahoo! contact to your Sametime contact list, they will in turn get added to your personal Yahoo! contact list.

Deleting Yahoo! contacts from the buddy list

To delete a new Yahoo! contact from the buddy list, right-click on the user and choose Remove from Sametime Contact List NOTE: When you remove a Yahoo! contact it is the same as removing the contact from your personal Yahoo! contact list (they are inextricably tied together). So removing a Yahoo! user from your Sametime contact list will cause them to be removed from your personal Yahoo! contact list and therefore they will have to accept the authorization request again if you want to ever re-add them.

What about the existing Yahoo ! contacts in my buddy list from the Sametime Gateway ?
Any existing Yahoo! contacts you had in your buddy list from the Sametime Gateway will need to be converted over to the new Yahoo! community. The best way to do this is to delete the contact from the buddy list and re-add them, specifying the new Yahoo! community in the Add Contact dialog as explained in the previous section. Because the request will be coming from your personal Yahoo! account instead of the old Sametime Gateway account, you will likely have to wait until they accept the request before getting awareness unless you already had them in your personal Yahoo! contact list. NOTE: Yahoo! has a low-rate threshold on adding new contacts to your contact list. This is to prevent denial of service attacks and other spam. Developing a utility to convert / add existing Yahoo! Gateway contacts to your personal Yahoo! contact list could very easily reach this threshold and cause a temporary ban. So the recommended approach is to manually remove and re-add these contacts.

Awareness Status Mappings

The Yahoo! Messenger client only has Available, Busy and Invisible statuses, therefore Sametime will handle the differences by mapping statuses: - ST Available - ST Away - ST In Meeting - ST DND - Yahoo Available - Yahoo Busy -> Yahoo Available -> Yahoo Busy -> Yahoo Busy -> Yahoo Busy -> ST Available -> ST Away

Status icons and fonts will display as they do in the Gateway implementation today - all Yahoo! contacts will always have the Yahoo! bang icon (colored when online, greyed when offline) and the contact name font will indicate status.

NOTE: The invisible status for Yahoo! is not supported this release - it is being investigated

IBM Lotus Sametime 8.5.2

Release Notes

for a future Sametime release.

Chat
Sending and receiving instant messages (chatting) with Yahoo! contacts is the same as the current Sametime Gateway implementation, using the same chat windows and experience as regular Sametime chats. The experience will be most like chatting with an external user or with an older pre-7.5 client (because of the restrictions listed below). A couple points to consider: - No rich-text support - No image support including custom emoticons - No file transfer support - No n-way chat support. Yahoo! does not support this in their APIs. They do have the concept of a "conference" with multiple users, but they do not provide client API support for this yet. - Emoticons will be handled exactly as they are with external users today - all clear text. If you choose an emoticon from palette, the clear text version will be sent. If you send or receive an emoticon like :-) the Sametime chat transcript window will display the corresponding Sametime emoticon icon if available. - Chat history will be maintained if enabled.

Known Issues and Limitations

- Sametime requires that the default community for a Sametime client be a Sametime community. While it is not explicitly prevented, having another type of community (such as Yahoo!) as the default is not supported. - Multiple Yahoo! communities in a single Sametime client are not supported. It is not currently prevented, but it will be in the next revision. - The client does not provide the ability to block a user or report abuse - Sametime is not providing the ability to log in as Invisible in this release.

Deployment Considerations
All calls to Yahoo! are done over standard HTTP and HTTPS so ports 80 and 443 must be open.

Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 5 Technology Park Drive Westford Technology Park Westford, MA 01886 Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement

between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights reserved. If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks
These terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: IBM AIX DB2 DB2 Universal Database Domino Domino Domino Designer Domino Directory i5/OS iSeries Lotus Notes OS/400 Sametime System i WebSphere AOL is a registered trademark of AOL LLC in the United States, other countries, or both. AOL Instant Messenger is a trademark of AOL LLC in the United States, other countries, or both. Google Talk is a trademark of Google, Inc, in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Microsoft, and Windows are registered trademarks of Microsoft Corporation in the United States, other countries, or both. Intel and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.