Page tree
Skip to end of metadata
Go to start of metadata

This is an abbreviated version of the guide seen here and is used in the video here.

This file is available for download here.

This guide is a reference for users to copy and paste from when installing OpenMRS on OpenShift.

$OPENSHIFT_APP_UUID: 

$OPENSHIFT_APP_NAME: 

$OPENSHIFT_MYSQL_DB_USERNAME:

$OPENSHIFT_MYSQL_DB_PASSWORD: 

$OPENSHIFT_MYSQL_DB_HOST: 

 $OPENSHIFT_MYSQL_DB_PORT: 

 

Connecting to the server: rhc ssh $OPENSHIFT_APP_NAME

 

Add a DIY cartridge.

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

 

Clone the repository: 

Use link from OPENSHIFT Dashboard

git clone <link>

 

Move to the resulting directory:

cd $OPENSHIFT_APP_NAME/

 

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

git remote add tomcat-upstream -m master git://github.com/openshift-quickstart/openshift-tomcat-quickstart.git

git pull -s recursive -X theirs tomcat-upstream master

git push

 

Deploy OpenMRS to server:

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

Download http://sourceforge.net/projects/openmrs/files/releases/OpenMRS_Platform_1.10.1/openmrs.war/download

Move it to this directory: diy/tomcat/webapps/openmrs.war

 

git add diy/tomcat/webapps/openmrs.war

git commit -m “Deployed OpenMRS Platform 1.10.1”

git push

 

Configure OpenMRS on low level:

ssh to the server

using rhc command line tools: rhc ssh $OPENSHIFT_APP_NAME

 

echo "/var/lib/openshift/$OPENSHIFT_APP_UUID/app-deployments/current/repo/diy/openmrs/openmrs-runtime.properties" > .env/user_vars/OPENMRS_RUNTIME_PROPERTIES_FILE

 

Exit the server

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

Make the folder openmrs inside the diy folder

 

echo “” > diy/openmrs/openmrs-runtime.properties

  

Add MySQL configuration to OpenMRS config:

Copy paste this into the file diy/openmrs/openmrs-runtime.properties (delete the quotation marks that are there)

 

application_data_directory=/var/lib/openshift/$OPENSHIFT_APP_UUID/app-deployments/current/repo/diy/openmrs

### Database connection 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

 

Commit and push the changes:

git add diy/openmrs/openmrs-runtime.properties

git commit -m “Configured OpenMRS”

git push

 

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

  • No labels