Archived Page
This page has been archived. The information on this page may not be up-to-date or maintained.
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.