How to install RDi in the latest version of Eclipse
Please vote for this enhancement request:
If you get security errors along the way, you have to run RDi as an administrator. This for people that have installed RDi in "C:\PROGRAM FILES" and not in their user directory.
Out of the Box, Eclipse is a Java development environment. However, Eclipse can be molded into many different shapes due to its plugin system and extension point architecture. Invented about 20 years ago, it's architecture is still very strong. The plug-in system enables third-party vendors, like IBM, to build upon the platform. For example, to build RDi.
The Eclipse IDE is constantly being improved. Many highly skilled programmers work daily on making sure the IDE is super-fast and stable. The current Eclipse version is 4.16, unfortunately, RDi 9.6 is running on Eclipse 4.6.
Currently RDi is running on an ancient, unstable, and slow version of Eclipse which is 10 versions behind the current version.
Let’s fix that.
Let's get started
You have to be a bit of a hacker to be able to follow this blog. If you have RDi already installed then don't worry, you will not break it (I hope). The steps that we are going to take are:
- Install the latest version of RDi.
- Make an update site that contains the RDi artifacts.
- Download the latest and the greatest Eclipse version.
- Install the RDi plugins into the new eclipse.
1.Install the latest version of RDi
If you already have an RDi installed then you can use that. I have done this with RDi version 22.214.171.124 20200403_1723.
2. Make an update site that contains the RDi artifacts
This is where we have to roll up our sleeves. We are going to create an update site. An update site (aka repository) is Eclipse lingo for "a place from where thou can install new software". We will use this update site later in our new eclipse version to install RDi.
To create the update site we first have to switch to the "Resource" perspective. A perspective is an organization of views inside Eclipse.
To do this, find the input box that says "Quick Access" on the top right of the RDi. Then type "Resource" and click on the line that reads "Perspectives -- Resource".
This will switch you to the Resource perspective.
In the Resource perspective, you will find the "Project Explorer" view on the left (1). Click somewhere in that view and press CTRL+N (control-n). A wizard will pop-up.
In this wizard, enter "update" in the filter box (2) and select the "Update Site Project" (3). Then press Next (4).
On the next page, in the name box, type "rdiupdate" and press finish.
In the middle of RDi, the site editor will open. Here you must press the "Add Feature..." button (1).
A feature is a grouping of plug-ins and a plug-in is a grouping of Java classes. You can compare a plug-in with a service program and a feature with a library.
In the selection wizard that appears, select all features that start with "com.ibm". There are about 170+ features. Then press OK.
These are the features that we want to install into our new Eclipse.
Back in the site editor, you will see the list of selected features. This should contain all of the 170+ features.
Once you've verified that the list is complete you can press CTRL+S to save the editor. After this is done, press the "Build All" button.
This will generate the update site.
After a couple of minutes, the update site will be created. You can see that new content is generated in the "rdiupdate" project.
Right-click on the project name and select "properties". Then copy the name of the directory. We will use this location later.
3. Download the latest and the greatest Eclipse version
Now it is time to download the latest and the greatest Eclipse version. I am always on the latest nightly build but you can be a little bit more conservative and download version 4.16.
You can download a zip file for your platform here . Click on any of the links in the "Latest Downloads" section.
On the page that appears next, scroll down and find the zip file for your platform and download it.
Unzip the zipfile and enter the directory that was just unzipped. Find the "eclipse.exe" executable and run it.
In the select workspace dialog make sure to select an empty workspace directory.
4. Install the RDi plugins into the new eclipse
We are almost done. The last step will install all of the RDi features into the new Eclipse.
Once the new Eclipse has opened, select "Install new Software" from the "Help" menu.
In the "Available Software" wizard, select the "Add..." button.
In the "Add Repository" dialog, press the "Local..." button.
Navigate to the location of your "rdiupdate" project and press "Select Folder" or equivalent.
Once back in the "Add Repository" dialog, enter a descriptive text and press "Add".
In the "Available Software Site" select all features and press "Next >".
In the "Install Remediation Page", you will see some information. Press "Next >".
UPDATE: Don't worry about the one feature that cannot be installed. It is not needed.
To install the features, go through the steps of accepting all the licenses. The software will then be installed, which can take a while. You may get a pop-up or two to accept some certificates and finally, you will be asked to restart.
Go ahead and restart, then open the remote system explorer perspective and browse around.
You can zip the directory where you installed Eclipse and give it to your coworkers.
Questions? Let me know in the comments.