Development Studio/Update Site

You can install the OpenMRS Development Tools on your existing Eclipse-based IDE from the OpenMRS update site:

http://resources.openmrs.org/eclipse/update/

Currently, only Eclipse 3.4 (Ganymede) and later version of the Eclipse 3.x stream are supported.

Instructions

1. Select Help > Software Updates... in the Eclipse workbench. The Software Updates and Add-ons dialog appears.
2. Switch to the Available Software tab.
3. Add the OpenMRS update site.
   1. Click on the Add Site... button. The Add Site dialog pops up.
   2. Paste the OpenMRS update site's URL (find it at the beginning of this page) in the Location text box.
   3. Click on the OK button.
4. You should see a picture like the one on the screenshot.
   

   
5. Select all of the available features from the update site.
6. Click on the Install... button. Wait for Calculating requirements and dependencies.
7. If you see a message box like the one on the screenshot, then proceed with the next step. Otherwise jump to step 14.
   

   
8. Click on the Yes button on the message box. The Install dialog appears.
9. Look at the Details section. There is an explanation why the install process cannot proceed. If you see that there are unsatisfied dependencies to Mylyn Trac, then you are missing another update site required by an OpenMRS feature.
10. Click on the Cancel button. You are now back to the Software Updates and Add-ons dialog.
11. Add the Mylyn Extras update site.
    1. Click on the Manage Sites... button. The Available Software Sites dialog pops up.
    2. Select the checkbox for the Mylyn Extras update site (see the screenshot).
       

       
    3. Click on the OK button.
12. Make sure that all of the OpenMRS feature are still selected.
13. Jump back to step 6.
14. You should see the Install dialog and the Next > button should be enabled.
15. Click on the Next > button.
16. Read the licenses of the software items that are going to be installed.
17. Select the I accept the terms of the license agreement.
18. Click on the Finish button. Wait for the install process to download and install of the selected features and all of their dependant plugins.
19. A message requesting you to restart the IDE pops up. Click on the OK button.
20. After the IDE restarts you will see the OpenMRS Development Tools available for use.

Activate the OpenMRS product

After installing all of the OpenMRS features from the update site you will still not see any branding on your Eclipse installation. You will also miss the OpenMRS Formatter and Code Templates. To activate the OpenMRS product:

1. Find the configuration/config.ini file and open it with a text editor.
2. Replace the following line:

eclipse.product=org.eclipse.platform.ide

with

eclipse.product=org.openmrs.devstudio.product

3. Restart your IDE. Enjoy the new branding!

Note: If you download the all-in-one package, you will have the OpenMRS branding set by default.