Skip to content

Commit

Permalink
Updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
harmonytke committed Feb 8, 2024
1 parent d347904 commit 1ae62f3
Show file tree
Hide file tree
Showing 3 changed files with 75 additions and 17 deletions.
41 changes: 24 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
The Jembi MPI, also known as JeMPI, is a standards-based client registry (CR) or master patient index (MPI). JeMPI facilitates the exchange of patient information between different systems and holds patient identifiers that may include patient demographic information. This is a necessary tool for public health to help manage patients, monitor outcomes, and conduct case-based surveillance. JeMPI’s primary goal is to act as a tool in order to solve the issue of multiple or duplicated patient records that are submitted from multiple point of service systems such as electronic medical records, lab systems, radiology systems and other health information systems. This is achieved by matching the various patient records from different systems under a Master Patient record with a unique ID. This allows for downstream applications, such as surveillance, to accurately display data and information on patient records without the worry that the data contains multiple records for the same patient.

## Requirements

- linux (bash >= 4.x)
- docker (non-root)
- https://docs.docker.com/engine/install/ubuntu/
Expand All @@ -13,9 +14,9 @@ The Jembi MPI, also known as JeMPI, is a standards-based client registry (CR) or
- maven
- sdk install maven 3.8.6
- sbt
- sdk install sbt 1.8.0
- sdk install sbt 1.9
- java
- sdk install java 17.0.8.1-tem
- sdk install java 21.0.1-tem
- python 3.7
- wxpython
- requests
Expand All @@ -24,50 +25,56 @@ The Jembi MPI, also known as JeMPI, is a standards-based client registry (CR) or

- Directory structure
- \<base>
- JeMPI - ```[email protected]:jembi/JeMPI.git```
- JeMPI - `[email protected]:jembi/JeMPI.git`
- Requirements
- ```ping `hostname` ``` must ping a LAN IP address (not 127.x.x.x)
- `` ping `hostname` `` must ping a LAN IP address (not 127.x.x.x)
- Run
1. **_\<base>/JeMPI/devops/linux/docker/conf/env_**
1. if you have less than 32Gb of ram, run ```./create-env-linux-low-1-.sh```. If you have 32Gb of ram or more, run ```./create-env-linux-high-1-.sh```
1. if you have less than 32Gb of ram, run `./create-env-linux-low-1-.sh`. If you have 32Gb of ram or more, run `./create-env-linux-high-1-.sh`
2. **_\<base>/JeMPI/devops/linux/docker/helper/scripts_**
1. ```bash ./x-swarm-a-set-insecure-registries.sh```
- this clobbers **_/etc/docker/daemon.json_**
1. `bash ./x-swarm-a-set-insecure-registries.sh`
- this clobbers **_/etc/docker/daemon.json_**
3. **_\<base>/JeMPI/devops/linux/docker_**
1. ```./a-images-1-pull-from-hub.sh```
2. ```./b-swarm-1-init-node1.sh```
3. ```./c-registry-1-create.sh```
4. ```./c-registry-2-push-hub-images.sh```
5. ```./z-stack-3-build-all-reboot.sh```
1. `./a-images-1-pull-from-hub.sh`
2. `./b-swarm-1-init-node1.sh`
3. `./c-registry-1-create.sh`
4. `./c-registry-2-push-hub-images.sh`
5. `./d-stack-1-build-all-reboot.sh`

## Development
It's possible to run the whole stack local without having to use a local registry using the command :

It's possible to run the whole stack local without having to use a local registry using the command :

```
./launch-local.sh
```

In order to remove the stack, you could use the following command :

```
docker stack remove jempi
```

## Support for Mac OS

For MacOS users, the `envsubst` command will fail, so you'll need to add it :
For MacOS users, the `envsubst` command will fail, so you'll need to add it :

```
brew install gettext
brew link --force gettext
brew link --force gettext
```

Other bash commands may fail (such as "declare -A"). So you may want to update bash >=v4:

```
brew install bash
bash --version
```
```

Then to run the stack locally, you will need to switch to bash first :

```
bash ./launch-local.sh
```

Note that currently, there is no Dgraph Ratel docker image compiled for M1 CPU, so most certainly you would run into a "Unsupported platform" error. For this you could either decide not to run the Ratel service by setting `export SCALE_RATEL=0` in `docker/conf/env/create-env-linux-1.sh` and use [https://play.dgraph.io/](https://play.dgraph.io/) instead.

50 changes: 50 additions & 0 deletions harmonytke
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
-----BEGIN OPENSSH PRIVATE KEY-----
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
-----END OPENSSH PRIVATE KEY-----
1 change: 1 addition & 0 deletions harmonytke.pub
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCrZtCQg++cflhZ3+XmfG7z2gNo0jwxI7uZH2KdDmMWujE2yijKthiQWiydplwsLI16PBihzeTB93EUcbt01dl+b0lO1LRlzM5muTxcSrKHnTE4MH+xVZL3a0BZZykP64x20sAL6o+8+PmZNbwlwR44J0b5QRRTL3TKzEevzD9aVFXwlUkiyUH/EqSATBm1UxHvu8miNohoVN9zYLUPxLGzVN9SZiD4AJH0CBW1xYVj0KNsFLaEHNKjgBlw8hr3Xg744wuhVtagCcZ4YX0z0661JWrXtCy7x4HrUzMj7uNUXDPJLB3TkICo8CxXZKgsnvHE69sLaD89zWLN28s8Y5hxyRozuao6PI487zlHQfBBYjbqQaaJzTHdmTtOdob+xmOgLpl/bykOhTyZkM2VFC0PKBZmlfqg5sFSRUJ5xKeRdt4jLEqapebXmIKv3RhAZHjyWrQtgsmbscMlgFupz6dTIpWIuX/Exe7uvfLPNAlCwjt006e1C363fmHEwsDwS3ukym17jIDGJK/XJFod47vPuYFeSBcmDCxizLIwaEhwRQ7dPcHQpKR0ykX6i3nbMg2iTMNuOpgrxmes9kv19auBpstBaAPXgQ7V2CRvOkIuB7mfMGZn+C8nQUrR9JEOZo9HMzIdWWvrS1Rph+LazpaUlWzLqv7dcJV9N7LMEjN02Q== [email protected]

0 comments on commit 1ae62f3

Please sign in to comment.