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

| July 18, 2012

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!!!