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:
Add a DIY cartridge.
Add MySQL cartridge to the previously created one (OpenShift console -> cartridge -> Databases -> Add MySQL).
Prepare to change the cartridge:
Clone its repository:
git clone ssh://$OPENSHIFT_APP_UUID@$OPENSHIFT_APP_DNS/~/git/openmrs.git/
Move to the resulting directory:
cd $OPENSHIFT_APP_NAME/
Connect to the server (second text box on dashboard)
echo <variable name (refer to the top of the document)>
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:
curl -L http://sourceforge.net/projects/openmrs/files/releases/OpenMRS_Platform_1.10.1/openmrs.war/download -o 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
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):
mkdir diy/openmrs
echo "application_data_directory=/var/lib/openshift/$OPENSHIFT_APP_UUID/app-deployments/current/repo/diy/openmrs" > diy/openmrs/openmrs-runtime.properties
Add MySQL configuration to OpenMRS config:
echo "### 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" >> diy/openmrs/openmrs-runtime.properties
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.