What needs to be Updated in the Step by Step Installation for Developers document?

1

Hi @herbert24, @burke

As part of the GSoD 2020 project, I am working on updating Step by Step Installation for Developers

My questions are:

  1. Is there a reason why we need to install MySQL manually? Is it better to use Docker to install MySQL?
  2. Under what conditions do we need to install OpenMRS platform by compiling from source code? Does it make sense to install OpenMRS SDK instead?
2

Docker is simply a container that comes with different applications for example mysql,we have possibilities of users not requiring a container ie docker and they simply need to install mysql without having knowledge of docker.

We have two things here,openmrs platform and openmrs reff app. openmrs reff app comes with a User interface while openmrs platform is simply (the “plumbing”) upon which all distributions of openmrs are based ie no interface.These two can be installed using different ways for example

1)Using the sdk

2)Using standalone packages

If need be,we can try to install these and you get a feel of them,kindly ping me here .cc @jennifer

3

@herbert24 Thanks for replying. I have tried to install stand alone OpenMRS platform before. But I probably will have question about the “Module development” part.

4

I would guess those steps were created before we had the SDK or Docker.

1 Like
5

@rainbow , my understanding , i would say it depends on the purpose of running OpenMRS

  • for demo/testing purposes , running a standalone or using docker is better
  • For development purposes , running by SDK or Compiling from source code is fair
1 Like
6

Thanks @rainbow ,My thinking is that the steps should not be basing on side especially installing mysql, actually better to include all the flavours including different ways of installations procedures for different operating systems(eg macOs, Linux, windows) this gives the better coverage

1 Like
7

Does it matter how MySQL is installed?

1 Like
8

I think the solution should be: write each installation method for each software separately, so that they can be assembled like LEGO blocks into this kind of step by step document.

9

well good question ,
i think that could also depend on a number of factors ,

you realise that for demo porposes , one doesn’t have to install MySQL manually at all , that is in the case of running a standalone or using a direct complete docker-compose file

10

Actually i would also consider if we could have a community project to build a pre-installed OpenMRS Virtual (Vagrant) Box , i know that will be more or less like a standalone.

1 Like
11

Could you share any more information about this!

12

in summary , Virtual Machine(VM) pre-installed with OpenMRS.

13

My question is: if new developers set up their systems by installing MySQL with Docker , and then intalling OpenMRS SDK(as this combination is relatively easy and fast), will this setup be sufficient for them to start developing, will this cause any problem for testing, or deploying modules down the road?

14

To simplify, what is a minimal viable development environment setup for new developers ?

15

i go with the sdk cc @burke @dkayiwa @mozzy

1 Like
16

SDK & Docker for module/backend development.

Likely VS Code & npm for frontend development. But you can focus on module development for now.

3 Likes
17

Thanks! This helps a great deal.

1 Like