E
dit
A
ttach
P
rintable
r4 - 2014-01-12 - 12:03:18 - Main.sbeard
You are here:
TWiki
>
Deployment Web
>
DeploymentIntegrating
>
InstallTheRTCClientForEclipse301IntoAnExistingEclipse36XUsingIM
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! <img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/new.png" alt="new.png" width="50" height="50" align="right"> Install the Rational Team Concert client for Eclipse 3.0.1 into an existing Eclipse 3.6.x using Installation Manager %DKGRAY% Author: Main.SergioDeras <br> Build basis: Rational Team Concert 3.0.1 %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> The Rational Team Concert client for Eclipse 3.0.1 is built on top of Eclipse 3.5.2 and bundles this version. It is also possible to install the RTC 3.0.1 client into an existing Eclipse 3.6 with IBM Installation Manager (IM), as RTC tolerates the Eclipse 3.6 features. This scenario works with the Eclipse Classic 3.6 package. Other Eclipse packages (e.g., Eclipse JEE and Eclipse RCP) do not contain all the features required by RTC and they do not accept the Eclipse 3.5.2 features packaged by RTC. RTC does support higher versions of these features, which can be added to the Eclipse environment in order to install the RTC components. Note that Eclipse 3.7 (Indigo) is now available. RTC 3.0.1 does not officially support this version but you can find the pieces that must be installed in 3.7 too. This guide uses the Web Installer to start the installation of the Eclipse Client 3.0.1 over an existing Eclipse 3.6.x. If you want to use IM plus a local repository, first check the Required Features in the Eclipse environment *TODO* section and install the features needed by your Eclipse package. Then start IM and select to install the RTC Eclipse Client. You can now start from step 3 *TODO*. ---++ Considerations * If a different Rational product has been installed and you want to share the same Eclipse shell, this is not the correct guide. You need to install RTC in the same package group. * The steps in this guide were tested in Microsoft® Windows 7 with the Eclipse 3.6.2 32 bits packages and Installation Manager 1.4.3 (included in the RTC 3.0.1 Web Install). ---++ Prerequisites <ol> <li>You are using a win32 or linux32 Eclipse package. Installation Manager 1.4.3 do not install RTC into an Eclipse 64 bit package.</li> <li>Your existing Eclipse environment has a valid JVM ready to use (indicated in the eclipse.ini file or a JVM is set in the environment). Check https://jazz.net/wiki/bin/view/Main/CLMWorkbenchSystemRequirements to verify that you have a supported JVM.</li> <li>Your Eclipse environment should contain all the features required by RTC to install into an existing Eclipse. The Eclipse classic package contains all the required features. To know what you are going to need in other editions, see the following section on identifying required features in the Eclipse environment.</li> </ol> ---++ Steps ---+++ 1. Identify required features in the Eclipse Environment The Classic Eclipse package contains all the features required by RTC. However, packages like the CPP or JEE will not accept the install of the Eclipse 3.5.2 features that RTC packages. RTC does support the Eclipse 3.6.2 features, so you can install the correct pieces into the existing Eclipse environment in order to install RTC. The three packages that need to be available in the Eclipse environment are EMF & XSD, PDE and JDT. Make sure that you have them installed before you install RTC. If you have these components in your environment jump to Get the Web Installer and start Installation Manager *TODO*. There you will find the links to the zips containing the required features according to your Eclipse package. Follow these steps to identify and install the Eclipse features that you need: <ol> <li> Download the zips that correspond to your Eclipse package and extract the content to a temporary location. <br /> Package *JEE and RCP* <br /> Features you need to install for 3.6.x: <a href="http://www.eclipse.org/downloads/download.php?file=/modeling/emf/emf/downloads/drops/2.6.x/R201009141218/emf-xsd-SDK-2.6.1.zip">Eclipse Modeling Framework SDK Update (EMF) 2.6.1</a> <br /> Features you need to install for 3.7: <a href="http://www.eclipse.org/downloads/download.php?file=/modeling/emf/emf/downloads/drops/2.7.0/R201106060949/emf-xsd-SDK-2.7.0.zip">Eclipse Modeling Framework SDK Update (EMF) 2.7</a> <br /> Package: *CPP* <br /> Features you need to install for 3.6.x: <a href="http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.6.2-201102101200/org.eclipse.pde-3.6.2.zip">Eclipse Plug-in Development Environment (PDE) 3.6.2</a> and <a href="http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.6.2-201102101200/org.eclipse.jdt-3.6.2.zip">Eclipse Java Development Tools (JDT) 3.6.2</a> <br /> Features you need to install for 3.7: <a href="http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.7-201106131736/org.eclipse.pde-3.7.zip">Eclipse Plug-in Development Environment (PDE) 3.7</a> and <a href="http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.7-201106131736/org.eclipse.jdt-3.7.zip">Eclipse Java Development Tools (JDT) 3.7</a> <br /> Package: *Java* <br /> Features you need to install for 3.6.x: <a href="http://www.eclipse.org/downloads/download.php?file=/modeling/emf/emf/downloads/drops/2.6.x/R201009141218/emf-xsd-SDK-2.6.1.zip">Eclipse Modeling Framework SDK Update (EMF) 2.6.1</a> and <a href="http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.6.2-201102101200/org.eclipse.pde-3.6.2.zip">Eclipse Plug-in Development Environment (PDE) 3.6.2</a> <br /> Features you need to install for 3.7: <a href="http://www.eclipse.org/downloads/download.php?file=/modeling/emf/emf/downloads/drops/2.7.0/R201106060949/emf-xsd-SDK-2.7.0.zip">Eclipse Modeling Framework SDK Update (EMF) 2.7</a> and <a href="http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.7-201106131736/org.eclipse.pde-3.7.zip">Eclipse Plug-in Development Environment (PDE) 3.7</a> <br /> Package: *Testing* <br /> Features you need to install for 3.7: <a href="http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.7-201106131736/org.eclipse.pde-3.7.zip">Eclipse Plug-in Development Environment (PDE) 3.7</a> </li> <br /> <li>Start your Eclipse package. Click <strong>Help > Install New Software</strong></li> <li>Click <strong>Add</strong></li> <li>Select each directory containing the update sites that you created in step 1</li> <li>After you have added all the local folders, unmark the checkbox <strong>"Group items by category."</strong> Select to <strong>"Work with --OnlyLocal Sites--".</strong> </li> <li>Click *Select All* to install.</li> <li>Restart Eclipse when prompted.</li> <a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/local-sites.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/local-sites-small.png" alt="Install New Plugins Dialog"><br> (Click for full size image) </a> <li>Proceed with the installation of RTC using IM.</li> </ol> ---+++ 2. Get the Web Installer and start Installation Manager <ol> <li>Get the RTC Web Installer zip for your OS platform from <a href="https://jazz.net/downloads/rational-team-concert/releases/3.0.1?p=allDownloads"> https://jazz.net/downloads/rational-team-concert/releases/3.0.1?p=allDownloads</a> (Windows or Linux are the operating systems supported by the RTC Eclipse client). <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/download.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/download-small.png" alt="RTC download page"><br> (Click for full size image) </a></p></li> <li>Extract the content of the zip into your preferred location.</li> <li>Go to the directory where you extracted the content.</li> <li>Start the Launchpad with <tt>launchpad.exe</tt> or <tt>launchpad.sh</tt>. The RTC Launchpad should open.</li> <li>You can install RTC in a shared location (administrator privileges are required). Use the checkbox at the bottom of the Launchpad to start or install IM with administrative privileges. <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/launchpad-install-privileges.png"> <img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/launchpad-install-privileges-small.png" alt="Install privileges"><br> (Click for full size image) </a></p></li> <li>To start IM, click the link <strong>"Rational Team Concert - Client for Eclipse IDE"</strong> located under the "Install Optional Tools" section in the Launchpad . <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/install-rtc-eclipse-client.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/install-rtc-eclipse-client-small.png" alt="Install RTC Eclipse client option"><br> (Click for full size image) </a></p></li> <li>Use your Jazz.net ID and password if credentials are requested. </li> </ol> ---+++ 3. Install over an Existing Eclipse <ol> <li>The first Install Packages panel lists the products for installation. If IM needs to be updated or installed, this panel lists that too. Click <strong>Next</strong>. <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/install-package-selection-panel.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/install-package-selection-panel-small.png" alt="Install package selection panel"><br> (Click for full size image) </a></p></li> <li>Accept the license and click <strong>Next</strong> again. If IM is being installed for the first time, accept the defaults in the next panel and click <strong>Next</strong>. <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/shared-directory-selection-panel.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/shared-directory-selection-panel-small.png" alt="Shared directory selection panel"><br> (Click for full size image) </a></p></li> <li>The next panel gives details about the Package group. If it is not selected, choose <strong>"Create a new package group"</strong> and click <strong>Next</strong>. <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/package-group-selection-panel.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/package-group-selection-panel-small.png" alt="Package group selection panel"><br> (Click for full size image) </a></p></li> <li>A panel opens that enables you to install RTC into an existing Eclipse instance. <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/existing-eclipse-selection-panel.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/existing-eclipse-selection-panel-small.png" alt="Install into an Existing eclipse selection panel"><br> (Click for full size image) </a></p></li> <li>Select the <strong>Extend an existing Eclipse</strong> checkbox.</li> <li>Click the <strong>Browse...</strong> button to select the directory that contains your eclipse executable. <p><a href="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/browse-existing-eclipse.png"><img src="https://jazz.net/library/content/articles/rtc/3.0.1/installing-rtc-over-eclipse-36/images/browse-existing-eclipse-small.png" alt="Browse for an existing eclipse"><br> (Click for full size image) </a></p></li> <li>IM searches for the JVM used by this Eclipse environment. As indicated in the prerequisites, your Eclipse environment must have a valid JVM available. If the folder does not contain a valid Eclipse environment or the JVM is not valid nor set, IM might not allow you to continue until the problem is fixed (depending on the IM version). Click <strong>Next</strong> if the validation was successful.</li> <li>Do not select to install other languages. Native Eclipse does not include language packs and the installation fails if any language content is selected. Click <strong>Next</strong>.</li> <li>Select to install <strong>Sametime Integration</strong> if you need it. Click <strong>Next</strong>.</li> <li>Select the way you want to install the Help. Click <strong>Next</strong>.</li> <li>Start the installation by clicking<strong> Install</strong>. </li> <li>When the installation completes, close IM and the Launchpad. Start your Eclipse environment and verify that the !WorkItems perspective is available.</li> </ol> ---++ Related links * [[https://jazz.net/library/article/708/][The older version of this guide]] * [[https://www-304.ibm.com/support/docview.wss?uid=swg21391058&wv=1][Install RTC Eclipse Client 2.x into Eclipse 3.4.2]] * [[https://www.ibm.com/developerworks/wikis/display/rationalinstall/Install+into+an+existing+Eclipse+instance][Installing Rational Eclipse-based (7.5 and 8.0) products within an existing Eclipse]] * [[https://www-304.ibm.com/support/docview.wss?rs=3488&uid=swg21502374&wv=1][Technote to install RTC 3.0.x over Eclipse 3.6.x]] <sticky></div></sticky>
E
dit
|
A
ttach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
: r4
<
r3
<
r2
<
r1
|
M
ore topic actions
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.