Project Title: LibreHealthIO/lh-toolkit
About LibreHealth:
According to the librehealth.io website about us section, "LibreHealth is a collaborative community for free & open source software projects in Health IT, and is a member project of Software Freedom Conservancy."
According to librehealth.io, LibreHealth can be described with the following terms: Meritocracy, Openness, Outcome-Driven, Transparency, Umbrella Organization, and User-Driven.
About Docker
Docker is required to use the following toolkit as suggested by the installation steps below. Docker is a software that was first released in 2013, that provides for the storage of other forms of software in "containers". The containers are hosted on a cloud based docker engine. Docker provides for increased automation and efficiency when it comes to the development of software applications.
Table of Contents Title of Project Installation Steps Credits Contributing Project Description Project Tree
Installation Steps:
The following installation instructions are utilizing an advanced installation setting and are intended primarily for software developers.
-
Complete the "Running the project" guide. https://docs.librehealth.io/projects/toolkit/guides/development/index.html#running-the-project
-
Go to the URL where the project is and select your language. localhost:8080/openmrs
-
You need MySQL database to install LH Toolkit.
-
It is recommended to use a Docker container.
-
In the terminal, type this: docker-compose -f docker-compose.dev.yml up -d db
-
Continue to install MySQL database selecting the "Advanced option".
-
Enter "toolkit" as the database name and click next.
-
On the next screen answer "no" and use the following credentials:
name: toolkit password: password
-
When asked on whether to upload modules from the web interface and enable automatic updates, answer "yes".
-
On the summary screen, make sure all information is correct, before clicking next, to finish installation.
Looking to contribute? See CONTRIBUTING.md for how to get started.
LibreHealth Toolkit is a software API and user interface components that can be used to create electronic health record systems. Read more about the project & find documentation at: http://toolkit.librehealth.io
The project tree is set up as follows:
| api/ | java and resource files for building the java api jar file. |
| puppet | Puppet scripts for local development and deployment. |
| release-test | Cucumber/selenium integration tests. Run daily against a running web application. |
| test | Maven project to share tools that are used for testing. |
| tools | Meta code used during compiling and testing. Does not go into any released binary (like doclets). |
| web/ | java and resource files that are used in the web application. |
| webapp/ | jsp files used in building the war file. |
| .gitlab-ci.yml | Used to configure Gitlab CI. Each branch can have its own configuration. |
| license-header.txt | Used by license-maven-plugin to check license on all source code headers. |
| pom.xml | The main maven file used to build and package OpenMRS. |