Health IT in the Cloud: How to Deploy OpenMRS to Jelastic

By July 18, 2012 HowTo 9 Comments
Share on FacebookShare on Google+Tweet about this on TwitterShare on LinkedInEmail this to someone

Unfortunately the health problems are common all over the world. Health IT is the most promising tool for improving the overall quality, safety and efficiency of the health delivery system. It serves to improve health care quality, prevent medical errors, reduce health care costs, increase administrative efficiencies, decrease paperwork and expand access to affordable care.

Today we’ll show you how to deploy one of the most popular web-based electronic medical records OpenMRS to Jelastic cloud. Actually OpenMRS is both software and a community. They have come together to specifically respond to those actively building and managing health systems in the developing world, where AIDS, tuberculosis, and malaria afflict the lives of millions of people.

So let’s deploy OpenMRS to the cloud right now!

Create environment

1. Go to and sign up if you haven’t done it yet or log in with your Jelastic credentials by clicking the Sign In link on the page.

2. Ask Jelastic to create a new environment.

3. Choose the instances you want to use (for example, Tomcat 6 application server and MySQL database), set the cloudlets limit and type the name of the environment. Then click Create.
In a minute your environment will be created.

Upload Java package

1. Go to OpenMRS web-site and copy the OpenMRS Enterprise WAR Package URL address.

2. Switch back to Jelastic dashboard and upload Java WAR package using the URL you have just copied.

3. Once the package is in Jelastic, deploy it to the environment you have just created.

Do not deploy OpenMRS to the ROOT context (otherwise you will get configuration errors later on!)

Configure database

1. Click Open in browser button for MySQL.

2. While you were creating the environment, Jelastic sent you the email with credentials to the database. Create an account and the database with the application using these credentials.

Configure OpenMRS

1. Click config button for Tomcat and upload MySQL connector to the lib folder.

2. Create file in the .OpenMRS folder (home directory) and specify database connection properties there.

# OpenMRS Runtime Properties file
# (comments starting with a pound sign "#" are ignored)

### Database connection properties
### Database connection properties

# Allow/Disallow uploading of a module via the web

# If set to true, all patients will be names will be displayed as below

### Debugging options

###Customization Options
## If the custom setting is a folder, only files contained in the customization will be overwritten

### Other
## Set the directory that OpenMRS uses for its application data
## Will be used as base dir for modules, generated reports, etc
## Defaults to C:/Docs&Settings/username/Application Data/OpenMRS for windows
## Defaults to ~/.OpenMRS for *nix
## (As of build
# application_data_directory=/opt/openmrs

### The following properties are deprecated as of 1.0.43
### Properties can be modified in the Global Properties section of the webapp
###formentry.starter_xsn_folder_path=C:/Program Files/Apache Group/Tomcat/webapps/openmrs/formentry/forms/starter

3. Save the changes and restart Tomcat.

OpenMRS installation

1. When the deployment is successfully finished, launch the application in web browser. You’ll see OpenMRS setup wizard. Select the language and proceed to the next step.

2. Choose the Advanced type of installation.

3. Specify how to connect to your currently installed database server and the name of the database you have created earlier.

4. Ask OpenMRS to create the tables for your current database and specify the log in user name and password for your database user.

5. If you want to be able to upload modules from the web interface and updates to the database to be automatically applied on startup when a new web application is deployed, pick Yes.

6. Currently the default administrator user/pass is admin:test. Specify a new password for that user.

7. Step 5 is optional. You can skip it or fill in all the fields if you wish.

8. When all required input has been collected and is ready to be processed, click the finish button to create tables, data, etc.

9. In a several minutes installation will be completed and you will be taken to the OpenMRS main screen. Now you can login and start using it.

Here is a video version of the same procedure:

Be healthy!!!
Share on FacebookShare on Google+Tweet about this on TwitterShare on LinkedInEmail this to someone


  • nana says:

    hello, i can’t get my openmrs to open up in a browser. could you look at the settings for me:

    ### Database connection properties
    ### Database connection properties

    Access url :
    Login : root
    Password : K0DVWelgRW

    • Hello!
      I think the reason of the problem is your connection URL. It should be
      connection.url=jdbc:mysql:// like in the example.

      • Tru$tno1 says:

        thank you. it’s working now. Off note: I don’t understand the prcing model for hosting cyclos with jelastic. they talk abt units and prepaid. i just want to know how much it would cost me to host my cyclos environment with them for 1 year. do you have any links / leads? or any other site that offers hosting cyclos?

      • It’s difficult to predict how many resources your app needs during the year. In Jelastic you pay only for used resources. We can specify only min and max prices. But I have to know how many cloudlets your application uses now and what max limit of cluodlets you have specified when you created the environment.

    • You are welcome!
      You can find more info about our pricing model here

  • nana says:

    hello, i dont know if i have to send this to you guys or Openmrs. but when i click on Cohort Builder, i get a webpage cannot be displayed. is this a bug?

    • Hi!
      Yes, I think better to ask them, because I used their standard war file preparing this tutorial. I don’t think that something is wrong in the instruction, but if yes, please let me know.

Leave a Reply

Subscribe to get the latest updates