(r11) HowDoIInstallRTCOnIDEsVersion9 < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
~~EditAttach~~Printable
TWiki > Deployment Web > DeploymentTroubleshooting > IntegrationsTroubleshooting > IntegrationsTroubleshootingRTCandIntegratedDevelopmentEnvironments > HowDoIInstallRTCOnIDEsVersion9
Revision 11 - 2014-01-13 - 16:23:21 - Main.dmmckinn
<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"> Troubleshooting the installation of the Rational Team Concert Client on version 9 of IBM IDEs
%DKGRAY% Authors: Main.IntegrationsTroubleshootingTeam <br>
Build basis: Rational Team Concert 4.0.3+, Rational Application Developer 9, Rational Software Architect 9, Rational Developer for Z 9, Rational Business Developer 9, Rational Developer for i 9
%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 version 9 of the IBM integrated development environments (IDEs) is based on Eclipse 4.2. The first version of Rational Team Concert Client that supports Eclipse 4.2 is version 4.0.3. Depending on the Operating System, there are different ways of installing the Rational Team Concert Client on Rational Application Developer 9, Rational Software Architect 9, Rational Developer for Z 9, Rational Business Developer 9, Rational Developer for i 9. There are also different packages of the Rational Team Concert Client for Eclipse that must be used in the different cases. This document explains common error messages and the successful installation procedure for different Operating Systems.

---++ How to verify that two products are compatible

