OpenShift Quickstart Cartridge

Owned by Dmitrii Volkov
Last updated: Aug 29, 2024 by aahil
1 min read

For those looking to deploy OpenMRS on OpenShift, using a quickstart cartridge is an efficient option, especially for demo purposes. This method allows you to get OpenMRS up and running in just a few minutes.

Step-by-Step Guide

1. Add a DIY Cartridge

Start by adding a DIY cartridge to your OpenShift project. This will serve as the base for your OpenMRS installation.

2. Add MySQL Cartridge

Next, you need to add a MySQL cartridge to the previously created DIY cartridge. You can do this through the OpenShift console:

  • Navigate to Cartridge -> Databases -> Add MySQL.

3. Prepare to Change the Cartridge

You’ll now need to clone the repository of your cartridge to make the necessary modifications.

  • Clone the Repository:

    git clone ssh://$OPENSHIFT_APP_UUID@$OPENSHIFT_APP_DNS/~/git/openmrs.git/

  • Navigate to the Cloned Directory:

    cd openmrs/

4. Deploy the Quickstart Cartridge

To set up OpenMRS, you need to deploy the quickstart cartridge. Follow these steps:

  • Add the Quickstart Repository as an Upstream Remote:

    git remote add upstream -m master git@github.com:ixWDE4eR/openshift-openmrs-quickstart.git

  • Merge the Quickstart Repository:

  • Push the Changes:

5. Restart the Cartridge

After deploying the quickstart cartridge, restart the cartridge to apply the changes.

6. Configure OpenMRS via Browser

Finally, proceed to the high-level configuration of OpenMRS through your web browser.

Do not select 'Simple' as the type of installation, as it assumes access to MySQL root credentials and other settings that may not be suitable for this deployment.

Related articles