knowledge-platform

Repository for Knowledge Platform - 2.0

Knowledge-platform local setup

This readme file contains the instruction to set up and run the content-service in local machine.

System Requirements:

Prerequisites:

Java 11
Docker, Docker Compose

One step installation

Go to Root folder (knowledge-platform)
Run "local-setup.sh" file

sh ./local-setup.sh

This will install all the requied dcoker images & local folders for DB mounting. 3. Follow the below manual setps of running content service refer: Running Content Service:

Manual steps to install all the dependents

Please follow the manual steps in One step installation is failed.

Prepare folders for database data and logs

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

Neo4j database setup in docker:

First, we need to get the neo4j image from docker hub using the following command.

docker pull neo4j:3.3.0

We need to create the neo4j instance, By using the below command we can create the same and run in a container.

docker run --name sunbird_neo4j -p7474:7474 -p7687:7687 -d \
    -v $sunbird_dbs_path/neo4j/data:/var/lib/neo4j/data \
-v $sunbird_dbs_path/neo4j/logs:/var/lib/neo4j/logs \
-v $sunbird_dbs_path/neo4j/plugins:/var/lib/neo4j/plugins \
--env NEO4J_dbms_connector_https_advertised__address="localhost:7473" \
--env NEO4J_dbms_connector_http_advertised__address="localhost:7474" \
--env NEO4J_dbms_connector_bolt_advertised__address="localhost:7687" \
--env NEO4J_AUTH=none \
neo4j:3.3.0

--name - Name your container (avoids generic id)

-p - Specify container ports to expose

Using the -p option with ports 7474 and 7687 allows us to expose and listen for traffic on both the HTTP and Bolt ports. Having the HTTP port means we can connect to our database with Neo4j Browser, and the Bolt port means efficient and type-safe communication requests between other layers and the database.

-d - This detaches the container to run in the background, meaning we can access the container separately and see into all of its processes.

-v - The next several lines start with the -v option. These lines define volumes we want to bind in our local directory structure so we can access certain files locally.

--env - Set config as environment variables for Neo4j database

Using Docker on Windows will also need a couple of additional configurations because the default 0.0.0.0 address that is resolved with the above command does not translate to localhost in Windows. We need to add environment variables to our command above to set the advertised addresses.

By default, Neo4j requires authentication and requires us to first login with neo4j/neo4j and set a new password. We will skip this password reset by initializing the authentication none when we create the Docker container using the --env NEO4J_AUTH=none.

