Installing Older Versions of Clover-for-Eclipse

Installation

1. Installing the plugin

You can either install the Clover Eclipse plugin from the live Clover Eclipse update site or alternatively from a zipped archive of the Clover Eclipse update site you download manually. 

1a. Installing the plugin from the live Clover Eclipse update site

1. Within Eclipse, select from the menu "Help | Software Updates | Find and Install" to start the installation process.
2. Select "Search for new features to install" and click the "Next" button to continue.
3. Click the "New Remote Site..." button, provide a name of "Clover Update Site" and a URL of http://update.atlassian.com/eclipse/clover click the "Finish" button. This will point Eclipse to the Clover update site from where it will download the plugin.
4. Select the entry "Clover Update Site" (and all its children elements) and click the "Next" button to select the Clover plugin for installation.
5. If you agree, accept the license agreement by clicking the "Next" button.
6. The next screen allows you to install the features/plugins to a directory of your choice (known as an Eclipse extension areas). If you intend on installing them anywhere other than your main Eclipse installation area, please read this FAQ entry first. Click "Finish" to start download process.
7. You will then be prompted to confirm installation of the Clover plugin's various parts. The Clover plugin is not digitally signed so you may encounter a warning to this effect - please ignore this warning. Click "Install" to proceed with the installation.
8. You will then be prompted to allow Clover to modify your Eclipse installation's config.ini file. This is required for correct operation of the plugin. If you wish to perform this step yourself you should press "Skip" and the follow the instructions in step 3 below, otherwise click "Proceed".
9. Finally, you will be asked if you want to restart Eclipse after installing the plugin. Click "Yes" to restart to complete installation.

1b. Installing the plugin from a downloaded archive of the Clover Eclipse update site

1. Download the Clover Eclipse update site archive from the Clover downloads page
2. Within Eclipse, select from the menu "Help | Software Updates | Find and Install" to start the installation process.
3. Select "Search for new features to install" and click the "Next" button to continue.
4. Click the "New Archived Site..." button, provide a name of "Clover Update Site Archive" and a select the location of the downloaded update site archive ; click the "Finish" button.
5. Select the entry "Clover Update Site Archive" (and all its children elements) and click the "Next" button to select the Clover plugin for installation.
6. If you agree, accept the license agreement by clicking the "Next" button.
7. The next screen allows you to install the features/plugins to a directory of your choice (known as an Eclipse extension areas). If you intend on installing them anywhere other than your main Eclipse installation area, please read this FAQ entry first. Click "Finish" to start download process.
8. You will then be prompted to confirm installation of the Clover plugin's various parts. The Clover plugin is not digitally signed so you may encounter a warning to this effect - please ignore this warning. Click "Install" to proceed with the installation.
9. You will then be prompted to allow Clover to modify your Eclipse installation's config.ini file. This is required for correct operation of the plugin. If you wish to perform this step yourself you should press "Skip" and the follow the instructions in step 3 below, otherwise click "Proceed".
10. Finally, you will be asked if you want to restart Eclipse after installing the plugin. Click "Yes" to restart to complete installation.
    

2. Installing the license

1. Obtain a valid trial, purchased or opensource license for Clover 2.
2. Within Eclipse, select from the menu "Window | Preferences" and click on Clover > License.
3. Paste the contents of your license file into the license text area or select your license file by clicking "Load...".
4. Click Apply. The license summary should now display status, type and message consistent with the type of license you entered.
5. Click OK to close the window.

3. (Optional) Manually updating config.ini

If you selected "Skip" when Clover asked for permission to modify config.ini then you need to make this change yourself for Clover to operate correctly.

• Shut down your Eclipse instance.
• Using a file browser or the command line, go to your Eclipse installation directory and locate the sub-directory named configuration.
• Locate the file config.ini - now make a backup of it - either in the configuration directory or somewhere safe.
• Add the following line to the configuration file:

  osgi.framework.extensions=com.cenqua.clover.hooks
  

• If the file already contains a line starting with "osgi.framework.extensions=" then add ",com.cenqua.clover.hooks" to the end of it. For example, for a line such as this:

  osgi.framework.extensions=some.other.value
  

  you would change it to this

  osgi.framework.extensions=some.other.value,com.cenqua.clover.hooks
  

• It is very important that this line be added before the end-of-file marker

  eof=eof
  

  Adding this new line after this point will cause your Eclipse instance to no longer start.

Uninstallation

1. Uninstalling the plugin

1. To uninstall the plugin, from the Eclipse menu select "Help | Software Updates | Manager Configuration". Find the Clover features in the tree - there should be three: "Clover 2 (for Eclipse 3.2/3.3)", "Clover 2 Ant Support (for Eclipse 3.2/3.3)" and "Clover 2 JDT Hooks (for Eclipse 3.2/3.3)". If you installed the beta 1 release then "Clover 2 JDT Hooks (for Eclipse 3.2/3.3)" will be a child of "Clover 2 (for Eclipse 3.2/3.3)". For the beta 2 release and beyond all three features are at the same level in the tree.
2. Select all three, right click and select Uninstall. Click OK to confirm you want to proceed with the uninstall and disable the features.
3. You will then be prompted to allow Clover to modify your Eclipse installation's config.ini file. This is required to remove the Clover integration with the Eclipse compiler. If you wish to perform this step yourself you should press "Skip" and the follow the instructions in step 2 below, otherwise click "Proceed".
4. Finally, you will be asked if you want to restart Eclipse after installing the plugin. Click "Yes" to restart to complete uninstallation.

2. (Optional) Manually updating config.ini

If you selected "Skip" when Clover asked for permission to modify config.ini then you need to make this change yourself to completely remove Clover from your Eclipse installation.

• Shut down your Eclipse instance.
• Using a file browser or the command line, go to your Eclipse installation directory and locate the sub-directory named configuration.
• Locate the file config.ini - now make a backup of it - either in the configuration directory or somewhere safe.
• Find the line of the configuration file that begins like follows:

  osgi.framework.extensions=
  

• If, after the equals sign, the line only has the value com.cenqua.clover.hooks then remove the line completely.
• If, after the equals sign, the line has com.cenqua.clover.hooks as well as other values then remove com.cenqua.clover.hooks but be sure that the remaining values are properly comma separated. For example, for a line such as this:

  osgi.framework.extensions=some.other.value,com.cenqua.clover.hooks,some.other.value.two
  

  you would change it to this:

  osgi.framework.extensions=some.other.value,some.other.value.two
  

• If this line is not present at all in the file then no changes are necessary.