Installation

For installation details, see the following:

• Installing using an update site into E-3.4 or RAD/RSA 7.5
• Installing using an update site into E-3.5
• Installation using installer (prior to 3.4)
• Installing from ZIP file into Eclipse 3.4 & 3.5
• Installing from ZIP file into Eclipse, WSAD, RAD 6.0 or RAD 7.5 (not 7.0)
• Installing from ZIP file into RAD 7.0
• Installing CodePro Server
• Using the Eclipse 2.x Update Manager
• Product Registration and Activation
• Problems after installation
  

Download an installer that is appropriate for your operating system. In MS Windows download the *.exe installer. In Linux, download the *.bin installer. The installer can be used to install the product into Eclipse 2.1 - 3.3, WebSphere Studio 5.1 and Rational Application Developer 6.0 or 7.0.

Note: If you encounter problems running the installer, see this FAQ entry.

Welcome Launch the installer The first page is a Welcome page. It allows you to verify that you are indeed running the CodePro 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 CodePro to be 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 CodePro. 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.1, 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 CodePro into as many versions at once as you like. They will all share a single product installation.  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.   The product will be installed into the specified directory and .link files will be created in your eclipse/links directory.

When you the IDE first starts up with CodePro installed, you will see the CodePro license dialog. Click the Activate CodePro button to open the Activation Wizard.

Installing into Eclipse 3.4 & 3.5

1. Using the Dropins folder - Unzip the file into a new directory within your Eclipse \dropins directory. Your \dropins directory structure should  look something like this:
               \dropins
                       \codepro
                           \eclipse
                               \features
                               \plugins
   
   See the Eclipse wiki page for a list of supported dropins format.
   
2. Using a local update site - Unzip the file into a new directory. Open the Software Updates... dialog from the Help menu. Open the  Available Software tab, click the Add Site... button and add a Local site pointing to where you unzipped the file. This will copy the files into your eclipse features and plugins directories.
   

Note that if you are installing into Rational Application Developer 7.0, you must use the full installer or follow these alternate instructions for installing the ZIP file.

If you are installing into Eclipse 3.0, you should also delete your <Eclipse>/configuration directory before re-starting Eclipse (it is recreated at startup). This is to avoid a common Eclipse 3.x plugin cache bug. The Full Installer can do this for you automatically. If you are installing into Eclipse 3.1, 3.2 or 3.3, delete everything in the "configuration" directory except the config.ini file and the org.eclipse.update/platform.xml file (Eclipse 3.2 and above). You should also keep your org.eclipse.update/bookmarks.xml file (Eclipse 3.1 and above) in order to preserve your update site bookmarks.

Option 2: If you would rather unzip into a location external to Eclipse, select a location and create a "codepro" directory with an "eclipse" subdirectory. As an example, you might end up with the following directory structure.

C:/Program Files/Instantiations/codepro/eclipse

After creating this nested directory structure, unzip the ZIP file into the "eclipse" subdirectory while making sure to preserve the folder structure within the ZIP file. This will add add "features" and "plugins" subdirectories to the "eclipse" directory which will in turn hold the product feature and plugin directories.

Next, you will need to create an ".eclipseextension" file within the "codepro/eclipse" directory. This file should contain the following lines:

name=CodePro
id=com.instantiations.assist.eclipse
version=6.1.0

Finally, you will need to manually create a file titled "com.instantiations.assist.eclipse.link" in your main  <Eclipse>/links directory that contains a single line specifying the full path to the main product directory (e.g., the directory containing the "eclipse" subdirectory). For example:

path=C:/Program Files/Instantiations/codepro

Note that if you use the CodePro installer and choose the default installation location, the installer will create multiple link files that looks like the following:

path=C:/Program Files/Instantiations/<CodeProFeatureName>_6.1.0/E-3.3

When you the IDE first starts up with CodePro installed, you will see the CodePro license dialog. Click the Activate CodePro button to open the Activation Wizard.

C:/Program Files/Instantiations/codepro/eclipse

After creating this nested directory structure, unzip the ZIP file into the "eclipse" subdirectory while making sure to preserve the folder structure within the ZIP file. This will add add "features" and "plugins" subdirectories to the "eclipse" directory which will in turn hold the product feature and plugin directories.

Next, you will need to create an ".eclipseextension" file within the "codepro/eclipse" directory. This file should contain the following lines:

name=CodePro
id=com.instantiations.assist.eclipse
version=6.1.0

Start the IDE and go to Help > Software Updates > Manage Configuration. Click Add an Extension Location and browse to the codepro/eclipse directory created earlier and click OK. Select Yes when asked to restart the IDE.

Click OK to see the list of pending changes.

Click the checkbox corresponding to the new configuration and click the Finish button. The system will offer to restart the workbench so that the changes will take effect. Click Yes to complete the CodePro installation.