IBM Rational Synergy for Eclipse Interface version 7.2.0.3 iFix 3 readme

IBM Corporation

December 20th 2016

 

 

This file contains product information and updates to IBM® Rational® Synergy for Eclipse Interface 7.2.0.3 iFix 3

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 you need:

One of the following operating systems installed on your computer:

  • Windows 7 (32-bit & 64-bit)
  • Windows Server 2008
  • Red Hat® Enterprise Linux® 5.0 (32-bit & 64-bit)
  • SUSE Enterprise Linux 11 (32-bit & 64-bit)

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

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

All below mentioned versions are supported only on IBM Java runtime environments.
  • Eclipse® 3.5.2 (Galileo) 32-bit
  • Eclipse® 3.6.0 (Helios) 32-bit
  • Eclipse® 3.7 (Indigo) 32-bit
  • Eclipse® 3.8 32-bit
  • Eclipse® 4.2 (Juno) 32-bit
  • Eclipse® 4.4 (Luna) 32-bit
  • Eclipse® 4.5 (Mars) 32-bit
  • Eclipse® 4.5 (Mars) 64-bit (Currently supported only on Windows platform)
  • IBM® Rational® Application Developer for Websphere® 8.0 and 8.5


Operating system locales supported by IBM Rational Synergy for Eclipse Interface

The IBM Rational Synergy for Eclipse interface is supported in all locales supported by the version of Synergy that it is connected to.

Compatible products

  • IBM® Rational® Synergy : Latest fix packs or IFixes availabe on Rational Synergy 7.1 or Rational Synergy 7.2 client or Rational Synergy 7.2.1 client.
  • Java® Runtime version (IBM Only) 1.6.0. Eclipse 4.5 and later supports Java version 7 or 8.  64 bit runtime environments (IBM Java only) is supported only on Windows.
  • One of the following versions of Eclipse based products installed on your computer:
    • Eclipse 3.5.2 (Galileo) 32-bit
    • Eclipse 3.6.0 (Helios) 32-bit
    • Eclipse 3.7 (Indigo) 32-bit
    • Eclipse 3.8 32-bit
    • Eclipse 4.2 (Juno) 32-bit
    • Eclipse 4.4 (Luna) 32-bit
    • Eclipse 4.5 (Mars) 32-bit
    • Eclipse 4.5 (Mars) 64-bit (Currently supported only on Windows platform)
    • IBM® Rational® Application Developer V8.0 and V8.5
    • Products containing Eclipse 3.5.2 or Eclipse 3.6.0 or Eclipse 3.7 or Eclipse 3.8 or Eclipse 4.2 or Eclipse 4.4 or Eclipse 4.5, such as IBM Rational Software Architect 7.5.


Installing IBM Rational Synergy for Eclipse Interface

Please follow the instructions below

·        Start Eclipse, go to Help->Install New Software.

·        Click Add button on Available Software dialog box.

·        Click Local.

·        Browse to the location where IBM Rational Synergy Eclipse Interface 7.2.0.3 iFix 3 is stored, which is under the integration's folder in Synergy 7.2.1.5 ifix 03.

·        Provide a name to it and click OK.

·        Select the check box for label "Configuration Management".

·        Click Next.

·        Accept the license agreement and click Finish.

·        When prompted to restart Eclipse, click Yes.

Known problems

·        Sometimes the connection status is not shown properly in the Synergy Repository, Synergy Task and Change Request Views. In such cases the views needs to be refreshed manually. 

·        Synergy 7.2 does not allow for multiple simultaneous connections to different databases or servers through the API.  The integration will allow you to create multiple connections but will only allow you to have one connection started at a time.  The integration will automatically connect and disconnect as needed.  If you have more than one Synergy 7.2 connection defined in Eclipse you should start Synergy sessions before you start Eclipse for highest performance.  Starting the sessions before starting Eclipse will allow the Synergy sessions to remain running when the integration disconnects, which will mean that they do not need to be restarted the next time Eclipse uses the connection.

·        Team->Show in History View does not function properly when using Eclipse 3.6 due to a problem with Eclipse plugin compatibility.  The only workaround is to use an earlier or later version of Eclipse.

·       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. To change the database case setting, use the command ccmdb info <DBPATH> -k case -v PRESERVE. You must restart your Synergy server after running this command.

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

·       On RHEL 5 64 bit platform, the interface does not work with 64 bit eclipse. A workaround for this issue is to use Eclipse 32 bit configured to use JRE bundled with Synergy.

·       In the Change Request View, dragging and dropping of a Task onto a Change Request does not associate the task with the change request.

·       Message "Cannot retrieve information from database. com/telelogic/cm/jposix/PosixFile.lstat()Lcom/telelogic/cm/jposix/StatInfo;" is displayed in Eclipse console when the interface turns online and the opened projects have modified resources.

Fixed problems

Details of problems fixed are provided on Fix List Page.

Contact Support

If the self-help resources have not provided a resolution to your problem, you can contact IBM® Software Support. IBM Software Support provides assistance in resolving product issues.

For more details about enrolling in Passport Advantage and submitting problems, see the “Contacting IBM Software Support” topic in the Rational Synergy information center at http://pic.dhe.ibm.com/infocenter/synhelp/v7m2r0/topic/com.ibm.help.common.rational.doc/topics/t_contactingibmsoftwaresupport.html.


 

Notices

 

© Copyright IBM Corporation 2005, 2013

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

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 character set (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.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, 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 are 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 websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites 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
5 Technology Park Drive
Westford, MA  01886
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.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

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.

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

Privacy policy considerations

IBM Software products, including software as a service solutions, (“Software Offerings”) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering’s use of cookies is set forth below.

Depending upon the configurations deployed, this Software Offering may use session cookies that collect personally identifiable information for purposes of session management, authentication, and enhanced user usability. These cookies can be disabled, but disabling them will also likely eliminate the functionality they enable.

If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent.

For more information about the use of various technologies, including cookies, for these purposes, See IBM’s Privacy Policy at http://www.ibm.com/privacy and IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details/us/en sections entitled “Cookies, Web Beacons and Other Technologies” and “Software Products and Software-as-a Service”.

Trademark acknowledgments

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 www.ibm.com/legal/copytrade.shtml.