Let’s Coordinate - Getting started



1. Prerequisites

To use Let’s Coordinate, you need a linux OS with the following:

2. Setup and run Let’s Coordinate

2.1. Clone Let’s Coordinate project

To start Let’s Coordinate, you first need to clone the letscoordinate git project:

git clone https://github.com/opfab/letscoordinate.git

2.2. Run Operator Fabric

/!\ The minimal required version of OperatorFabric is: 1.7.0.RELEASE

Clone the operatorfabric-getting-started git project:

git clone https://github.com/opfab/operatorfabric-getting-started.git

Copy files “docker-compose.yml”, “favicon.ico”, “ngnix.conf” and “web-ui.json” from “letscoordinate/test/prepare-opfab-env/opfab-config” directory and past them into “operatorfabric-getting-started/server”. Overwrite the existing files when asked!

In the directory “operatorfabric-getting-started/server” launch the following command:

./startServer.sh 

You need to wait for all the services to start (it usually takes one minute to start), it is done when no more logs are written on the output (It could continue to log but slowly).

2.3. Run Let’s Coordinate backend

In a new terminal, position yourself in the “letscoordinate/bin” directory and run the following command:

./run_letscoos.sh

This will start running the docker containers Kafka (port 9092), Zookeeper (port 2181), MariaDB (port 3306), the letsco-data-provider application (port 8082) and letsco-api application (port 8088).

2.4. Run Let’s Coordinate frontend

In a new terminal, change directory to the “letscoordinate/letsco-front” module and execute the following commands:

npm install
ng serve

2.5. Prepare the environment

a. Update the OpFab database

Download the latest karate.jar from Karate github release page

Put it in the “letscoordinate/test/prepare-opfab-env” directory, rename it to “karate.jar” to use it easily.

Position yourself in the “letscoordinate” root directory and run the following command:

./test/prepare-opfab-env/prepare-opfab-env.sh

This will create a new group, a new entity, and a new user associated to this group and this entity in the operator-fabric database, and will send the bundles to display the cards in OperatorFabric.

b. Add the user to keycloak

3. Use Let’s Coordinate

3.1. Send a new notification

If you connect to OpFab (http://localhost:2002/ui/) with the user previously created in Keycloak, you should see the new card in the Feed.

Feel free to test the other json samples from the directory “letscoordinate/message_models/json/card_feed/

3.2. Generate a RSC KPI report

4. Stop the application

To stop the application, we should start by stopping OperatorFabric and then Let’s Coordinate.

4.1. Stop OperatorFabric

To stop OperatorFabric server, change directory to “operatorfabric-getting-started/server” and execute the following command:

docker-compose stop &

4.2. Stop Let’s Coordinate

Position yourself in the “letscoordinate/bin” directory and run the following command:

./run_letscoos.sh stop

This will stop the letsco-api & letsco-data-provider processes, and stop the docker services (Kafka, Zookeeper, MariaDB).