Before you start the installation, review this page to verify that the versions you have selected are compatible with each other: [[https://jazz.net/wiki/bin/view/Deployment/HowToVerifyThatTwoProductsAreCompatible][How To Verify That Two Products Are Compatible]]

---++ How to verify that a product supports a given operating system

Not all IDEs listed in this document support all Operating Systems mentioned in this article.  You can check to see if your IDE supports a given Operating System using this form:
[[http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/osForProduct.html][Operating systems for a specific product]]


---++ Windows/Linux operating systems

On Microsoft Windows/Linux operating systems, you can install Rational Team Concert Client for Eclipse using IBM Installation Manager. 

---+++ Problem 

If you download the package called:
<pre>
Client for Eclipse IDE (Extension Install) 
</pre>
and attempt to install it, you will get the following error:
<pre>
Rational Team Concert - Client Extension for Eclipse 3.x 4.0.4 cannot be installed into any package group.
  CRIMA1071E: The installation package 'Rational Team Concert - Client Extension for Eclipse 3.x' requires components supplied by other packages.
- No installation package information provided.
</pre>
<img src="%ATTACHURLPATH%/ErrorInstallingExtension.jpg" alt="ErrorInstallingExtension.jpg" width="934" height="738" />

This is due to the fact that the Extension is only compatible with Eclipse 3.x.

---+++ Resolution

You need to download the following package instead:
<pre>
Client for Eclipse 4.2.x IDE
</pre>
After installing the desired IDE, install the above package in the same package group as the IDE, as follows.

   1 Unzip the file: <code>RTC-Client-Eclipse4.2-repo-4.0.4.zip</code> (your version number might differ)
   1 Open *IBM Installation Manager*
   1 Open *File > Preferences > Repositories*
   1 Click on *Add Repository* and browse to the location of the extracted repository:
      <pre>
     [PATH]\im\repo\rtc-client-ext-offering\offering-repo\repository.config
     </pre>
     <img src="%ATTACHURLPATH%/ConfigureRepository.jpg" alt="ConfigureRepository.jpg" width="1045" height="539" />
   1 Click *OK*
   1 Click *Install*
   1 Select: *Rational Team Concert - Cient for Eclipse IDE 4.2* and the desired version:
     <img src="%ATTACHURLPATH%/InstallRTC.jpg" alt="InstallRTC.jpg" width="935" height="714" />
   1 If desired, click on: *Check for other Versions, Fixes and Extensions*
   1 Click *Next*
   1 Select *Accept the Terms in the License Agreement*
   1 Click *Next*
   1 Select the existing package group where the IDE is installed. 
      In the screenshot below, you see an example where *IBM Rational Software Architect for !WebSphere Software* was installed in the directory: 
      <code>C:\IBM\SDP</code>, but your installation may differ:
      <img src="%ATTACHURLPATH%/SelectExistingPackageGroup.jpg" alt="SelectExistingPackageGroup.jpg" width="936" height="739" />
   1 Click *Next*
   1 Select the desired features to install (Note: IBM Sametime is a messaging system):
      <img src="%ATTACHURLPATH%/SelectRTCFeatures.jpg" alt="SelectRTCFeatures.jpg" width="935" height="740" />
   1 Click *Next*
   1 Select how you want to access the Help system. The default option is: *Access help from the Web*
   1 Click *Next*
   1 Click on *Install* 
   <br>
     <img src="%ATTACHURLPATH%/InstallRTCFinal.jpg" alt="InstallRTCFinal.jpg" width="938" height="740" />
   1 At the end of the installation, you will see this screen:
      <img src="%ATTACHURLPATH%/RTCInstallationConfirmation.jpg" alt="RTCInstallationConfirmation.jpg" width="938" height="739" />
   1 Click on *Finish*
   1 Exit *Installation Manager*
   1 Launch the IDE and activate Rational Team Concert Client by opening: *Windows > Open Perspective > Other > Work Items*
     <img src="%ATTACHURLPATH%/OpenRTCPerspective.jpg" alt="OpenRTCPerspective.jpg" width="1022" height="767" />

Note:
If you have installed Rational Application Developer 9, Rational Software Architect 9, Rational Developer for Z 9, Rational Business Developer 9, Rational Developer for i 9 as an administrator into an existing Eclipse 4.2.2 instance, review the following technical document to see if it applies to your environment: [[http://www-01.ibm.com/support/docview.wss?uid=swg21640442][Non-administrator user cannot install software by using Eclipse Software Installer in V9.0]]

---++ !MacOS operating system

On !MacOS, you cannot install Rational Team Concert Client for Eclipse using IBM Installation Manager. 

---+++ Problem 

If you attempt to install the package:
<pre>
Client for Eclipse 4.2.x IDE
</pre>
with Installation Manager, you will see the error:
      <br><img src="%ATTACHURLPATH%/RTC403ClientInstalOnMacOSError.png" alt="RTC403ClientInstalOnMacError.png" /> <br />
    <br>In plain text: <br />
<pre>
Package Rational Team Concert - Client for Eclipse 4.2.x IDE cannot be installed on the current platform </br>(operating system: macosx, architecture: x86).
</pre>

---+++ Resolution 

For a successful installation, proceed as follows:

   1  Install the IDE first
   1  Download the package called:
      <pre> p2 Install Repository </pre>
   1 Install the RTC Client plugin with the Eclipse p2 Installer
      1 Go to the menu *Help > Install New Software* to launch the Installation wizard.
         <br><img src="%ATTACHURLPATH%/RTC404Clientp2Install1.png" alt="RTC404Clientp2Install1.png" width="728" height="647" /> </br>
      1 Click on the *Add* button to be able to enter the details of the location of the RTC client p2 zip (*RTC-Client-p2Repo-4.0.x.zip*)
         1 Enter the name of your choosing for the software site in the *Name* field
         1 Click on the *Archive* button to browse to the *location* were you stored the RTC-Client-p2Repo-4.0.x.zip
         1 Click *Ok*
          <br><img src="%ATTACHURLPATH%/RTC404Clientp2Install2.png" alt="RTC404Clientp2Install2.png" width="729" height="648" /> </br>
      1 Once you have created your installation repository site, the entry *Rational Team Concert Client (extend an Eclipse installation)* will be listed.
         <br>Select the *Rational Team Concert Client Feature* entry and click *Next*.
         <br><img src="%ATTACHURLPATH%/RTC404Clientp2Install3.png" alt="RTC404Clientp2Install3.png" width="729" height="649" /> </br>
      1 Verify in the *Installation Details* that the Name, Version and Id matches the information shown in the screenshot below. 
         <br><img src="%ATTACHURLPATH%/RTC404Clientp2Install4.png" alt="RTC404Clientp2Install4.png" width="731" height="647" /> </br>
      1 *Review the Licenses* and *accept* the *licenses agreement terms*
         <br><img src="%ATTACHURLPATH%/RTC404Clientp2Install5.png" alt="RTC404Clientp2Install5.png" width="730" height="646" /> </br>
      1 Click *Ok* when prompted with the *Security Warning* dialog 
         <br><img src="%ATTACHURLPATH%/RTC404Clientp2Install6.png" alt="RTC404Clientp2Install6.png" width="540" height="142" /> </br>
      1 Click *Yes* when prompted to *restart* the *IDE*
         <br><img src="%ATTACHURLPATH%/RTC404Clientp2Install7.png" alt="RTC404Clientp2Install7.png" width="513" height="126" /> </br>


---++ Related Information

---+++++!! Related topics: [[IntegrationsTroubleshooting][Integrations Troubleshooting]] [[IntegrationsTroubleshootingRTCandIntegratedDevelopmentEnvironments][Troubleshooting Rational Team Concert integration with Integrated Development Environments]]

---+++++!! External links:          

   * [[http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/softwarePrereqsMatrix.html][Products and prerequisites matrix]]
   * [[http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/osForProduct.html][Operating systems for a specific product]]
   * [[http://www.ibm.com/support/docview.wss?uid=swg21640442][Non-administrator user cannot install software by using Eclipse Software Installer in V9.0]]
   * [[https://jazz.net/library/article/1337#00001][Rational Team Concert 4.0.4 client for Eclipse 4.2 crashes when Rational Software Architect 9.0 is installed in the same IBM Installation Manager]]
   * [[https://jazz.net/library/article/1337#00000][Rational Team Concert 4.0.4 client for Eclipse 4.2 crashes with JVM segmentation error on SLES 10]]



---+++++!! Additional contributors: Main.LaraZiosi, Main.FrancoisPanaget

---+++++!! Questions and comments:

%COMMENT{type="below" target="HowDoIInstallRTCOnIDEsVersion9Comments" button="Submit"}%

%INCLUDE{"HowDoIInstallRTCOnIDEsVersion9Comments"}%
</sticky></div></sticky>
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.