Prerequisites:-

• Docker installed on your pc.

• Clone Bahmni-docker into your system from https://github.com/Bahmni/bahmni-docker

• Some prior knowledge about openmrs and crater-atomfeed.

About

OpenMRS

As

OpenMRS is the

backend service on top of which Bahmni

EMR UI runs, if any patient is created in Bahmni, it will be auto-created in

Crater. So you need to check Openmrs environment variables

and ensure OpenMRS is running fine (and you can create patients in OpenMRS via Bahmni Registration screen).

About crater-atomfeed

Crater-atomfeed is the service running to connect Bahmni to crater

(it is the integration bridge between the two services). So to run crater we need crater-atomfeed also running

.

Check crater atomfeed configration (in .env file):

1. In .env file, go to

crater-atomfeed

validate the openmrs and crater

configurations.

1. Validate the database configuration of

crater-atomfeed-db

service.

About

Crater

Crater configration can be checked under crater-nginx section, mentioned port is localhost:81 (by default)

.

Currently we are using

MySQL database for crater which we can checked in docker-compose file-

>craterdb section currently running port of database can also be checked there, to change or add any

configuration change credentials under craterdb section of docker-compose file. To

validate the

creds like username and password go into .env file of bahmni-docker.

Running Crater using Docker

Now run the profile of crater using the command (note: you can also run profile bahmni-lite, which brings all services up: OpenMRS and Crater in one shot).

docker-compose --profile crater up -d

To run crater and bahmni altogether you will also need to run openmrs and crater atomfeed use the command

docker-compose --profile crater-atomfeed --profile openmrs up -d

If all (crater,crater-atomfeed and openmrs ) are up then your console will show :-

Image Modified

To Check the logs follow the steps:-

• Code Block
  language none
  docker ps | grep <name of the container whose logs you want to check>

  Image Modified

  Through the above command you will get the container ID of the container whose logs you want to check and will also show whether the container is up or not

• Code Block
  language none
  docker logs -f <CONTAINER ID>

  Image Modified

Making Code Changes to Crater Atomfeed

If during development you want to make any change in the backend code of crater-atomfeed then maven build the backend code a jar will be created paste it in Dockerfile in package->docker->Dockerfile now build the docker project using the command

docker build -t bahmni/crater-atomfeed:test -f package/docker/Dockerfile .

An image with name crater-atomfeed:test will be created now change the image in crater-atomfeed to bahmni/crater-atomfeed:test
and run the command

docker-compose --profile openmrs --profile crater --profile crater-atomfeed up -d