Step by step setup walk through for Linux Developer Installation

(This guide was designed for Linux Ubuntu 10.10, x86-- results may vary based on distribution and architecture)

Notice that the step named Build Maven Project below also works on Windows 7 / 64.

Prerequisites:

1. Install: Eclipse IDE for Java EE Developers

• Download: eclipse-jee-helios-SR2-linux-gtk.tar.gz (May need to select alter for latest file or architecture at http://www.eclipse.org/downloads/)

• Open terminal and  navigate to your download folder
  su – or prefix all commands with sudo

• Extract files
• tar -xvzf eclipse-jee-helios-SR2-linux-gtk.tar.gz -C /opt (varies by downloaded file name)

• Add read permissions to all files
• chmod -R +r /opt/eclipse
  Create Eclipse executable on /usr/bin path
  touch /usr/bin/eclipse
  chmod 755 /usr/bin/eclipse
   
• Open eclipse file with your favorite editor
  nano -w /usr/bin/eclipse
     (or graphically)
        gksu -u root gedit /usr/bin/eclipse
   
• Paste following content to file
  #!/bin/sh
  export ECLIPSE_HOME="/opt/eclipse"

          $ECLIPSE_HOME/eclipse $*

• Create Gnome desktop launcher
  ## Create following file, with your favorite editor ##
  /usr/share/applications/eclipse.desktop
     ( graphically)
        gksu -u roo+t gedit /usr/share/applications/eclipse.desktop
   
  ## Add following content to file and save ##
  [Desktop Entry]
  Encoding=UTF-8
  Name=Eclipse
  Comment=Eclipse SDK 3.6.1
  Exec=eclipse
  Icon=/opt/eclipse/icon.xpm
  Terminal=false
  Type=Application
  Categories=GNOME;Application;Development;
  StartupNotify=true

      2.        Make sure JDK is installed*

• sudo apt-get install openjdk-6-jdk

      3.        Make sure mysql-server is installed (Required for OpenMRS Database)*

• sudo apt-get install mysql-server

 *** NOTE: You will be prompted to create a database password, do not forget this as you need it later on!!!

Configure Eclipse and Plugins

1. Launch Eclipse EE and create a new workspace (Applications -> Programming -> Eclipse)

Install Subclipse (Plugin that integrates Subversion/SVN into Eclipse)

• Navigate to Help -> Install New Software
• In the “Work with:” text field type: “http://subclipse.tigris.org/update_1.4.x”, press “select all” packages, click next through thedialog box (accepting license agreement via checkbox), and press finish.(When complete you will be asked to restart eclipse – press yes). See optional step below if you encounter an installation dependency errors.

• NB: If the subclipse installation step above gives a dependency error on org.eclipse.draw2d, then follow similar steps to first install org.eclipse.draw2d using the "Work with:" URL "http://download.eclipse.org/tools/gef/updates/releases/". This installation step will also require a restart.  If the subclipse installation step gives a depency error on "Subclipse Integration for Mylyn 3.x (Optional)" then deselect this optional component during the subsclipse install step.
• Install Maven (Dependency and build system plugin for Eclipse)## Go back to "Help -> Install New Software"## In the “Work with:” text field type: “http://m2eclipse.sonatype.org/sites/m2e”, select all packages, click “next” through the dialog box (accepting license agreement via checkbox), and press finish. (When complete you will be asked to restart eclipse – press yes)

• Install Maven Extras## Go back to "Help -> Install New Software"## In the “Work with:” text field type: “http://m2eclipse.sonatype.org/sites/m2e-extras”, select all packages, click “next” through the dialog box (accepting license agreement via checkbox), and press finish. (When complete you will be asked to restart eclipse – press yes)

Check out Source Code from repository

** NOTE ** You might need to click on the workspace icon in the top right of Eclipse main panel to get into the Java perspective.

• Navigate to "File -> New -> Project -> Maven Drop Down -> Checkout Maven Projects from SCM"

• For the “SCM Url” dropdown menu, choose svn and type into the url text field: http://svn.openmrs.org/openmrs/trunk.##  Click advanced to expand more options. In the “Name Template”, type a project name. (We used Openmrs-trunk)## Press finish

 
** Wait for checkout to complete before proceeding.

Install OpenMRS 

• In the project explorer panel, right click on the project which has been created and navigate to “Run as → Maven Install” (this may take some time to complete)

Build Maven Project

**Review console notifications to makes sure Maven installation was successful.

• Expand the project and navigate to the “webapp” folder. Right click and select “ Run As -Maven Build”

• In the “Goals” text field enter: “jetty:run” which will start the java application server locally. 
• In the JRE tab, put in the following VM arguments: -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m
• Press the Run button

Configure OpenMRS Installation for the first time

1. Once the jetty application server is running (via Maven Build, last step), point your browser to http://127.0.0.1:8080/openmrs/initialsetup
2. http://127.0.0.1:8080/openmrs/initialsetupClick on the “Advanced” installation option and press continue.
3. Follow these configuration instructions. ## ** NOTE this is where you will need the mysql database password from before
4. You should now be able to login to OpenMRS via http://127.0.0.1:8080/

Default Login Details for your Locally hosted OpenMRS

• Username : admin
• Password : either "Admin123" or "test"

End Notes

When making most code modifications, you need to complete a Maven Install. You may cut down on compile time by skipping OpenMRS tests if desired. This can be done by creating a new run configuration for the project and typing into the “Goals” textfield the word “install”, and checking the checkbox which says “skip tests”.

Developer Setup guide created by Jon Polaski and Todd Binger of Western New England University.