OpenMRS-dev-setup

Quickstart development setup for OpenMRS via virtualization so that the host computer doesn’t get mucked up.
For express setup based on a snapshotted VM image please use branch express-setup.
If you are on a Windows machine, please also use branch express-setup.

Requires:

VirtualBox, https://www.virtualbox.org/wiki/Downloads
Vagrant, http://downloads.vagrantup.com/
Ansible, http://www.ansibleworks.com/docs/intro_installation.html

Note: OSX users will want to use the dmg’s for VirtualBox and Vagrant and the pip installation method for ansible
Note: Windows users will not need to download ansible.

Happy Path Usage Instructions

[install dependencies]
git clone https://github.com/cpschuster/OpenMRS-dev-setup
cd OpenMRS-dev-setup
[If Windows user] git checkout windows
mkdir projects
vagrant up (takes ~30 minutes)
vagrant ssh
[in guest terminal] cd Projects/OpenMRS/webapp/
[in guest terminal] mvn clean install (upon any local dev changes — not needed the first time)
[in guest terminal] sudo mvn jetty:run
[in host browser] http://localhost:8080/openmrs/
[in host browser] During OpenMRS installation, mysql root password is root_password
[in host browser] After OpenMRS installation, log in with admin/Admin123
[in host machine] Create Eclipse workspace over OpenMRS-dev-setup/projects. Take note that Java versions etc. will need to match what’s on the VM.

Setting up git + workflow tutorial

Do this after you’ve set up your environment.
Go through the steps on the wiki page: https://github.com/hypotext/OpenMRS-dev-setup/wiki/Setting-up-git,-plus-workflow-tutorial

Then go through these steps to get the webapp up and running: https://github.com/hypotext/OpenMRS-dev-setup/wiki/Running-the-OpenMRS-webapp-and-viewing-changes-in-code