ID: S202604201528
Status: school
Tags: Linux

installing OpenMRS (for school)

Voor deze tutorial assume ik dat je op een van van Linux zit, persoonlijk gebruik ik Ubuntu.

1. Installeer docker en docker compose
2. git clone git@github.com:openmrs/openmrs-distro-referenceapplication.git
3. voeg een .env toe die er zo uit ziet, je hoeft die <...> blokhaakjes niet te vervangen:

# Gebruik 'qa' voor de laatste stabiele builds of 'latest' als je je te goed voelt. Getest met 3.5.0  
TAG=3.5.0  
  
# DB config en credentials  
OMRS_DB_USER=<db gebruiker, default openmrs>  
OMRS_DB_PASSWORD=<db wawo, default openmrs>  
MYSQL_ROOT_PASSWORD =<db root wawo, default openmrs>

4. Voeg de volgende lijn toe in de docker-compose.yml aan de environment van de backend service:

environment:  
   OMRS_DEV_DEBUG_PORT: "5005"

5. Voeg de volgende lijn toe in de docker-compose.yml aan de ports bovenaan toe:

ports:  
   "5005:5005" # Debug port

6. run dan in de root docker compose -f docker-compose.yml up -d --remove-orphans, dit kan zo’n 3m duren om de images te downloaden
7. ga naar http://localhost/openmrs
   • De eerste keer kom je in een ‘initial setup’ scherm. Soms blijft deze hangen. Als na 10 minuten dit scherm nog steeds actief is herstart dan de services (docker compose down && docker compose up)
   • Als alles goed is gegaan kom je bij een login scherm.
8. Log in, default Credentials: admin / Admin123

De SPA (React) GUI is benaderbaar via http://localhost/openmrs/spa

Got issues?

I personally had the issue on my laptop that I got a 502 error when connecting to the website, and that the backend container stayed in the “starting” status.

Maar dit issue heb ik niet op mn laptop wnnr ik de debug stuff uit zet. maar school zegt dat dat belangrijk is dus ben op zoek naar een workaround.

Het toevoegen hiervan aan de environment van de backend kan helpen:

    environment:
      OMRS_DEV_DEBUG_PORT: "5005"
      JAVA_TOOL_OPTIONS: "-Djava.net.preferIPv4Stack=true"

---

References

• Opdracht van de les van vnadaag.
• dit is de guide op brightspace.