Overview

Thesis work of Csaba Kocsis for University of Szeged TTIK Computer Engineering Msc.

Installation Guide

Development is done on a Windows machine therefore all commands below follow Windows path syntax.

NOTE: Machine learning model associated with this project is not available in this repository. If you wish to use it then write me a message asking for it. However, you can also deploy your own model. Requirements for the model:

• Keras can import the model by calling: tensorflow.keras.models.load_model
• Model takes 227x227x3 matrix as an input.
• Model does binary classification

Prerequisites

This application runs on Kubernetes. Installation guides for installing Kubernetes:

Windows:

• Docker Desktop: https://docs.docker.com/desktop/windows/install/
• Kubernetes: https://docs.docker.com/desktop/kubernetes/

Linux:

• Docker: https://docs.docker.com/engine/install/#server
• Kubernetes: https://minikube.sigs.k8s.io/docs/start/

The deployment of the application is done with Helm package manager.

Installation guide for installing Helm: https://helm.sh/docs/intro/install/

Initalization steps

Helm repo update

helm repo add apisix https://charts.apiseven.com
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

Install ingress controller

helm install apisix apisix/apisix  --namespace default `
 --set gateway.type=NodePort --set gateway.tls.enabled=true --set gateway.tls.nodePort=31152 `
 --set ingress-controller.enabled=true --set ingress-controller.config.apisix.serviceNamespace=default

SSO server

Build docker

docker build .\sso-server -t sso-server:1.0

Build image for post install hook

docker build .\sso-server\realm-setup -t sso-server-post-install:1.0

Generate self signed cert

Reference: https://wiki.openssl.org/index.php/Binaries You will need to input "weedrecognition.com" for when you are prompted to give value for "Common Name (e.g. server FQDN or YOUR name) []:".

openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout privateKey.key -out certificate.crt
cp privateKey.key .\charts\sso-server\files
cp certificate.crt .\charts\sso-server\files

Helm package

helm package .\charts\sso-server

Helm install

helm install sso-server .\sso-server-1.0.0.tgz

Model Storage server

Build docker and helm package

docker build .\model-storage -f .\docker\builder\Dockerfile -t model-storage:1.0 --build-arg PROJECT_NAME=model-storage --build-arg MODULE_NAME=model_storage
helm package .\charts\model-storage\

Helm istall

helm install model-storage .\model-storage-1.0.0.tgz

Redis

Helm install

helm install message-broker-redis bitnami/redis --set replica.replicaCount=1 --set architecture=standalone --set auth.enabled=false

Model Orchestrator

Build docker and helm package

docker build .\model-prediction-server-init -t model-prediction-server-init:1.0
docker build .\model-prediction-server -t model-prediction-server:1.0
docker build .\model-orchestrator -f .\docker\builder\Dockerfile -t model-orchestrator:1.0 --build-arg PROJECT_NAME=model-orchestrator --build-arg MODULE_NAME=model_orchestrator
helm package .\charts\model-orchestrator

Helm install

helm install model-orchestrator .\model-orchestrator-1.0.0.tgz

Model Predicate Aggregator server

Build docker and helm package

docker build .\model-activation-listener -t model-activation-listener:1.0
docker build .\model-prediction-aggregator -f .\docker\builder\Dockerfile -t model-prediction-aggregator:1.0 --build-arg PROJECT_NAME=model-prediction-aggregator --build-arg MODULE_NAME=model_prediction_aggregator
helm package .\charts\model-prediction-aggregator

Helm install

helm install model-prediction-aggregator .\model-prediction-aggregator-1.0.0.tgz

Admin web server

Build docker and helm package

docker build .\model-admin-web -t model-admin-web:1.0
helm package .\charts\admin-web-server\

Helm install

helm install admin-web-server .\admin-web-server-1.0.0.tgz

Local System Test

Setup DNS server

We will need to start up custom DNS Server to be able to serve weedrecognition.com to the mobile app.

NOTE: Replace the IP address to your local machine address in the /system_test/dns/db.weedrecognition.com.

docker run `
        --name=bind9 `
        --restart=always `
        --publish 53:53/udp `
        --publish 53:53/tcp `
        --publish 127.0.0.1:953:953/tcp `
        --volume ${PWD}/system_test/dns/named.conf.local:/etc/bind/named.conf.local `
        --volume ${PWD}/system_test/dns/db.weedrecognition.com:/etc/bind/db.weedrecognition.com `
        internetsystemsconsortium/bind9:9.18

Adding DNS entry to hosts file

In order to be able to use the admin page on your local host you will need to add <your host address> weedrecognition.com to the hosts file: c:\windows\system32\drivers\etc\hosts.

Change DNS server on your android device

Install the following app: https://play.google.com/store/apps/details?id=com.appplanex.dnschanger

Add a Custom DNS Server with IP address of your local host.

Run tests

Steps:

• Install android application to your phone.
• Connect your mobile phone to the same network as your local machine
• Use the app :)