IBM Rational Synergy for Eclipse Interface version 7.2.0.1 readme

IBM Corporation

22 March, 2012

 

 

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

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® XP Professional SP3
    • Windows Vista Enterprise SP2 (32-bit & 64-bit)
    • Windows 7 (32-bit & 64-bit)
    • 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:

  • Eclipse® 3.3.0 32-bit
  • Eclipse® 3.6.0 (Helios) 32-bit
  • IBM® Rational® Application Developer for Websphere® 7.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 Rational Synergy 7.1 or Rational Synergy 7.2.0.2 client.
  • Java® Runtime version 1.6.0 or higher.  Only 32-bit Java runtime environments are supported at this time.
  • One of the following versions of Eclipse based products installed on your computer:
    • Eclipse 3.3.0 32-bit
    • Eclipse 3.6.0 (Helios) 32-bit
    • IBM® Rational® Application Developer V7.5
    • Products containing Eclipse 3.3.0 or Eclipse 3.6.0, such as IBM Rational Software Architect 7.5.
    • Eclipse Mylyn 3.2.x or 3.4.x


Installing IBM Rational Synergy for Eclipse Interface

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:

·         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 integrations\eclipse folder in your Synergy installation.

·         Click OK, then click Finish.

·         Find IBM Rational Synergy for Eclipse Interface 7.2.0.1 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:

·         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 integrations\eclipse folder in your Synergy installation and click OK.

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

·         Find IBM Rational Synergy for Eclipse Interface 7.2.0.1 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

·         Synergy 7.2 is now supported.  Synergy 7.2 has a limitation with multiple simultaneous connections, see the Known problems section for more details.

Known problems

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

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

·         In Synergy 7.1.0.5 the rename functionality using Refactor->Rename throws error in case the rename operation is performed on a resource which is not checkout. Thus to rename a resource using Refactor->Rename option in Synergy 7.1.0.5 the resource needs to be first checked out.

Fixed problems

·         The issue of static sub projects in package explorer has been fixed.

·         The performance of decoration of resources in package explorer has been improved. 

·         The performance of version control operations has been improved. 

·         The null pointer exception while performing move and rename using refactor has been fixed. 

·         The nullpointerexception being thrown, while renaming a resource using Refactor->rename operation has been fixed. 

·         The invalid error message encountered while performing synchronization of modified resources in offline mode has been fixed. 

·         The issue with update members operation not updating version number of resources has been fixed. 

·         The problem with multiple display of synergy connection in RAD has been resolved. 

Contact Support

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

 

Note: If you are a heritage Telelogic customer, a single reference site for all support resources is located at http://www.ibm.com/software/rational/support/telelogic/

 

Prerequisites

 

To submit your problem to IBM Rational Software Support, you must have an active Passport Advantage® software maintenance agreement. Passport Advantage is the IBM comprehensive software licensing and software maintenance (product upgrades and technical support) offering. You can enroll online in Passport Advantage from http://www.ibm.com/software/lotus/passportadvantage/howtoenroll.html

 

·         To learn more about Passport Advantage, visit the Passport Advantage FAQs at http://www.ibm.com/software/lotus/passportadvantage/brochures_faqs_quickguides.html.

·         For further assistance, contact your IBM representative.

 

To submit your problem online (from the IBM Web site) to IBM Rational Software Support, you must additionally:

·         Be a registered user on the IBM Rational Software Support Web site. For details about registering, go to http://www.ibm.com/software/support/.

·         Be listed as an authorized caller in the service request tool.

 

Submitting problems

 

To submit your problem to IBM Rational Software Support:

 

1.        Determine the business impact of your problem. When you report a problem to IBM, you are asked to supply a severity level. Therefore, you need to understand and assess the business impact of the problem that you are reporting.

Use the following table to determine the severity level.

 

Severity

Description

1

The problem has a critical business impact: You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution.

2

This problem has a significant business impact: The program is usable, but it is severely limited.

3

The problem has some business impact: The program is usable, but less significant features (not critical to operations) are unavailable.

4

The problem has minimal business impact: The problem causes little impact on operations or a reasonable circumvention to the problem was implemented.

 

 

2.        Describe your problem and gather background information. When describing a problem to IBM, be as specific as possible. Include all relevant background information so that IBM Rational Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions:

·         What software versions were you running when the problem occurred?
To determine the exact product name and version, use the option applicable to you:

o         Start the IBM Installation Manager and select File > View Installed Packages. Expand a package group and select a package to see the package name and version number.

o         Start your product, and click Help > About to see the offering name and version number.

·         What is your operating system and version number (including any service packs or patches)?

·         Do you have logs, traces, and messages that are related to the problem symptoms?

·         Can you recreate the problem? If so, what steps do you perform to recreate the problem?

·         Did you make any changes to the system? For example, did you make changes to the hardware, operating system, networking software, or other system components?

·         Are you currently using a workaround for the problem? If so, be prepared to describe the workaround when you report the problem.

3.        Submit your problem to IBM Rational Software Support. You can submit your problem to IBM Rational Software Support in the following ways:

·         Online: Go to the IBM Rational Software Support Web site at https://www.ibm.com/software/rational/support/ and in the Rational support task navigator, click Open Service Request. Select the electronic problem reporting tool, and open a Problem Management Record (PMR), describing the problem accurately in your own words.

For more information about opening a service request, go to http://www.ibm.com/software/support/help.html

You can also open an online service request using the IBM Support Assistant. For more information, go to http://www.ibm.com/software/support/isa/faq.html.

 

·         By phone: For the phone number to call in your country or region, go to the IBM directory of worldwide contacts at http://www.ibm.com/planetwide/ and click the name of your country or geographic region.

 

·         Through your IBM Representative: If you cannot access IBM Rational Software Support online or by phone, contact your IBM Representative. If necessary, your IBM Representative can open a service request for you. You can find complete contact information for each country at http://www.ibm.com/planetwide/.


 

Notices

 

© Copyright IBM Corporation 2005, 2012

U.S. Government Users Restricted Rights – Use, duplication, or disclosure restricted by GSA ASP 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 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:

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

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

See copyright notices on the Web at http://www.ibm.com/legal/copytrade.html.

Eclipse is a trademark of the Eclipse Foundation, Inc., in the United States, other countries, or both.

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

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