|
IBM
Rational® Change for ClearCase
Interface 2.1.0.1 Readme |
IBM Corporation |
|
|
© Copyright IBM Corporation 2006, 2011
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
ClearCase® Interface
2.1.0.1
It is divided into the following sections:
To access the latest news and
information on the Rational Change for Quality Center Web site, go to www.ibm.com/software/rational/support/.
For additional information about
system requirements, including recommended configurations, visit the Rational
Change Support
Web site at http://www.ibm.com/software/awdtools/change/support/
At the time of this writing, the Rational
Change for ClearCase Interface 2.1.0.1 was tested
with:
For the latest information about
third party products that are supported with Rational Change for ClearCase Interface, visit the Rational Change Support Web
site at http://www.ibm.com/software/awdtools/change/support/
The Rational Change for ClearCase Interface 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. Download the interface.
o For Windows, ratlChange_ClearCase_2-1-0-1_windows.zip
o For Linux, ratlChange_ClearCase_2-1-0-1_linux.tar.gz
o For Solaris, ratlChange_ClearCase_2-1-0-1_solaris.tar.gz
If you have Rational Change installed, you can download the Interface from Rational Change server http://host:port/context/trapeze/integrations.
If you have downloaded Rational Change you can also unzip the file and the Interface will be available under <unzipdir>\change\integrations.
2. Extract to a temporary folder.
On the Rational Synergy server, install the ClearCase Placeholder Object type definition.
Locate the file <distribution>\install\rational_synergy\cc_plcholder_obj.xml, which contains type
definitions. Type Definitions are
installed on a per-database basis, and this type
definition needs to be installed on all databases with which you intend to use
the interface.
Using Synergy 7.1
1. From the Rational Synergy CLI, start
a Synergy classic client session where the current user role is type_developer
or ccm_admin.
2. Copy cc_plcholder_obj.xml to C:\synergy_typedefs, or to some other location.
3. Use the following command to install
the Type Def, replacing C:\synergy_typedefs with the appropriate location. If
the command fails to import the typedef, ensure that
your current user has the permissions needed to access cc_plcholder_obj.xml.
o
ccm typedef -import cc_plcholder_obj
-dir C:\synergy_typedefs –force
4. Verify the Type Definition
Installation with the following command:
o
ccm query -n cc_plcholder_obj
o
ccm attr -l @
Using Synergy 7.2 and
above
1. From the Rational Synergy UI launch
Synergy CLI.
2. Set the role to type_developer or ccm_admin
a. ccm set role ccm_admin
3. Copy cc_plcholder_obj.xml to C:\synergy_typedefs, or to some other location.
4. Use the following command to install
the Type Def, replacing C:\synergy_typedefs with the appropriate location. If
the command fails to import the typedef, ensure that
your current user has the permissions needed to access cc_plcholder_obj.xml.
a.
ccm typedef -import “C:\synergy_typedefs\ cc_plcholder_obj.xml”
5. Verify the Type Definition
Installation with the following command:
a.
ccm query -n cc_plcholder_obj
b.
ccm attr @
Install
the Rational Change "clearcase_integration_component"
package.
1.
Locate
the directory <distribution>\install\rational_change\clearcase_integration_component
2.
Copy
the directory clearcase_integration_component to <Rational Change>\jetty\webapps\change\WEB-INF\packages
3.
Log
on to Rational Change as admin in the package installer, install "clearcase_integration_component"
1. Edit the Rational Change Request
Process for assigned2resolved
transition.
2. In the Triggers section click on Pre
Transition button.
3. Click on Available Triggers button in the Pre Transition Triggers page.
4. In the Pre Transition Triggers page, select Current Installation as the Package Template and completeAssocTasks.pl as the Trigger.
5. Click on Add button. Command to call
trigger will be added to the list of pre condition scripts.
6. Prefix the trigger call command with
verify: and now it should look like verify: ratlperl
completeAssocTasks.pl associated_task.
7. Move the command to the top of the
list.
8. Update changes.
9. Create a new Change Request Package
and install it.
1.
Launch
the installer using the executable for your platform (install.exe or install.bin).
The wizard guides you through the rest of the installation process.
2.
After
the installation is finished, restart the machine.
3.
Ensure
that that the environment variable RCCC_INTEGRATION_PATH
has been set to the installation path.
4.
Launch
the Interface GUI using the shortcut or link the installer created.
5.
Launch
the online help and read it completely before using 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:
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
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
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.