Load seed data to neo4j using the instructions provided in the link
Verify whether neo4j is running or not by accessing neo4j browser(http://localhost:7474/browser).
To SSH to neo4j docker container, run the below command.

docker exec -it sunbird_neo4j bash

Redis database setup in docker:

we need to get the redis image from docker hub using the below command.

docker pull redis:6.0.8

We need to create the redis instance, By using the below command we can create the same and run in a container.

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

To SSH to redis docker container, run the below command

docker exec -it sunbird_redis bash

cassandra database setup in docker:

we need to get the cassandra image and can be done using the below command.

docker pull cassandra:3.11.8

We need to create the cassandra instance, By using the below command we can create the same and run in a container.

docker run --name sunbird_cassandra -d -p 9042:9042 \
-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 bridge cassandra:3.11.8

For network, we can use the existing network or create a new network using the following command and use it.

docker network create sunbird_db_network

To start cassandra cypher shell run the below command.

docker exec -it sunbird_cassandra cqlsh

To ssh to cassandra docker container, run the below command.

docker exec -it sunbird_cassandra /bin/bash

Load seed data to cassandra using the instructions provided in the link

Running kafka using docker:

Kafka stores information about the cluster and consumers into Zookeeper. ZooKeeper acts as a coordinator between them. we need to run two services(zookeeper & kafka), Prepare your docker-compose.yml file using the following reference.

version: '3'

services:
  zookeeper:
    image: 'wurstmeister/zookeeper:latest'
    container_name: zookeeper
    ports:
      - "2181:2181"    
    environment:
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://127.0.0.1:2181     
    
  kafka:
    image: 'wurstmeister/kafka:2.12-1.0.1'
    container_name: kafka
    ports:
      - "9092:9092"
    environment:
      - KAFKA_BROKER_ID=1
      - KAFKA_LISTENERS=PLAINTEXT://:9092
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://127.0.0.1:9092
      - KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181      
      - ALLOW_PLAINTEXT_LISTENER=yes
    depends_on:
      - zookeeper

Go to the path where docker-compose.yml placed and run the below command to create and run the containers (zookeeper & kafka).

docker-compose -f docker-compose.yml up -d

To start kafka docker container shell, run the below command.

docker exec -it kafka sh

Go to path /opt/kafka/bin, where we will have executable files to perform operations(creating topics, running producers and consumers, etc). Example:

kafka-topics.sh --create --zookeeper zookeeper:2181 --replication-factor 1 --partitions 1 --topic test_topic

Running Content Service:

(Content V3+V4 APIs, Collection V4 APIs, Assets V4 APIs, Channel V3 APIs, License V3 APIs, Event V4 APIs, EventSet V4 APIs)

Go to the path: /knowledge-platform and run the below maven command to build the application.

mvn clean install -DskipTests -DCLOUD_STORE_GROUP_ID=org.sunbird -DCLOUD_STORE_ARTIFACT_ID=cloud-store-sdk_2.12 -DCLOUD_STORE_VERSION=1.4.6

Go to the path: /knowledge-platform/content-api/content-service and run the below maven command to run the netty server.

mvn play2:run

Using the below command we can verify whether the databases(neo4j,redis & cassandra) connection is established or not. If all connections are good, health is shown as 'true' otherwise it will be 'false'.

curl http://localhost:9000/health

Running Assets/Composite Search Service:

Go to the path: /knowledge-platform and run the below maven command to build the application.

mvn clean install -DskipTests

Go to the path: /knowledge-platform/search-api/search-service and run the below maven command to run the netty server.

mvn play2:run

Using the below command we can verify whether the databases(neo4j,redis & cassandra) connection is established or not. If all connections are good, health is shown as 'true' otherwise it will be 'false'.

curl http://localhost:9000/health

Running Object Category Service:

Go to the path: /knowledge-platform and run the below maven command to build the application.

mvn clean install -DskipTests

Go to the path: /knowledge-platform/taxonomy-api/taxonomy-service and run the below maven command to run the netty server.

mvn play2:run

Using the below command we can verify whether the databases(neo4j,redis & cassandra) connection is established or not. If all connections are good, health is shown as 'true' otherwise it will be 'false'.

curl http://localhost:9000/health

UI tool for Create / Manage Framework or Metadata

Project Details

What is Sunbird Knowlg?

Sunbird Knowlg (pronounced as the word "knowledge") consists of a set of tools and services that enable you to organise, curate, create, and discover millions of assets.

For example, organizations across multiple domains such as e-Commerce, OTT, Education etc can leverage Sunbird Knowlg building block to organise their content and knowledge assets as per their domain, create targeted collections, courses, programs, projects, video repository, etc.

More details are here

Features to be implemented

UI tool for Create / Manage Frameworks or Metadata

Current Scenario:

Currently, Sunbird Knowlg enabled APIs to create and update framework data. There is a Need to enable UI tool for creating and updating the framework data.

More details are here

Acceptance Criteria

Enable UI for creating framework data.
Enable UI to show a list of frameworks with minimal metadata
Enable UI for updating framework data.

Learning Path

Complexity
Medium

Skills Required
Angular

Name of Mentors
@HarishGangula @pallakartheekreddy

Project size
8 Weeks

Product Set Up

https://github.com/Sunbird-Knowlg/knowlg-portal/blob/release-5.5.0/README.md

Milestones

Understanding the requirements
Understanding framework API
UI for creating a new framework
UI for showing list of frameworks
UI for updating existing framework

sunbird-knowlg / knowledge-platform Goto Github PK