Install RTC Eclipse Client 4.0 into an existing Eclipse 3.6.2 using Installation Manager

Sergio Jose Deras Arreola, IBM
Last updated: Jun 8, 2012
Build basis: Rational Team Concert 4.0

Summary

Rational Team Concert (RTC) Eclipse Client 4.0 is built on top of Eclipse 3.6.2, and the full installation of RTC includes an instance of Eclipse 3.6.2. Alternatively, it is possible to install the RTC 4.0 features into an existing Eclipse 3.6.2 environment using Installation Manager (IM).

More Information

This following procedure shows you how to install the RTC Eclipse Client 4.0 into an existing Eclipse 3.6.2 instance, and it provides links to the required features and patches that need to be installed.

Determine how you will complete this procedure. There are two paths through the steps in this guide:

• If you want to use the web installer to start the installation, complete the whole procedure, starting with step 1.
• If you want to use a Local Repository instead of the Web installer, first complete the following steps:
  1. Install the features that your Eclipse package is missing. Use the instructions in the Required Features in the Eclipse environment section.
  2. Install the required set of Eclipse patches. Use the instructions and information in the Required Patches in the Eclipse environment section.
  Once you have the required features and the patches, start IM and select to install the RTC Eclipse Client from your Local Repository. At this point, skip to step #4 Install into an Existing Eclipse and complete the procedure.

Considerations

• If a different Rational product has been installed and you want to share the RTC functionality in the same Eclipse shell, this is not the correct guide; for that case you need to install RTC in the same package group where your other Rational product is installed.
• The steps in this procedure were tested in Windows 7 with the “Eclipse Classic 3.6.2” 32 bits package and Installation Manager 1.5.2 (included in the RTC 4.0 Web Install).
• We provide the instructions to install the features that you need to include into your Eclipse environment.

Pre-reqs:

• You are using a win32 or linux32 Eclipse package. Installation Manager 1.5.2 cannot install RTC into an existing Eclipse package working in a 64 bits mode.
• Your existing Eclipse environment has a valid JVM that is 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.

Steps

Required Features in the Eclipse Environment

Packages (Eclipse editions) like the CPP or JEE will need to install extra Eclipse features in order to accept the RTC requirements. Please note that all the Eclipse 3.6.2 packages do not contain the feature patches required by RTC. These patches are discussed in the next step, but you must install some Eclipse features first.

The 3 packages that must be available in Eclipse are:

• “EMF & XSD”
• “PDE”
• “JDT”
Ensure that you have the packages installed before proceeding to Required Patches in the Eclipse environment. If you do not have them installed, continue with this step to obtain them. If your Eclipse environment has the 3 features indicated in this guide skip to Required Patches in the Eclipse environment.

Below you can find the links to the zips containing the required features according to your Eclipse package.


Identify and Install the Eclipse features:

1. Download the(se) zip(s) corresponding to your Eclipse package and extract the content to a temporary location.


Package: JEE and RCP
Features to install for 3.6.2: Eclipse Modeling Framework SDK Update (EMF) 2.6.1

Package: CPP
Features to install for 3.6.2: Eclipse Plug-in Development Environment (PDE) 3.6.2 and Eclipse Java Development Tools (JDT) 3.6.2

Package: Java
Features to install for 3.6.2: Eclipse Modeling Framework SDK Update (EMF) 2.6.1 and Eclipse Plug-in Development Environment (PDE) 3.6.2


2. Start your Eclipse package. Click in Help > Install New Software.
3. Click Add.
4. Select each directory containing the update sites that you created in step 1.
5. After you have added all the local folders, unmark the checkbox “Group items by category” select to “Work with –OnlyLocal Sites–“, press on the button “Select all”.

   
   (Click for full size image)

6. Proceed with the install of the new features and restart eclipse when prompted.
7. Proceed with the installation of RTC using IM.



Required Patches in the Eclipse environment

The Eclipse version that is included with RTC 4.0 has some patches from Eclipse to correct some defects found during development. It is required that you have these fixes in your Eclipse environment in order to proceed with the installation of RTC. If your Eclipse environment has the required patches, skip to Get the Web Installer and start Installation Manager.

