IBM Rational Synchronization Server 1.4.0.2 readme

IBM Corporation
October 17, 2011

 

 

This file contains last-minute product information and updates to the IBM Rational® Synchronization Server™ 1.4.0.2

It is divided into the following sections:

For the latest news and information on Rational Synchronization Server, visit the Web site at http://www.ibm.com/software/rational/support/.


System requirements

To run Rational Synchronization Server 1.4.0.2, you need:

  • One of the following operating systems installed on your computer:
    • Windows® 2003
    • Windows XP Pro SP3
    • Windows Vista Enterprise SP1
    • Redhat Linux Enterprise 5.0
    • Solaris 10
  • One of the following Web browsers:
    • Internet Explorer® 7 or 8
    • Firefox® 2.0
  • JAVA™ 6.

At the time of writing, the third party products tested with Rational Synchronization Server 1.4.0.2 are:

  • Apache Tomcat™ 5.5.x and 6.0.x – 32-bit only if using the Change-ClearQuest synchronizer
  • Java runtime environment (JRE) 6.0

Operating system locales supported by Rational Synchronization Server 1.4.0.2

The Rational Synchronization Server is certified only in the following locales:

·         Japanese

·         Korean

·         PRC/Simplified/GBK Chinese

·         Traditional/Big-5 Chinese

·         Chinese

·         Taiwanese

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

Rational Change for Focal Point Interface

  • Rational® Focal Point™ 6.3, 6.4, and 6.5.0.x
  • Telelogic® Change™ 5.1
  • Rational® Change™ 5.2 and 5.3

Note: Rational Change for Focal Point Interface does not support use of remote Change databases.

Rational Focal Point for Focal Point Interface

  • Rational® Focal Point 6.3, 6.4, and 6.5.0.x

Rational Focal Point for DOORS Interface

  • Rational® Focal Point 6.2, 6.3, 6.4, and 6.5.0.x
  • Rational® DOORS® 9.0, 9.1, and 9.2

Note: Rational Focal Point for DOORS Interface is only supported when Rational Synchronization Server is installed on Windows.

Rational Change for Change Interface

  • Telelogic® Change™ 5.1
  • Rational® Change™ 5.2 and 5.3

Note: Rational Change for Change Interface does not support use of remote Change databases.

Rational Change for Rational Team Concert Interface

  • Telelogic® Change™ 5.1
  • Rational® Change™ 5.2 and 5.3
  • Rational® Team Concert 3.0.1

Note: Rational Change for Rational Team Concert Interface does not support use of remote Change databases.

Rational Change for ClearQuest Interface

  • Telelogic® Change™ 5.1
  • Rational® Change™ 5.2 and 5.3
  • Rational® ClearQuest 7.1.x

Note: Rational Change for ClearQuest Interface does not support use of remote Change databases.

Installing Rational Synchronization Server

See the Rational Synchronization Server help document for information on installing the software.

Obtaining a license for Rational Synchronization Server

No license is required to use Rational Synchronization Server.

Problems Fixed 

·         PM49096 (R41487): Uppercase state ID after mapping causes sync failures

·         PM49098 (R41488): Having a state label in Change that contains parenthesis causes issues during mapping in sync server

·         PM49100 (R41491): The RTC Planned For attribute cannot be set properly during sync

·         PM49101 (R41493): Tomcat does not exit cleanly on linux when sync server is installed

·         PM49104 (R41494): NullPointerException happens in ChangeGenericSync when login to Change fails

·         PM49147 (R41503): RTC has 32K limit on attributes and comments which breaks sync

·         PM49148 (R41504): CR comments don't get migrated if CR matches migrate query after first sync

·         PM49149 (R41505): Sync stops working due to file handles being left open

·         PM49151 (R41506): There is no way to refresh the attribute lists in the Change-RTC synchronizer UI

·         PM49153 (R41507): Attribute lists in the Change-RTC synchronizer UI are not updated when you change project area

·         R41502: Sync server Start button can timeout and make the UI non-responsive

·         R41186: Change-RTC synchronizer UI does not let users select preferred Change database

·         R41492: CATALINA_HOME environment variable should not be hardcoded inside Sync Server

·         R41443: Link file is shown under link name column on the synchronization server

