Page Comparison

OpenShift is a PAAS by RedHat one may use for easy OpenMRS deployment with low initial cost and easy scaling. Unlike IAAS (VDS such as EC2) it does not require manual server administration - one may just deploy an app, while care of hosting management is taken by RedHat.

...

Commands specified are valid for *nix environment, adaptation to others is trivial though.

Anchor
video video

Video Guide: Deploying OpenMRS on OpenShift on Mac or Linux

Installing OpenMRS on OpenShift - Abbreviated for Mac and Linux

Anchor
video video

Video Guide: Deploying OpenMRS on OpenShift on Windows

Installing OpenMRS on OpenShift - Abbreviated for Windows

Step-by-step guide

1. Add a DIY cartridge.

2. Add MySQL cartridge to the previously created one (OpenShift console -> cartridge -> Databases -> Add MySQL).

3. Prepare to change the cartridge:

   1. Clone its repository: 

      1. ^git

...

1. 1. 1. ^clone

...

1. 1. 1. ^{ssh://$OPENSHIFT_APP_}

...

1. 1. 1. ^{UUID@$OPENSHIFT_APP_DNS/~/git/openmrs.git/}

   2. Move to the resulting directory:

      1. ^cd

...

1. 1. 1. ^openmrs/

2. Deploy custom Tomcat (Custom here means not the default one for OpenShift. In fact, this variant is upstream.)

   1. ^git

...

1. 1. ^remote

...

1. 1. ^add

...

1. 1. ^{tomcat-upstream}

...

1. 1. ^-m

...

1. 1. ^master

...

1. 1. ^{git://github.com/openshift-quickstart/openshift-tomcat-quickstart.git}

   2. ^git

...

1. 1. ^pull

...

1. 1. ^-s

...

1. 1. ^recursive

...

1. 1. ^-X

...

1. 1. ^theirs

...

1. 1. ^{tomcat-upstream}

...

1. 1. ^master

   2. ^git

...

1. 1. ^push

   2. Check if Tomcat has started successfully by visiting your server via browser (URL is written on cartridge's page in console).

2. Deploy OpenMRS to server:

   1. Download the app archive (version specified here is the most recent one by the time of writing) into tomcat webapps directory:

      1. ^curl

...

1. 1. 1. ^-L

...

1. 1. 1. ^{http://sourceforge.net/projects/openmrs/files/releases/OpenMRS_Platform_1.10.1/openmrs.war/download}

...

1. 1. 1. ^-o

...

1. 1. 1. ^{diy/tomcat/webapps/openmrs.war}

   2. ^git

...

1. 1. ^add

...

1. 1. ^{diy/tomcat/webapps/openmrs.war}

   2. ^git

...

1. 1. ^commit

...

1. 1. ^-m

...

1. 1. ^'Deployed

...

1. 1. ^OpenMRS

...

1. 1. ^Platform

...

1. 1. ^1.10.1'

   2. ^git

...

1. 1. ^push

   2. Check if it has started succesfully by

...

1. 1. visiting http://$OPENSHIFT_APP_DNS/

...

1. 1. openmrs (default path).

2. Configure OpenMRS on low level

...

1. :

...

1. 1. Set proper OpenMRS configuration file path (via env var (see Overriding OpenMRS Default Runtime Properties)):

      1. ssh to the server

      2. ^echo

...

1. 1. 1. ^{"/var/lib/openshift/$OPENSHIFT_APP_UUID/app-deployments/current/repo/diy/openmrs/openmrs-runtime.properties"}

...

1. 1. 1. ^>

...

1. 1. 1. ^{.env/user_vars/OPENMRS_RUNTIME_PROPERTIES_FILE}

      2. Exit the server

   2. Set proper app data directory (default is ~/.OpenMRS; these commands are to be run in the git repository associated with your cartridge):

      1. ^mkdir

...

1. 1. 1. ^diy/openmrs

      2. ^echo

...

1. 1. 1. ^{"application_data_directory=/var/lib/openshift/$OPENSHIFT_APP_UUID/app-deployments/current/repo/diy/openmrs"}

...

1. 1. 1. ^{> diy/openmrs/openmrs-runtime.properties}

   2. Add MySQL configuration to OpenMRS config:

      1. ^echo

...

1. 1. 1. ^"###

...

1. 1. 1. ^Database

...

1. 1. 1. ^connection

...

1. 1. 1. ^{properties
         connection.username=$OPENSHIFT_MYSQL_DB_USERNAME
         connection.password=$OPENSHIFT_MYSQL_DB_PASSWORD
         connection.url=jdbc:mysql://$OPENSHIFT_MYSQL_DB_HOST:$OPENSHIFT_MYSQL_DB_PORT/$OPENSHIFT_APP_NAME?autoReconnect=true"}

...

1. 1. 1. ^{>> diy/openmrs/openmrs-runtime.properties}

   2. Commit and push the changes:

      1. ^git

...

1. 1. 1. ^add

...

1. 1. 1. ^{diy/openmrs/openmrs-runtime.properties}

      2. ^git

...

1. 1. 1. ^commit

...

1. 1. 1. ^-m

...

1. 1. 1. ^'Configured

...

1. 1. 1. ^OpenMRS'

      2. ^git

...

1. 1. 1. ^push

2. Proceed to high-level OpenMRS configuration via browser. You should not select 'Simple' as type of installation as it assumes having MySQL root, etc.

Related articles

...