Identify and Install the Eclipse patches:

1. Navigate to IBM Fix Central and download the zip file labeled as Fix Pack : 4.0.0.0-Rational-RTC-Eclipse-IDE-groupfixpack to get the patches.
2. Extract the content of the zip to a temporary location.
3. Start your Eclipse package. Click Help > Install New Software.
4. Click Add and select the Local… button.
5. Select the temporary location that was created previously. Press OK twice.
6. After you have added the folder, clear the two checkboxes “Group items by category” and “Contact all update sites during install to find required software”. See the image for an example.

   
   (Click for full size image)

7. Proceed with the installation of the new features, and restart Eclipse when prompted.
8. Proceed with the installation of RTC using IM in step 3 or step 4 if you have a local repository and IM installed into your machine.

Get the Web Installer and start Installation Manager

1. Get the RTC Web Installer zip from https://jazz.net/downloads/rational-team-concert/releases/4.0?p=allDownloads for your platform (Windows or Linux are supported by the RTC Eclipse client).

   
   (Click for full size image)

2. Extract the content of the zip into your preferred location.
3. Go to the location where you extracted the content.
4. Start the Launchpad with launchpad.exe or launchpad.sh, the RTC Launchpad should appear.
5. Select “Install Optional Tools” in the left side of the Launchpad.
6. You can install RTC in a shared location (administrator privileges are required). According to your needs (or privileges) use the combobox in the bottom of the Launchpad to start or install IM with administrative privileges.

   
   (Click for full size image)

7. To start IM, in the “Install Optional Tools” section in the Launchpad, click the link “Rational Team Concert – Client for Eclipse IDE”.
8. Use your jazz.net account if credentials are requested.

Install into an Existing Eclipse

1. The first Install Packages panel shows the products that are going to be installed. If IM needs to be updated or installed, it is displayed on this page. Click the “Next” button.

   
   (Click for full size image)

2. Accept the license and click “Next”. If IM is going to be installed for the first time, accept the defaults in the next panel and click “Next”.
3. A panel with explanations about the “Package group” appears. If it is not selected, choose “Create a new package group” and “32-bit” in the Architecture Selection section. To continue click “Next”.

   
   (Click for full size image)

4. The panel that allows you to Install RTC into an existing Eclipse opens.

   
   (Click for full size image)

5. Check the checkbox “Extend an existing Eclipse”.
6. Click “Browse…” and locate the folder on you system that contains the Eclipse executable file.

   
   (Click for full size image)

7. IM will search for the JVM used by this Eclipse environment. As indicated in the pre-reqs, your Eclipse environment must have a valid JVM available. If the folder does not contain a valid Eclipse environment or the JVM is incompatible, IM displays a notification. If a compatible JVM is available in your system but it is not set in the eclipse.ini file, IM will offer to make the change. If this happens and you want IM to move the file for you, click Accept. Press “Next” if the validation completed successfully.

   
   (Click for full size image)

8. Do not select to install other languages; native Eclipse does not include language packs and the installation will fail if any language content is selected. Click “Next”.

   
   (Click for full size image)

9. Select to install the “Sametime Integration” if you need it. Click “Next”.
10. Select the method by which you want to access the Help system, then click “Next”.
11. Start the installation by clicking “Install”.

    
    (Click for full size image)

12. Once the installation ends, close IM and the Launchpad. Start your Eclipse environment and verify that the Work Items perspective is available.

Related Links

The following links point to related information:

• Install the Rational Team Concert client for Eclipse 3.0.1 into an existing Eclipse 3.6.x using Installation Manager
• Install RTC Eclipse Client 2.x into Eclipse 3.4.2
• Installing Rational Eclipse-based (7.5 and 8.0) products within an existing Eclipse
• Our technote to install RTC 3.0.x over Eclipse 3.6.x

About the author

Sergio Jose Deras Arreola is a Jazz developer in the Install team in charge of the Ratonal Team Concert offerings based in the Installation Manager install technologies. He can be contacted at sderas@mx1.ibm.com.

© Copyright 2012 IBM