IBM
Rational Synchronization Server 1.4.0.3 readme |
IBM Corporation |
|
© Copyright IBM Corporation 2006, 2012
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 the IBM Rational® Synchronization Server™ 1.4.0.3
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/.
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.
Rational Change for Focal Point Interface
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 for DOORS Interface
Note: Rational
Focal Point for DOORS Interface is only supported when Rational Synchronization
Server is installed on Windows.
Rational Change for Change Interface
Note: Rational Change for Change Interface does not support use of remote Change databases.
Rational Change for Rational Team Concert Interface
Note: Rational Change for Rational
Team Concert Interface does not support use of remote Change databases.
Rational Change for ClearQuest Interface
Note: Rational Change for ClearQuest Interface does not support use of remote Change
databases.
Note:
If you have Rational Synchronization Server already installed, you must
uninstall it before installing this version. Uninstalling Synchronization
Server will not remove links, templates or log files.
Prior to installation, ensure that you have the following environment variables set correctly:
· JAVA_HOME – path to a Java 6 JDK
OR
· JRE_HOME – path to a Java 6 Runtime Environment
· CATALINA_HOME – path to your Tomcat installation
· DOORSHOME – path to a DOORS client installation. This variable is only required if you will be installing the Rational DOORS for Focal Point Interface.
After you have verified your environment, run the correct binary for your platform. For windows, run sync_server_install.exe.
Note: Do not install the
Synchronization Server on the same Tomcat installation where Focal Point is
installed.
After the installation program initializes, you will be presented with a welcome screen. Click Next to continue.
Next you will be asked to accept the license agreement. Accept the terms and click Next.
You will be asked to choose the type of installation. Choosing Typical will install the Synchronization Server along with the Rational Change for Change Interface, Rational Change for Focal Point Interface, Rational DOORS for Focal Point Interface, Rational Focal Point for Focal Point Interface, Rational Change for Rational Team Concert Interface, and Rational Change for ClearQuest Interface. Choosing Custom will allow you to determine which components you’d like to install. Choosing Minimal will install by default only the Synchronization Server.
The components that will be installed will have a checked checkbox next to the Synchronizer’s name. You may change the components that you want installed by clearing the checkbox next to the name.
Click Next when you are satisfied with the components that will be installed.
Next, you will see a summary of what will be installed. Click Install to continue the installation.
When the installation is complete, you will see a summary dialog. Click Done.
Note: If you are installing
Synchronization Server on Solaris and you wish to use an IBM Java Runtime
Environment (JRE), you must follow these additional steps:
1. Go to $CATALINA_HOME/bin
2. Open setclasspath.sh in a text editor
3.
Find this line: JAVA_ENDORSED_DIRS="$BASEDIR"/common/endorsed
4. Change
the line to: JAVA_ENDORSED_DIRS="$BASEDIR"/common/endorsed:"$JRE_HOME"/lib/endorsed
5. Restart your Tomcat server
To configure the Synchronization Server, you can use the web-based admin interface. You can access the admin interface by pointing your web browser at http://localhost:<port>/TlogicIntegration/admin/SyncFramework.html, where <port> is the port number your Tomcat server is running on. You will be required to login to access the admin interface. Any user that has “administrator” role in Tomcat is valid. Tomcat users are defined in CATALINA_HOME/conf/tomcat-users.xml.
For more details refer to Rational Synchronization Server Help available from the admin interface.
Before uninstalling the integration, you should stop your Tomcat server to ensure that all synchronizers are stopped.
On Windows, open Add/Remove Programs from the Control Panel. Find Rational Synchronization Server and click Remove.
On Linux and Solaris, run the following command: $CATALINA_HOME/webapps/TlogicIntegration/_uninst/Uninstall_IBM_Rational_Synchronization_Server_1.4.x
· 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.
R#41925 Change-RTC sync fails if one of the mapped attributes is of type "time".
R#42523 There is no way to limit the size of synchronizer specific log files.
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.
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
IBM Corporation
North Castle Drive
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
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
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
Linux is a registered trademark of Linus
Torvalds in the
Microsoft, Windows, Windows NT, and the Windows logo are
trademarks of Microsoft Corporation in the
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
Cell Broadband Engine is a trademark of Sony Computer
Entertainment, Inc. in the
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.