IBM
Rational® Synergy for Team Concert
Interface 1.2 Readme |
IBM
Corporation |
|
© Copyright IBM Corporation 2009, 2013
U.S. Government Users Restricted Rights - Use, duplication, or disclosure restricted
by GSA ADP Schedule Contract with IBM Corp.
This file contains
product information and updates to the IBM® Rational®
Synergy for Team Concert Interface 1.2
It is divided into the following sections:
To access the latest
news and information on the Rational Synergy for Team Concert Interface Web
site, go to www.ibm.com/software/rational/support/.
For additional
information about system requirements, including recommended configurations,
visit the Rational Synergy Change Support Web site at http://www-01.ibm.com/software/awdtools/synergy/support/
This version of the interface contains the following components:
o
Rational Synergy for Eclipse Interface. This component can be used to
perform version control operations using Rational Synergy from inside the RTC
Eclipse client.
o Rational Synergy and RTC Bridge. This component can be used to link RTC Work Items to Synergy tasks from within the Rational Synergy client.
o Rational Synergy and RTC Synchronizer. This component can be used to export Synergy Repository Projects to RTC Repository
o
Change
the -vm argument to the location of the IBM JRE 1.6.
o
Set
the -Dosgi.requiredJavaVersion= argument to 1.6.
The
installer for this interface contains two client side components.
IBM
Rational Synergy for Eclipse Interface
Rational
Synergy for Team Concert Interface
Both
of these components need to be installed in the Rational Team Concert Eclipse
Client.
The
installer for the interface contains two server side components.
<CCM_HOME>\integrations\teamconcert\server\ synergylinktype
<CCM_HOME>\integrations\teamconcert\server\SynergyParticipantUpdatesite
Both
of these components need to be installed in the Rational Team Concert server.
1.
The "synergylinktype" component is an
update site with the directory structure as shown below.
synergylinktype
|____features
|
|____com.ibm.rational.synergy.integration.rtcbridge.synergylinktypefeature_2.0.0.jar
|____plugins
|
|____com.ibm.rational.synergy.integration.rtcbridge.synergylinktypeplugin_2.0.0.jar
|____site.xml
2.
The
“SynergyParticipantUpdatesite” component is an update site with the directory
structure as shown below.
SynergyParticipantUpdatesite
|___features
| |____ com.ibm.rational.synergy.integration.rtcbridge.synergyparticipantFeature_1.0.0.<buildnum>.jar
|___plugins
|___
com.ibm.rational.synergy.integration.rtcbridge.synergyparticipant_1.0.0.<buildnum>.jar
|___ com.ibm.rational.synergy.integration.rtcbridge.synergyqueue_1.0.0.<buildnum>.jar
|___com.ibm.rational.synergy.integration.rtcbridge.synergywiadvisor_1.0.0.<buildnum>.jar
|___site.xml
Follow the steps below to
install these server side components -
·
Start Rational Team Concert Server.
· Using a web browser go to the URL http://<RTCServer>:<Port>/ccm/admin/cmd/requestReset. Where RTCServer is the fully qualified name your Rational Team Concert Server and Port is the port. For example https://bob-rtcserver.mydomain.ibm.com:9443/ccm/admin/cmd/requestReset. Login to the server and you will get a message saying "The Jazz Server has been flagged to reset and reload from the configured update-site when it is next restarted".
·
Close the browser and shut down the RTC server.
·
Place the update sites synergylinktype and SynergyParticipantUpdatesite into RTC server
installation directory <RTCinstallDir>\server\conf\ccm\sites
·
Go to <RTCinstallDir>\server\conf\ccm\provision_profiles
·
Copy profile.ini and paste it in the same directory, then rename the
file to synergylinktype-profile.ini
·
Open the synergylinktype-profile.ini
and edit the url and featureid as shown below:
o url=file:ccm/sites/synergylinktype
o featureid=com.ibm.rational.synergy.integration.rtcbridge.synergylinktypefeature
·
Copy profile.ini and paste it in the same directory, then rename the
file to SynergyParticipantUpdatesite-profile.ini
·
Open the SynergyParticipantUpdatesite-profile.ini and edit the url and featureid as
shown below:
o
url=file:ccm/sites/SynergyParticipantUpdatesite
o
featureid=com.ibm.rational.synergy.integration.rtcbridge.synergyparticipantFeature
·
Start RTC server.
Select the Project Area for
which you want to enable this interface and configure it as described below
-
Using RTC Eclipse client connect to the RTC Server.
You must have Admin role for to
perform this process configuration.
·
In the Team Artifact View, select the Project
Area that will be used by this integration
·
Right Click and
select Open
·
Select Operation Behavior in Team
Configuration
·
Click Process Configuration Tab
·
In the list of Operations scroll to the bottom where
you should see Save Work Item (server)
listed
·
Click
the column everyone (default) in the Save Work Item (server) row.
·
Preconditions
actions (xx
available) --- Click Add button to select precondition WorkitemProhibitSave and press OK
·
Follow-up actions (xx
available) -- Click Add button to select follow-up action SynergySaveParticipant and then press OK
·
The
above precondition and follow-up actions will not be available to configure, if
the Server-side Plug-ins are not installed correctly.
·
IBM
Rational Synergy for Rational Team Concert Bridge Connector
o
Part-1:
https://jazz.net/library/article/1402
o
Part-2:
https://jazz.net/library/article/1403
This version of the
interface has following known problems or the limited support:
Rational Synergy and RTC Bridge:
Rational Synergy and RTC Synchronizer:
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 2009, 2013.
This information was developed for products and
services offered in the
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
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
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
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
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.
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.
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”.
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.