IBM Rational Synergy for Eclipse Interface version 4.2.0 readme

IBM Corporation
12 January, 2011

 

 

© Copyright IBM Corporation 2005, 2009
U.S. Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This file contains last-minute product information and updates to IBM® Rational® Synergy for Eclipse Interface 4.2.0.

It is divided into the following sections:

For the latest news and information on IBM Rational Synergy for Eclipse Interface, visit the website at http://www.ibm.com/software/rational/support/.


System Requirements

To run IBM Rational Synergy for Eclipse Interface 4.2.0 you need:

  • One of the following operating systems installed on your computer:
    • Windows® XP SP3
    • Windows Vista Enterprise SP1
    • Red Hat® Enterprise Linux® Server 4.0 or 5.0

For additional information on system requirements, including recommended configurations, visit the Rational Support Web site at: http://www.ibm.com/software/awdtools/

At the time of writing, the third party products tested with IBM Rational Synergy for Eclipse Interface 4.2.0 are:

  • Eclipse® 3.3.0
  • Eclipse® 3.4.0
  • IBM® Rational® Application Developer for Websphere® 7.5
  • Mylyn 3.0


Operating system locales supported by IBM Rational Synergy for Eclipse Interface 4.2.0

The IBM Rational Synergy for Eclipse interface is supported in the following Windows locales: Japanese, Korean, PRC/Simplified/GBK Chinese, Traditional/Big-5 Chinese, and C. IBM supports use in any locale using the Latin-1 character set or the Windows extension CP 1252; however, such locales have not been tested.

Compatible products

  • IBM® Rational® Synergy 6.5SP2, Rational Synergy 6.6a, Rational Synergy 7.0, Rational Synergy 7.1, or Rational Synergy 7.1a client installed on your computer.
  • Java® Runtime version 1.6.0 or higher
  • One of the following versions of Eclipse based products installed on your computer:
    • Eclipse 3.3.0
    • Eclipse 3.4.0
    • Eclipse 3.5.0
    • IBM® Rational® Application Developer V7.5
    • Products containing Eclipse 3.3.0, Eclipse 3.4.0, or Eclipse 3.5.0 such as IBM Rational Software Architect 7.5.


Installing IBM Rational Synergy for Eclipse Interface 4.2.0

There are two methods for installing the integration, depending on which version of Eclipse you have installed.  Please choose one method and follow the instructions below:

 

For Eclipse versions prior to 3.4:

·         Download the IBM Rational Synergy for Eclipse Interface 4.2.0. The integration is available in the form of a zip file eclipse330_420.ZIP.

·         Unzip the zip file to a temporary directory.

·         Start Eclipse, go to Help->Software Updates->Find and Install…

·         Choose Search for new features to install and click Next.

·         In the Eclipse Update Manager, click New Local Site and browse to the temporary directory where you unzipped the files.

·         Click OK, then click Finish.

·         Find IBM Rational Synergy for Eclipse Interface 4.2.0 in the list of available features and click the checkbox next to it.

·         Click Next.

·         Accept the license agreement and click Next.

·         Click Finish.

·         Click Install All.

·         When prompted to restart Eclipse, click Yes.

 

For Eclipse versions 3.4 and later:

·         Download the IBM Rational Synergy for Eclipse Interface 4.2.0. The integration is available in the form of a zip file.

·         Unzip the zip file to a temporary directory.

·         Start Eclipse, go to Help->Software Updates.

·         Click on the Available Software tab and click Add Site.

·         In the Add Site dialog box, click Local.

·         Browse to the temporary directory where you unzipped the files and click OK.

·         Select the checkbox next to the newly added site and click Install.

·         Find IBM Rational Synergy for Eclipse Interface 4.2.0 in the list of available features and click the checkbox next to it.

·         Click Next.

·         Accept the license agreement and click Finish.

·         When prompted to restart Eclipse, click Yes.

 

What's new in version 4.2.0

·         Synergy 7.1 is now supported.

 

Known problems

·        On Linux machines, the username in the Synergy Connection information must match the name of the user that is logged into Linux.

·        The Synergy database must be set to preserve case. Modify the file dbmode.inf to change the settings. It should read as CASE=PRESERVE. This file may be located in <DRIVE>ccmdb\base64\db\dbmode.inf, depending on where the database was unpacked.

·        In Eclipse, the File Content preference page from the Team menu is not applicable to this integration.

·        The IDE may freeze if any Team operation is performed immediately after stopping the Synergy Connection. To avoid this situation, you should wait a few moments and let the Connection stop completely before you start it again.

·        The IDE is not refreshed to show file/folder status when a non default task is completed from Eclipse IDE.

·        The Add Uncontrolled Files/Sync operations do not consider ignored patterns if they contain following characters:

| / \ : " <

·        The Add Uncontrolled Files/Sync operations do not consider ignored patterns if they contain following characters:

;  , These characters are used by Synergy internally while performing these operations.

·        Projects connected to Synergy using integration versions prior to 3.2 will not be recognized by this version of interface. You should Team export all the connected projects using previous version of the Integration and then Team import them back after this version of the interface is installed.

·        Importing a project from the file system that was previously shared with Synergy under another shared project is not supported. Doing so may prevent you from performing Synergy operations to the imported project.

·        Task and Repository View expanded states may be lost after upgrading to 4.0 from a previous version. Connection information will not be lost.

·        When viewing a Synergy task in the Mylyn task editor, double-clicking on a task’s attachment will result in a “URL Could not be opened” error. To access an attachment’s contents, right-click on the attachment and select “Save…” from the context menu to save it to the local machine.

Contact Support

Please visit our Telelogic support overview site at: http://www.ibm.com/software/rational/support/telelogic/
You will find a one-sheet reference guide about how to best contact support


 

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 written license inquiries to:

IBM Director of Licensing
IBM Corporation
North Castle Drive

Armonk, NY 10504-1785
U.S.A.


For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send written inquiries to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, 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:

Intellectual Property Dept. for Rational Software
IBM Corporation
1 Rogers Street
Cambridge, Massachusetts 02142
U.S.A.

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 document 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.

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.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copy and Trademark information at www.ibm.com/legal/copytrade.html.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office

UNIX is a registered trademark of The Open Group in the United States and other countries.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product or service names may be trademarks or service marks of others.