Installing OpenMRS - muymoo/openmrs-core GitHub Wiki

On Mac OS:

Basically following the instructions on here... https://wiki.openmrs.org/display/docs/Installation+for+Developers+on+Mac+OS

  1. Clone this repo
  2. Build openmrs-core (mvn clean install in root directory)
  3. Download MySQL, install & start it
  • make a root user with a password
  1. Run the webapp (webapp directory, run mvn jetty:run)
  • sudo mvn jetty:run because it was installing/writing to /var (on Mac)
  • When configuring the options for the database setup, choose SIMPLE, Demo Data - YES, admin/Admin123
  • increase your mvn memory!
    • should be able to do export MAVEN_OPTS="$MAVEN_OPTS -Xms1024m -Xmx2048m -XX:PermSize=512m -XX:MaxPermSize=1024m"
    • BUT we had to actually set it in the mvn/mvn.bat file explicitly (maybe because we were running with sudo?)
  1. Login! (admin/test)

Note: Seeing this dwr-related error when the application finally successfully runs. Looks like there is a temporary fix, but I don't think it's causing problems so it can be ignored.

On Windows 7:

Directions mainly taken from here:

  1. Install Firefox
  2. Install Java 6+ runtime environment (must install before Tomcat)
  3. Install Apache Tomcat 6.0.41 and follow the directions here.
  4. Clone the OpenMRS repo: git clone https://github.com/muymoo/openmrs-core.git
  5. Install MySQL following directions here.
  6. Run the following from the root directory of OpenMRS: mvn clean install
  7. Ensure Tomcat is running (I personally navigate to where Tomcat is installed and run bin\startup.bat and follow the directions here
  • Download the latest stable release of OpenMRS as a .war file
  • In Firefox, navigate to http://localhost:8080/manager/html and login with your Tomcat administrator credentials (username and password chosen when installing Tomcat)
  • In the Tomcat Web Application Manager, enter the location of the downloaded openmrs.war file to deploy it to Tomcat
  • When the deploy finishes, /openmrs should be displayed under Applications and it should already be running
  • Now you should be able to navigate to http://localhost:8080/openmrs and OpenMRS should start the installation wizard
    • Note: I tried the Simple database install but ended up installing with no data in the database because something wouldn't work here.
  1. Now Login to OpenMRS using your credentials (admin/Admin123)