Mojaloop Switch and Mojaloop Connectorts Deployment on K8S to test FX

Component Diagram

System configuration

• Ubuntu 23.04 x86_64
• AMD Ryzen 9 3900X 12-Core Processor
• 32GB RAM
• 512GB nvme storage

Deploying K8S

Followed the instructions provided in this link https://docs.mojaloop.io/legacy/deployment-guide/local-setup-linux.html

• sudo snap install microk8s --classic --channel=1.27/stable
• add the user vijay to the 'microk8s' group

  sudo usermod -a -G microk8s $USER
  sudo chown -f -R $USER ~/.kube
  

• microk8s.kubectl get nodes
  microk8s.enable ingress dns helm3
  sudo snap alias microk8s.kubectl kubectl
  sudo snap alias microk8s.helm3 helm
  

• Get k8s config file using microk8s config to access it from remotely

Setup Helm repositories

• Dependencies

  helm repo add stable https://charts.helm.sh/stable
  helm repo add incubator https://charts.helm.sh/incubator
  helm repo add kiwigrid https://kiwigrid.github.io
  helm repo add kokuwa https://kokuwaio.github.io/helm-charts
  helm repo add elastic https://helm.elastic.co
  helm repo add codecentric https://codecentric.github.io/helm-charts
  helm repo add bitnami https://charts.bitnami.com/bitnami
  helm repo add mojaloop-charts https://mojaloop.github.io/charts/repo
  helm repo add redpanda-console https://packages.vectorized.io/public/console/helm/charts/
  

• Mojaloop Chart

  helm repo add mojaloop https://mojaloop.io/helm/repo/
  

• helm repo update

Deploy default Mojaloop

• Deploy backend dependencies like mysql, kafka...etc

  helm --namespace demo install backend mojaloop/example-mojaloop-backend --set kafka.controller.replicaCount=1 --set kafka.listeners.client.protocol=PLAINTEXT --set kafka.listeners.controller.protocol=PLAINTEXT --create-namespace
  

• Deploy mojaloop

  helm --namespace demo install moja mojaloop/mojaloop --version 16.0.0
  

• Wait for all pods to be healthy
• Run Helm Test

  helm -n demo test moja
  

• Add the following hostnames to /etc/hosts file

  127.0.0.1   ml-api-adapter.local central-ledger.local account-lookup-service.local account-lookup-service-admin.local quoting-service.local central-settlement-service.local transaction-request-service.local central-settlement.local bulk-api-adapter.local moja-simulator.local sim-payerfsp.local sim-payeefsp.local sim-testfsp1.local sim-testfsp2.local sim-testfsp3.local sim-testfsp4.local mojaloop-simulators.local finance-portal.local operator-settlement.local settlement-management.local testing-toolkit.local testing-toolkit-specapi.local
  

Customize mojaloop values file for FX functionality

• Download the default values file of mojaloop chart https://github.com/mojaloop/helm/blob/v16.0.0/mojaloop/values.yaml
• Change central-ledger version from v17.6.0 to v17.7.0-snapshot.0
• Change ml-api-adapter version from v14.0.5 to v14.1.0-snapshot.5
• Upgrade mojaloop with new values file

  helm --namespace demo upgrade moja mojaloop/mojaloop --version 16.0.0 -f ./test-mojaloop-deployment-fx/values-mojaloop.yaml
  

Deploy FX participants

cd participants-fx-poc
sh build.sh
helm --namespace demo install fx .

• Add following hostnames to /etc/hosts

  127.0.0.1 ttk.fxp.local ttk.fxpayerdfsp.local ttk.fxpayeedfsp.local
  

Onboard new participants

• Access TTK using this link http://testing-toolkit.local/admin/index
• Load collection ttk-testcases/onboarding and environment ttk-testcases/default-env.json
• Run test collection

Make a transfer

• Open http://ttk.fxpayerdfsp.local/admin/outbound_request
• Load test case ttk-testcases/tests/transfer.json
• Load the environment file ttk-testcases/default-env.json
• Execute the transfer