Update September 4th, 2013
NOTE: It has been pointed to me that RTC client 4.0.2 is not supported in RAD v9.0 and you can verify that in this link, so if you use this software stack for a production environment, is under your own risk.
However, the p2 headless installation steps are still valid for RTC client 4.0.3 and later or any other p2 install site.
Installing RTC client 4.0.2 on RAD v9.0 in command-line
Rational Application Developer (RAD) is the premier IDE that IBM offers for Enterprise-level development. It has a great integration with Rational Team Concert, which allows teams to track, document, plan, version and build the development projects from within the IDE.
Both offerings can be installed using IBM Installation Manager, which means that the installation details are centralized in one repository. This enables a convenient management of the development environments that teams may have.
Since RAD v9.0 was Generally Available , it was announced that it now is built on top of Eclipse 4.2.2. This means that if you have a RTC older than 4.0.3, you can't install RTC client on top of RAD v9.0 (this is also known as “Shell Sharing”) because RTC 4.0.2, and earlier, is based on Eclipse 3.x. If you try to do this, you will get an error like the following one (this image was taken when RAD v9.0 is the only offering installed in Installation Manager and it is using a RTC client 4.0.3 for Eclipse 3.x)
Nevertheless, there is still a way to install RTC 4.0.2, and prior, in RAD v9.0: Use P2 install.
RTC client can be installed using P2 Director either using the commonly used UI menu, go to Help > Install new software and select your P2 repository (you can add it in the same Install dialog by clicking Add), or command-line execution.
But, what if you have several RAD v9.0 installations in different machines? Going one at a time to run the UI actions would be my only solution? Well, that's not even an acceptable solution if you have a fair amount of installations. So what can you do? Eclipse offers a comprehensive method for running headless P2 installations than can be launched in a command line and allows you to write easy-to-tune shell scripts for installing different applications in Eclipse .
So, what do you need to know in order to create such script? In fact just two things
The RTC client p2 repository you want to install. Download the RTC client P2 ZIP file in a central place that you and your developers can access to download it locally.
The feature group that Eclipse uses to install the product.
For the first, you will need valid access to jazz.net products. You can request an account for free if needed. For the second one, you just need the RTC feature group ID: com.ibm.team.rtc.client.feature.feature.group.
Once you have all the prerequisites, you can create the script that, at some point, it will look like the following one.
Listing 1. Install RTC client using p2 snippet.
#! /bin/sh # URI that points to the file you downloaded from jazz.net in your local network RTC_P2_REPO="http://<Your_server>/<Path_To_RTC>/RTC-Client-P2Repo_22.214.171.124-RTC-I20130222-1633.zip" # Name of the downloaded file is the same as in the URL above RTC_P2_FILE="RTC-Client-P2Repo_126.96.36.199-RTC-I20130222-1633.zip" # Place where the zip will be placed and exploded RTC_P2_DOWNLOADED_DIR="$HOME/RTC402" # Path where RAD is installed in each machine RAD_INSTALL_DIR="/opt/IBM/SDP" # Create the filesystem structure and change to it mkdir -p $RTC_P2_DOWNLOADED_DIR cd $RTC_P2_DOWNLOADED_DIR # Download the RTC client from your local server and unzip it echo "Downloading RTC p2 client" wget $RTC_P2_REPO echo "Unzipping RTC" unzip $RTC_P2_FILE # Run the P2 Director program to install RTC via P2 echo "Running in directory: $PWD" echo "Running P2 installer" $RAD_INSTALL_DIR/eclipse -nosplash -application org.eclipse.equinox.p2.director -repository file://$PWD -installIUs com.ibm.team.rtc.client.feature.feature.group
The script shown above has the following elements:
-nosplash: This causes that the execution of the eclipse program to be headless. No UI will be shown.
- application org.eclipse.equinox.p2.director: Director is the Eclipse application that makes possible the headless installations using P2.
-repository: The downloaded and unzipped RTC P2 Repo in the local system.
-installIUs: The feature group identifier that will be installed. It supports multiple feature groups as long as they are separated by commas. For RTC Client, the id is com.ibm.team.rtc.client.feature.feature.group
The script depicted in this article was developed in a Ubuntu 12.04 LTS box, but the general idea of the headless installation applies for Windows and MacOS as well. Just tune it to the respective operating system.