sunbird-groups-service

This is the repository for Sunbird user groups system micro-service. It provides the APIs for user groups functionality of Sunbird.

The code in this repository is licensed under MIT License unless otherwise noted. Please see the LICENSE file for details. This readme file describes how to install and start groups-service in your developement environment.

Sunbird-groups-service developement environment setup:

This readme file contains the instruction to set up and run the groups-service in your developement environment.

System Requirements

Prerequisites

Java 11
Latest Docker
Latest Maven

Prepare folders for database data and logs

To prepare folders for database data and logs, run the following command:

mkdir -p ~/sunbird-dbs/cassandra ~/sunbird-dbs/es 
export sunbird_dbs_path=~/sunbird-dbs

To verify the creation of folders, run:

echo $sunbird_dbs_path

Cassandra database setup in Docker

To get the Cassandra image, use the following command:

docker pull cassandra:3.11.6

For Mac M1 users follow the bellow command:

docker pull --platform=linux/amd64 cassandra:3.11.6

For the network, you can either use an existing network or create a new one by executing the following command:

docker network create sunbird_db_network

To create the Cassandra instance, run the following command:

docker run -p 9042:9042 --name sunbird_cassandra \
 -v $sunbird_dbs_path/cassandra/data:/var/lib/cassandra \
 -v $sunbird_dbs_path/cassandra/logs:/opt/cassandra/logs \
 -v $sunbird_dbs_path/cassandra/backups:/mnt/backups \
 --network sunbird_db_network -d cassandra:3.11.6

For Mac M1 users follow the below command:

docker run --platform=linux/amd64 -p 9042:9042 --name sunbird_cassandra \
 -v $sunbird_dbs_path/cassandra/data:/var/lib/cassandra \
 -v $sunbird_dbs_path/cassandra/logs:/opt/cassandra/logs \
 -v $sunbird_dbs_path/cassandra/backups:/mnt/backups \
 --network sunbird_db_network -d cassandra:3.11.6

To verify the setup, run the following command, which will show the status of Cassandra as up and running:

docker ps -a | grep cassandra

To create/load keyspaces and tables to Cassandra

Click the link sunbird-utils-cassandra-setup and follow the steps for creating/loading the Cassandra keyspaces and tables to your development environment.

Note: It is mandatory to follow the instructions provided in the link.

To verify the creation of keyspaces and tables, connect to the Cassandra Docker container using SSH and run the following command:

docker exec -it sunbird_cassandra /bin/bash

Setting up Redis in Docker:

To set up Redis database in Docker, please follow the below steps:

Pull the Redis image from Docker Hub using the following command:

docker pull redis:4.0.0

Create a Redis instance by running it in a container with the following command:

docker run --name sunbird_redis -d -p 6379:6379 redis:4.0.0

To verify the Redis setup, run the following command to SSH into the Redis Docker container:

docker exec -it sunbird_redis bash

To set up Redis database in Docker for Mac M1, please follow the below steps:

Pull the Redis image from Docker Hub using the following command:

docker pull --platform=linux/amd64 redis:5.0.7

Create a Redis instance by running it in a container with the following command:

docker run --platform=linux/amd64 --name sunbird_redis -d -p 6379:6379 redis:5.0.7

To verify the Redis setup, run the following command to SSH into the Redis Docker container:

docker exec -it sunbird_redis bash