The OpenSRP platform includes three components OpenSRP Android Client, OpenSRP Server and OpenMRS. Each of these systems have a distinct development environment. This section includes setup instructions for each component of OpenSRP. Generally speaking, the setup involves using package managers as displayed below:
For Mac OS X 10.9.2 and later, make sure that Homebrew is installed, and use brew install [pkg]. To install a specific version of the [pkg], use brew install [pkg] --version[version]
For Ubuntu/Debian use sudo apt-get install [pkg]
For Red Hat/Fedora/CentOS use sudo yum install [pkg]
...
Easily manage (deploy new instances of or update) your OpenSRP, OpenMRS, and DHIS2 setups using the Ansible Playbooks provided here. The repository uses Ansible's recommended alternative directory layout. You will need to create host_vars and group_vars to match your setup, if you haven't already.
For local "dev" deployments, you will need to install Virtualbox. You'll need the vault password used to encrypt sensitive info in this repo.
Make sure all pip requirements are installed by running the following command. We recommend you do this in a dedicated Python virtual env:
pip install -r requirements.txt
...
Here is a list of Ansible flags you might want to add when running a playbook:
| Flag | Description |
|---|---|
| -e "certbot_ceate_certs=true" | Force the playbook to generate a new LetsEncrypt certificate and key. Only applies for sites that have been set to use LetsEncrypt certs. |
OpenSRP
Run the following command to start the OpenSRP playbook in your production environment:
...
Run the following command to start the OpenMRS DHIS playbook in your production environment:
...