IBM
Rational® Change for Eclipse Interface and
Rational Change for Subversion Interface 1.1 Readme |
IBM Corporation |
|
© Copyright IBM Corporation 2008, 2010
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®
Change for Eclipse Interface and Rational Change for Subversion
Interface 1.1.0
It is divided into the following sections:
To access the latest news and
information on the Rational Change for Eclipse Interface and Rational Change for Subversion
Interface 1.1.0 Web site, go to www.ibm.com/software/rational/support/.
Client Side:
For additional information about
system requirements, including recommended configurations, visit the Rational
Change Support
Web site at http://www-01.ibm.com/software/awdtools/change/support/
The Rational Change for Eclipse Interface and Rational Change for Subversion Interface 1.1.0 is certified only in the following locales:
Japanese, Korean, PRC/Simplified/GBK Chinese, Traditional/Big-5 Chinese, and C. 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.
1.
Subversion
repository is running and the user of this integration has Subversion
repository access.
2.
WebSVN is working as your Subversion client and you are able to
browse Subversion repository by using WebSVN. Read http://svnbook.red-bean.com
if you need more help
on setting up a subversion repository.
(Chapter 6 in this book has some important configuration information on
how to setup an Apache web server so that Subversion repositories become
available to clients.) The install.txt file included with the WebSVN package contains information on Configuration
options.
3.
Multiviews must be enabled on Apache.
4.
Tomcat
6.0.xx or higher is running on a machine where you want to install vcindexer
component of this integration.
5.
IBM
Rational Change 5.1 or higher is running on a separate machine.
Go to
Step 3 if you have downloaded the interface and want to install using a local
update site.
1.
Start Eclipse
2.
Select Help ->
Software Updates -> Find and Install…
3.
Choose Search for new features to install and click Next.
4. Click New Remote
Site and then type IBM
Rational for the name and
http://download.boulder.ibm.com/ibmdl/export/pub/software/rational/telelogic/eclipse
for the URL.
5.
Click OK and
then click Finish.
6. Find IBM Rational
Change for Eclipse Interface 1.1 in the list of available features, and then
click the checkbox next to it.
7. Click Next.
8. Accept the license
agreement, and then click Next.
9. Click Finish.
10. Click Install All.
11. When prompted to restart Eclipse,
click Yes.
1.
Download the interface from IBM Rational support website.
2.
Unzip it to a temporary location and locate the zip file change_mylyn11.zip.
3.
Unzip change_mylyn11.zip
to another location to be used as local update site.
4.
Start Eclipse
5.
Select Help ->
Software Updates -> Find and Install…
6.
Choose Search for new features to install and click Next.
7. Click New Local
Site and then browse to the
directory where you unzipped the file change_mylyn11.zip.
8.
Click OK and
then click Finish.
9. Find IBM Rational Change
for Eclipse Interface 1.1 in the list of available features, and then
click the checkbox next to it.
10. Click Next.
11. Accept the license
agreement, and then click Next.
12. Click Finish.
13. Click Install All.
14. When prompted to restart Eclipse,
click Yes.
1.
Download the interface and unzip it to a temporary location.
2.
Find the Rational Change CR process files in <Unzipped
Directory>\ change_process_files
3.
Refer to Rational Change documentation on how to install a CR
process and create a package in Rational Change Server.
4.
Refer to Iinterface’s online help
for configuring vcindexer attributes in Change
Process.
A. Install vcindexer web archive.
1.
Copy the vcindexer.war file to your
Tomcat webapps directory.
Example <your_tomcat_home>\webapps
2.
Create a configuration xml file
Example:C:\temp\vcindex.xml
<svnindex>
<svnrepository
key= "subversion" user="testerbob"
password="deathtrap" url="file:///C:/SVN_REPO/IntDemo"
issuetoken="CR" path="/Projects/trunk/eclipse_int_guide"/>
<websvn url=http://localhost/websvn/ repositoryName="IntDemo"/>
<database driver="org.apache.derby.jdbc.EmbeddedDriver"
url="jdbc:derby:/tmp/issueDB"
user="user1" password="user1"/>
</svnindex>
Note: In vcindex.xml file, svnrepository is your subversion repository; URL is the
physical location of your repository; issuetoken
is “CR” is Change Request Prefix if your Rational Change database (non
DCM). The issuetoken value for the
DCM enabled database is the DCM ID of the data base (example:N#).
The issuetoken is also configured as ListBox Manager attribute value in
Change.
3.
Point your configuration file using the following method.
Create
an environment variable called VC_INDEXER_CONFIG <full path of vcindex.xml>. Example: VC_INDEXER_CONFIG
C:\temp\vcindex.xml
4.
Start Tomcat from windows services control panel OR from
command-line. Example: C:\<tomcat
install dir>bin\starup.bat. The vcindexer service should start without any errors.
Refer to the Interface’s online help for post installation
customizations and configurations.
This
version of the interface:
If the
self-help resources have not provided a resolution to your problem, 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
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:
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, ibm.com, Telelogic, Telelogic Synergy, Telelogic
Focal Point, Telelogic DOORS, and Telelogic
Change are trademarks or registered trademarks of International Business
Machines Corporation in the
See copyright notices on the Web at http://www.ibm.com/legal/copytrade.html.
Microsoft, Windows, and/or other
Microsoft products referenced herein are either trademarks or registered
trademarks of Microsoft Corporation.
UNIX is a registered trademark of
The Open Group in the
Other company, product or service names may be trademarks or service marks of others.