Rational Synchronization Server 1.4.0.2 also includes all fixes from Rational Synchronization Server 1.4.0.1:

  • R33492: Change-FP- Drop down boxes appear bigger in size
  • R33497: Change-FP- No Alert Message for invalid FP connection details
  • R33696: 2 different error messages appearing when attempting to an empty URL Change server
  • R33698: The 'Map' button remains active even if no RTC attribute is available in the listbox
  • R33740: Incorrect info in the help document about the retention of the xml files when a synchronizer is deleted
  • R33736: Change-RTC : The State mapping must mention that the default submit states are being used for creating Work Item as well.
  • R33735: The attributes shouldn't be removed from the list of available attributes once they have been mapped.
  • R33742: CR's attribute overwrites WI's mapped attribute when WI's attribute value was changed last and another attribute mapping direction has been set to ’changetoadapter'
  • R33761: The installer name is "sync_server_install" whereas it has been documented as “setupwin32”
  • R33785: Sync fails when sync interval is not set
  • R39603: Change-RTC – CRs are not getting migrated from Change to RTC Server
  • R40126: Uninstallation steps for uninstalling sync server on Unix are not documented in the sync server help
  • R40428: Change-ClearQuest – Cannot connect to CQ server from Synchronization Server
  • R40305: URL with incorrect syntax is able to open the sync server login interface
  • R40418: Multiple attachments of same file are synchronized from Change to ClearQuest multiple times.
  • PM01574 (R38018): DOORS_HOME in the installation guide should be changed to DOORSHOME
  • PM36851 (R40308): Rational Synchronization Server to RTC integration does NOT support custom enumeration
  • PM36852 (R40309): Rational Synchronization Server to RTC integration only supports RTC workitem

 

  • Synchronizer picks wrong CR if there are several Crs with same number but different dcm delimiters.
  • Fix the condition when sync fails because of no comments were supplied.
  • Update the comment sync feature to sync comments without state change. Capture the comments passed during WaitingInfo. In this mode, the state of the CR is not changed.
  • Synchronize transition log comment
  • Add feature to prevent circular state transitions
  • Fix for sync un-mapped state. It should not cause sync to fail
  • Fix for synchronizing attributes that have sync direction changetoadapter.
  • Increase timeout to 2 minutes when calling Change API
  • Add feature to prevent double sync state transitions
  • Add feature to Change-Change adapter to preserve changes made to CR during sync
  • Add feature to GenericChangeSync to preserve changes made to CRs during sync
  • Add feature to CQ adapter to preserve changes made to CQ Records during sync
  • Change the CCS to pass all mapped attributes when submitting Crs during migrate
  • Fix the CCS problem of synchronizing null attributes
  • Modify GenericChangeSynchronizer to handle out of memory errors coming from adapter
  • Create synchronization direction persistency in case of tomcat shutdown in the middle of sync
  • Improve sync performance by fetching record mapped attribute values on modified sync query
  • Ensure that mappings labeled adaptertochange are never considered for updating the adapter side
  • Remove warning if CR attribute doesn't have an adapter mapping

 


Known problems

·         If you install additional Synchronizers or uninstall any of the installed Synchronizers, Rational Synchronization Server may not display the pages properly unless you restart your Tomcat server.

·         If you make any modifications to the Rational Change or Adapter server, you may need to restart your Tomcat server in order for Rational Synchronization Server to reflect those changes.

·         If you update any of the Synchronizer options (Sync Time Interval, Time Unit, or Server Startup) for a sync process, the sync process may not pick up any modifications unless the sync process is stopped and restarted.

·         After starting the Rational Change server, you must login to Rational Change at least once before attempting to synchronize or create a template using the Rational Focal Point for Rational Change Synchronizer.

·         Some drop-down lists in Rational Change for Change Interface may not display correctly in Internet Explorer 6.0 after navigating to another section and coming back to the page.  The page can be refreshed by clicking the appropriate page link in the left-hand navigation section.

·         If you delete an attachment, the Rational Change for Change Interface will re-attach it unless you delete it from both Change Requests.

·         If you delete an attachment, the Rational Focal Point for Change Interface will re-attach it unless you delete it from both Change Request and Element.

·         The Rational DOORS for Focal Point Interface requires that the Rational DOORS server, the Rational Focal Point server, and the Rational Synchronization Server be located in the same time zone.

·         Asian characters cannot be used in the name of a link in the Rational DOORS for Focal Point Interface.

·         When Starting or Stopping a Synchronizer from the Start/Stop page, the Status may not get updated.  When this happens, click on the Refresh button to update the Status displayed on the page.

·         The Rational Change for ClearQuest Interface limits the number of records that can be migrated at a time from Rational ClearQuest to Rational Change to 50. It also limits the number of change requests that can be migrated at a time from Rational Change to Rational ClearQuest to  50.

Contacting 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 in you geography.


 

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 or registered trademarks of Oracle and/or its affiliates.

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