Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cu 86bzx5kf7 create platform installation section #300

Merged
merged 2 commits into from
Aug 12, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 64 additions & 1 deletion documentation/installation/jembi-platform-installation.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,66 @@
# Jembi Platform Installation

(Coming soon)
## Prerequisites <a href="#_4a1yqprqttyw" id="_4a1yqprqttyw"></a>

In the following, we will introduce the software prerequisites to be able to run the client registry jempi on your machine using the platform.

### Docker <a href="#_rglemv3fug4d" id="_rglemv3fug4d"></a>

Please refer to the [official installation guide](https://docs.docker.com/engine/install/ubuntu/) in order to install docker on your machine.
It is best to follow the post installation process so that you grant docker sudo access.

### \[for Windows users] WSL2 <a href="#_ku1gqbfaemlj" id="_ku1gqbfaemlj"></a>

Installing WSL2 is required to be able to develop and test the project.\
It is recommended to limit the memory usage of WSL2.

## Local Setup <a href="#_k8o7yc6w0hnu" id="_k8o7yc6w0hnu"></a>

```bash
git clone https://github.com/jembi/platform.git && cd platform/
```

1. Create /tmp/logs directory
```bash
sudo mkdir -p /tmp/logs/
```
2. Create the docker platform image
```bash
./build-image.sh
```
3. Initialise Docker Swarm
```bash
docker swarm init
```
4. Run 'go cli' binary to launch the project
```bash
./get-cli.sh
```
5. Launch the client registry jempi package profile \
a. all packages and profiles are configured in the ./config.yaml field \
b. updates to environment variable can be made in the profile env file ie: mpi.env
```yaml
- name: mpi
packages:
- interoperability-layer-openhim
- reverse-proxy-nginx
- message-bus-kafka
- job-scheduler-ofelia
- monitoring
- client-registry-jempi
- identity-access-manager-keycloak
- openhim-mapping-mediator
envFiles:
- mpi.env
```
```bash
./instant-linux package init -p mpi
```

6. Access : http://localhost:3033/login

![JeMPI Web Keycloak Sign in](../.gitbook/assets/16)

7. Sign in with Keycloak user credentials

![JeMPI Web Keycloak Sign in](../.gitbook/assets/17)