1. What we want to run as BB

   •   Paymenthub Setup:

     • Link to base PHEE base helm chart :- (for referencing values.yaml) https://github.com/openMF/ph-ee-env-template/blob/master/helm/ph-ee-engine/values.yaml

     • Link to paymenthub G2Psandbox Helm chart ( git clone env-labs— GitHub - openMF/ph-ee-env-labs: Actual configurations of lab environment, BPMN flows, and Helm Charts )

     • For G2Psandbox chart—> https://github.com/openMF/ph-ee-env-labs/tree/master/helm/g2p-sandbox

     • https://docs.google.com/document/d/1Pk4fHdAONAwZ9j65YuI8qA8MgDmv_oMnlvqNUQGsMTA/edit This document enlists on how to enable xpack security for Elasticsearch, Kibana and other ES dependent services in Paymenthub.

     • Dev Repository: Sandbox Github Repo

   • FSP Setup

     • Link to fineract base helm chart : https://github.com/fynarfin/fineract-env/blob/master/helm/fineract/values.yaml

     • Link to fineract g2p sandbox helm chart: https://github.com/fynarfin/fineract-env/blob/master/helm/g2p-Sandbox/values.yaml

2. How they do it

   • Paymenthub Setup:

     • Guidebook/documentation

       • Installation instructions | Mifos Docs

     • How to run in kubernetes/docker

       • For G2Psandbox chart—> https://github.com/openMF/ph-ee-env-labs/tree/master/helm/g2p-sandbox

       • Please refer to Operations app latest version known issue work around in the G2Psandbox helm chart README file

     • How to access the APIs ?

       • Postman SIT env for paymenthub : https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Environment/SIT.json

       • Postman collection for paymenthub : https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Payment%20Hub.json

       • Test paymenthub postman collection for channel —>GSMA API—> GSMA P2P API

   • FSP Setup

     • Guidebook/documentation

       • …

     • How to run in kubernetes/docker

       • Link to fineract base helm chart : https://github.com/fynarfin/fineract-env/blob/master/helm/fineract/values.yaml

       • Link to fineract g2p sandbox helm chart: https://github.com/fynarfin/fineract-env/blob/master/helm/g2p-Sandbox/values.yaml

     • How to access the APIs ?

       • Community app link (for seeing the debits and credits) : - https://communityapp.sandbox.fynarfin.io/?baseApiUrl=https://fynams.sandbox.fynarfin.io&tenantIdentifier=rhino

       • [ You should always specify the backend via baseApiUrl and tenant via tenant identifier Eg : https://openmf.github.io/community-app?baseApiUrl=https://demo.fineract.dev&tenantIdentifier=default ] 

       • Note: in case of Self-signed certificates, use curl —insecure flag or open the FSP host name (fynams.sandbox.fynarfin.io)in a new tab and accept the self-signed certs.

       • For creating Savings products and Tenant Clients in Fineract:

         • Environment: https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Environment/FineractCoDevelop_environment.json

         • Postman Collection : https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/G2P%20Sandbox%20Demo%20Prep.json

3. How we will do it.

   1. Sandbox setup

      1. Setup Details

   2. What are the differences

      • Private images from provided repository should be exported and then imported in our repository → Currently AWS ECR.

   3. What are the obstacles

      • Apply known issue fix Mifos Research Notes | Upgrade/Install chart:

      • Elasticsearch ceritificates Mifos Research Notes | ElasticSearch secrets

      • Manage Domans in order to access the apps via Ingresses

Resources:
Payment Hub installation link (Installation instructions | Mifos Docs ) or this deployment mode referencing component architecture link (https://mifos.gitbook.io/docs/payment-hub-ee/overview/deployment-models ) or examples (https://mifos.gitbook.io/docs/payment-hub-ee/overview/example ).

Basic information :

1. Payment hub EE - Mifos (there is a a documentation that I will follow but the repo is empty: Technical Overview | Mifos Docs )

   1. Questions:

      1. Is there a guidebook/doc that we can follow to run the environment?

         1. Installation instructions | Mifos Docs

      2. Will installation guideline execution will set up a full environment or we will need to install other components?

      3. Which are all the repositories that will be used

         1. https://mifos.gitbook.io/docs/payment-hub-ee/overview/source-code-repositories

      4. After we run the environment how do we access the APIs?

         1. Postman Collections

2. Fineract - Mifos

Information from MIFOS related with running payment BB in sandbox:

Steps  to add/login to ecr from another cluster  :

1. After AWS configure / login to our ECR cluster :AWS ecr get-login-password --region ap-south-1 > password

2. After AWS configure / login to third party (Mifos) AWS account / EKS cluster : kubectl create secret docker-registry dockersecret --docker-server=419830066942.dkr.ecr.ap-south-1.amazonaws.com --docker-username=AWS --docker-password=“$(cat password)” --docker-email=somanath@fynarfin.io

3.  Patching service account with docker imagePullSecret: kubectl patch service account default -p ‘{“imagePullSecrets”: [{“name”: “dockersecret”}]}’

4. Verify the Service account patch with pod — kubectl get pod <pod name> _n <namespace> -o=jsonpath=‘{.spec.imagePullSecrets[0].name}{“\n”}’

Paymenthub Setup:-

1. Link to base PHEE base helm chart :- (for referencing values.yaml) https://github.com/openMF/ph-ee-env-template/blob/master/helm/ph-ee-engine/values.yaml

2. Link to paymenthub G2Psandbox Helm chart ( git clone env-labs— GitHub - openMF/ph-ee-env-labs: Actual configurations of lab environment, BPMN flows, and Helm Charts )

3. For G2Psandbox chart—> https://github.com/openMF/ph-ee-env-labs/tree/master/helm/g2p-sandbox

4. Please refer to Operations app latest version known issue work around in the G2Psandbox helm chart README file

5. Postman SIT env for paymenthub : https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Environment/SIT.json

6. Postman collection for paymenthub : https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Payment%20Hub.json

7. Test paymenthub postman collection for channel —>GSMA API—> GSMA P2P API

1. What image tag should we use for ph_ee_connector_mojaloop (https://github.com/openMF/ph-ee-env-labs/blob/7ed115f79efd46a42e1c63cdbf845d3adfbfec4e/helm/g2p-sandbox/values.yaml#L215 )

   1. Answered by Somanath Hugar via Slack: “You can use the latest image tag for ph_ee_connector_mojaloop”

2. we will need some help for starting the ElasticSerach with elastic-certificates

   1. Answered by Somanath Hugar via Slack: Please refer to the documentation for ElasticSearch certificates, secrets
      https://docs.google.com/document/d/1Pk4fHdAONAwZ9j65YuI8qA8MgDmv_oMnlvqNUQGsMTA/edit?usp=sharing

3. We redeply the chart, but now we have 1 pod restarting, can you help sorting out the error and run the pod?

   1. pod: ph-ee-connector-ams-mifos

   2. we successful run it with ams_local_enabled: true

4. Identify the pods required to run the Payment Hub bare minimum configuration?

   1. SLCB (commercial bank payment connector) service is not necessarily required for most demos so you can go ahead and remove it.

   2. In barebones, you can remove Zeebe Operate & either one of Mojaloop or GSMA payment schema connectors but that would impede us from giving demos so I wouldn't recommend removing them.

5. We have a blocker on how to proceed with "Deploying the BPMN flows" and do we need to deploy any BPMN flows. Could you share more information or any short written explanation/procedure? 

   1. That would be the Upload BPMN API. You can find it in Payment Hub APIs Postman Collection Zeebe Operations APIs folder in ph-ee-env-template Github repository.    

   2. BPMNS : BPMNS

FSP Setup :-

1. Link to fineract base helm chart : https://github.com/fynarfin/fineract-env/blob/master/helm/fineract/values.yaml

2. Link to fineract g2p sandbox helm chart: https://github.com/fynarfin/fineract-env/blob/master/helm/g2p-Sandbox/values.yaml

3.  Community app link (for seeing the debits and credits) : - https://communityapp.sandbox.fynarfin.io/?baseApiUrl=https://fynams.sandbox.fynarfin.io&tenantIdentifier=rhino

4. [ You should always specify the backend via baseApiUrl and tenant via tenant identifier Eg : https://openmf.github.io/community-app?baseApiUrl=https://demo.fineract.dev&tenantIdentifier=default ] 

5. Note: in case of Self-signed certificates, use curl —insecure flag or open the FSP host name (fynams.sandbox.fynarfin.io)in a new tab and accept the self-signed certs.

Initial Actions:

Mifos Fineract (Initial tryouts not used in current solution!)

Docker run

Kubernetes:

• was not able to run working instance in local minikube. The described run information was followed but it’s not working, Tested by @Vladislav Todorov on local minikube and by @Tsvetomir Krumov . Same problem for both error after starting fineract-server (was trying to connect to DB on localhost instead the one described in fineract/kubernetes/fineractmysql-deployment.yml).

• After adding 3 new environment variables to fineract/kubernetes/fineract-server-deployment.yml fineract-server starts successfully

Paymenthub/Fineract Setup

Source

Both provided charts for Paymenthub(PaymentHub Setup) and Fineract (FSP setup) are used as a dependent charts in current setup.

Mifos PaymentHub and Fineract setup for sandbox

Images

All images referenced from Mifos private repository are pulled and pushed in Our ECR

ElasticSearch secrets

Original source provided: https://docs.google.com/document/d/1Pk4fHdAONAwZ9j65YuI8qA8MgDmv_oMnlvqNUQGsMTA/edit?usp=sharing

Install/Update chart commands:

Repo: Sandbox Github Repo

Installation instructions github: GitHub Repository

Obtain dependency:

• rebuild the charts/ directory based on the Chart.lock file

  or use "helm dependency update" to update charts/ based on the contents of Chart.yaml

Upgrade/Install chart:

Known Issues

Known Issue Payment hub EE

Known Issue Fineract

Uninstall chart

Uninstall:

Delete all related Persistent Volume Claims:

Services PaymentHubEE

BPMN Deployment

Upload BPMN API. You can find it in Payment Hub Postman Collection Zeebe Operations APIs folder in ph-ee-env-template Github repository.

Initially provided bpmn-s: BPMNs

API information provided by Mifos:

For creating Savings products and Tenant Clients:

Environment: https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Environment/FineractCoDevelop_environment.json
Postman Collection : https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/G2P%20Sandbox%20Demo%20Prep.json

For transactions:

Then Use "Bulk APIs" => "Batch Transactions" API endpoint from : https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Payment%20Hub.json . Environment https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/Environment/SIT.json
With csv file: https://github.com/openMF/ph-ee-env-template/blob/master/PostmanCollections/ph-ee-bulk-demo-6.csv