Below is a listing of software applications that you will need to install in order to develop on the OpenMRS Platform code base. The installation process may vary somewhat for Windows, Linux , or Mac OS X platforms. Still, the OpenMRS Platform depends mostly on Java which runs the same across those systems. This list will try to describe the software which you should install to start work on any development computer. See also where you can find videos showing the same steps. Dependencies to install Java Version is the language in which the OpenMRS Platform is written. The latest released version of the OpenMRS Platform requires at least Java version 1. You should be able to build and run supported maintenance branches with versions 1. If you plan to edit the source, you will need the ; if you plan just to run the OpenMRS Platform, you will only need the. If not, do so. Using Java version 1. MySQL is the database software most people use for the OpenMRS Platform database. You should know your MySQL root password, or have a database ready with username and password to install the OpenMRS Platform into. Install And Configure Your IDE Refer to the to either install an IDE or configure the one you have for OpenMRS development. Optional Tomcat Jetty, a development-oriented J2EE server, is automatically provided with the OpenMRS Platform 1. It is perfectly sufficient for most developer purposes. Tomcat is a J2EE server on which the OpenMRS Reference Application can be deployed. Most production installations of the OpenMRS Reference Application run on tomcat, so if you want to test against the most common environment, you should install tomcat. You will want the core that matches your system specs the closest: probably 32-bit zip or 64-bit zip or bz2 on Linux. For specific instructions for using Egit and Maven tools you have installed above, see. If you want to contribute to a module, you should check out the release branch for the module's lowest required OpenMRS Platform version e. OpenMRS began using Maven in 1. Compiling the OpenMRS Platform Use to compile and generate source files. Go to the most outer project directory and run: mvn clean install It will compile, run tests, build all artifacts and install them to your local repo. Running OpenMRS Before trying to run the OpenMRS Platform ensure you have MySQL running. Also, it is highly recommended to increase the memory available by following the steps in the setup, or see. You can now run the OpenMRS Platform by deploying the built WAR file into a J2EE container such as Tomcat or Jetty, or you can run it directly from the source code using the. The latter method is easier for developers as you can launch it from your IDE. Note: The latest version of openMRS core supports mysql 5. An error might flag if the version is below 5. Optional Module development To contributing to an existing module, you need to check out its code. If the module's source code is in Git, follow the instructions. If the module's source code is in subversion and the module is mavenized i. Older modules may be in subversion, and not yet mavenized i. To create a new module, we recommend and. After you cloned a module you need to build it with mvn clean install. The comments on the 2 sets of eclipse configuration for maven are quite confusing. I think the focus should be on the market place as a source of teh plugin... MSG Hi Rowan, I installed Eclipse Indigo + Maven today and I could successfuly install the SVN connector. I don't know if I got 32-bit or 64-bit JavaHL the openCollabnet notes suggested they might be 32-bit... Trying to install m2e extras fails with the message: Cannot complete the install because one or more required items could not be found. Software being installed: Maven SCM handler for Subclipse 0. I've edited the instructions above. Actually you don't need JavaHL bindings.. After this, u r ready to rock. Cheers, Isa I have 64 bit windows 7, and I ran into a bunch of errors when trying to set up my development environment. Here is how I fixed them all. At one point I didn't get Java HL working. I discovered that the SubVersion was 1. According to the list 1. So my first attempt to fix was to put in the newer version of SubVersion 1. But then I discovered that Maven doesn't support the newer version. What I did to get this fixed was to download eclipse and start from scratch I was unable to uninstall and then reinstall the correct versions. After getting a clean version of Eclipse, I clicked on the link to about how to download Java HL. The link for 64 bit windows was to. The trick though is to not install the version that it displays. This worked with the 1. The next error that I got was the one about the JRE. What I needed to do was download a JDK. If you read the instructions, it says you need a JDK, instead of a JRE. After installing the 1. I clicked the Add button and added the JDK for 1. That fixed the error about the JREs. I was installing plugins for eclipse indigo Ubuntu 11. No repository found containing: osgi. No repository found containing: osgi. I try to setup the dev environment again for all the latest Eclipse Indigo, I'm on Mac OS X Lion as well. I try to setup the dev environment again for all the latest Eclipse Indigo, I'm on Mac OS X Lion as well. Having problems with Subclipse and Maven SCM Handler. The version of Subclipse in the Indigo marketplace is 1. Pressed Finish Clicked on the checkbox marking it's active. After that, no more errors These instructions need some serious reworking. I just did a new install on OSX of Eclipse 3. Everything seems to be working without a hitch. Manual installation of plugins appears to be broken at the moment. Latest m2e plugin version is at 1. There are several dependencies that are unavailable anywhere else, including simpleframework and the modified version of Hibernate. This has the repository settings in it. This installation instruction is so light years behind time. Oracle is going to stop supporting JDK 1. So if I cannot install this scm plugin, there is no way I can install m2e-subclipse. These incompatibility issues probably did not exist prior to 2012. If you are new like me, this installation guide won't work for the latest eclipse. This is a work of frustration. The value is '6'. The value is '6'. Main class is required. Main class is required.
