Product Installation

First steps:

  • Make sure to check the System Requirements before installing the product.
  • Make sure Eclipse is not running.
  • Choose and download an installer. If you're on MS Windows you'll probably use the *.exe installer. In Linux, download the *.bin installer. However, the *.jar installer will work for any platform that has Java installed.

For installation details, see the following:

Installation using installer

Launch the installer that you downloaded. 

  • In Windows, double-click the installer file.
  • In Linux, first change the permission to be able to execute the file then double-click the installer file. 
    • In graphical user mode, Right-click > Properties > Permissions and give the Owner, Execute permission. Now double-click the installer.
    • In terminal mode, 
      chmod a+x Installer_vXXX_linux_x86.bin
    • then execute
      ./Installer_vXXX_linux_x86.bin
  • Note: If you encounter problems installing, see Problems running the Installer.

The instructions below will walk you through the Install wizards. 

Note: All the installers look about the same, but the paths in the file system will be a bit different for each platform. These examples are taken from the Windows installer.


Welcome

  • Launch the installer
The first page is a Welcome page. It allows you to verify that you are indeed running the correct installer, and gives you a short overview of what is to come.
  • Click Next to move to the next page.

License Agreement

This is the license agreement. You should read through the agreement. 

  • If you accept it, check I accept (the top radio button). That enables the Next button. 
  • Click Next to continue.

Installation Directory

  • Choose the directory where you want to the product installed. You only need to install it once even if you want to use it in multiple Eclipse installations. If you need to change the default directory, you can either type it directly or use the Browse button to navigate to the directory.
  • Click Next to continue to the next page.

Select Eclipse Product

  • The next screen lets you choose which versions of Eclipse you want to install the product. If you have one version installed, it will be selected by default. Please refer to the System Requirements for Eclipse versions supported.
  • If you check Show all Eclipse products, all versions will be searched (that includes 3.0, 2.0, and even WSAD, RAD, and so forth) and included in the list. If the installer can't find the Eclipse installation you want, you can navigate to it by clicking Choose Eclipse. If your installation directory is C:\Program Files\Eclipse 3.x\eclipse, select the \eclipse directory.
  • You can install into as many versions at once as you like. They will all share a single product installation. 
Note: If you are installing RCP Developer version 1.0.0, choose Eclipse 3.1.x.
  • Click Next to continue.

Warning

  • If you have Eclipse running, you will get this dialog. Please close Eclipse before clicking Next.

Clean Eclipse Cached Configuration Option

  • This next page gives you the option to clean cached configuration data. It is recommended to clean the configuration information to avoid any configuration conflicts.
  • Click Next to move on to the next page.

Verify Installation

  • You know you're about done once you get to the verification page. Check that everything is the way you want it (if you didn't change anything then it probably is).
  • Click Next to continue.

Progress Bar

  • The installation page includes a progress bar at the bottom so you have an idea  how long the installation process will take.

Installation Complete

  • Once installation completes, you will automatically switch to the final page.
  • Click Finish to complete the installation.



Installation using Zip files

Please make sure you downloaded the correct zip file version for the version of Eclipse you are installing it into.

There are two ways you can install the zip file:

Option 1. Install directly into your Eclipse root directory
  1. Unzip the files into your Eclipse root directory while making sure to preserve the folder structure within the ZIP file. This will add the product features and plug-ins to your existing Eclipse features and plug-in directories.
  2. Before starting Eclipse, delete everything in your \eclipse\configuration directory except for your config.ini file. This is to avoid a common Eclipse 3.x plugin cache bug.
Option 2: Install using a link file
  1. Select a location outside of your Eclipse installation and create an "eclipse" subdirectory.  For example:  C:\Program Files\Instantiations\RCP Developer\eclipse. Unzip the files into the "eclipse" subdirectory. This will add "features" and "plugins" subdirectories to the "eclipse" directory.
  2. Next, create a link file (text file) that contains a single line specifying the full path to the product location. Example:  path=C:/Program Files/Instantiations/RCP Developer. Save the text file in your main <eclipse>\links directory with a file extension of .link. You may have to create the links subdirectory if it does not exist. Example: c:\dev\eclipse\links\com.instantiations.rcpdeveloper.link

  3. Before starting Eclipse, delete everything in your \eclipse\configuration directory except for your config.ini file. This is to avoid a common Eclipse 3.x plugin cache bug.
Option 3: Install using an extension location
  1. Select a location outside of your Eclipse installation and create an "eclipse" subdirectory.  For example:  C:\Program Files\Instantiations\RCP Developer\eclipse. Unzip the files into the "eclipse" subdirectory. This will add "features" and "plugins" subdirectories to the "eclipse" directory.
  2. Create a .eclipseextension file and save it in your \RCP Developer\eclipse directory. The file should have the following content:
    name=RCP Developer
    id=com.instantiations.rcpdeveloper
    version=2.7.0
  3. Before starting Eclipse, delete everything in your \eclipse\configuration directory except for your config.ini file. This is to avoid a common Eclipse 3.x plugin cache bug. Launch Eclipse and open Help > Sofware Updates > Manage Configuration. Click Add an Extension Location and browse to where you saved the .eclipseextension file. For example your \RCP Developer\eclipse directory. Re-start Eclipse when prompted.


Installation using ZIP file under RAD7

Please make sure you downloaded the correct zip file version. For RAD7, you should download the zip file for Eclipse 3.2.

Using an extension location
  1. Select a location outside of your RAD installation and create an "eclipse" subdirectory. For example:  C:\Program Files\Instantiations\RCP Developer\eclipse. Unzip the files into the "eclipse" subdirectory. This will add "features" and "plugins" subdirectories to the "eclipse" directory.
  2. Next, create a text file and call it ".eclipseextension" within the "C:\Program Files\Instantiations\RCP Developer\\eclipse" directory. This file should contain the name of the product, the product id and version number.

    For Example:
    name=RCP Developer
    id=com.instantiations.rcpdeveloper
    version=2.7.0

  3. Start the IDE (RAD7) and go to Help > Software Updates > Manage Configuration. Click Add an Extension Location and browse to the C:\Program Files\Instantiations\RCP Developer\eclipse directory created earlier and click OK. Select Yes when asked to restart the IDE.

You must Register and Activate the product before you can use it for the first time.