/OpenMRS-dev-setup

quickstart dev setup for OpenMRS with virtualization

Primary LanguageVim ScriptThe UnlicenseUnlicense

OpenMRS-dev-setup

Quickstart development setup for OpenMRS via virtualization so that the host computer doesn’t get mucked up.

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

Happy Path Usage Instructions

[install dependencies]
git clone https://github.com/cpschuster/OpenMRS-dev-setup
cd OpenMRS-dev-setup
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] mvn jetty:run
[in host browser] http://localhost:8080/openmrs/
[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.