Mifos Payment Hub Installation in Sandbox

Owned by Vladislav Todorov
Last updated: Dec 08, 2023
2 min read

Guidances

Mifos PaymentHub initial installation instructions (v.1.11.0) 04.12.2023:

  1. Deployment documentation (specific and in detail to our project, not a generic one)

As all Govstack developments are merged into master branch there is no difference between master branch documentation and Govstack bar configuration.
Deployment Instructions: https://mifos.gitbook.io/docs/payment-hub-ee/overview/installation-instructions
Govstack Config: https://mifos.gitbook.io/docs/payment-hub-ee/overview/installation-instructions/default-cookbook-chart-for-gov-use-case

  1. Sources are available (some links to artifacts in this chat above are dead)
    Source Repo's here: https://mifos.gitbook.io/docs/payment-hub-ee/overview/source-code-repositories
    Release notes for latest: https://mifos.gitbook.io/docs/payment-hub-ee/release-notes/v1.11.0

  2. Helm Chart of the current version and to which GovStack spec it is compliant.
    The Helm Charts are conformant to the spec v1.3 we have shared awaiting final publication by Govstack.
    @Manoj VM can you please share link to the Helm charts

  3. Are resources (images) publicly available.
    @Manoj VM can you share links to latest image

  4. Any post-deployment configurations needed as a document.
    Post-deployment config here: https://mifos.gitbook.io/docs/payment-hub-ee/overview/installation-instructions/post-deployment-steps
    Config for items such as Program ID etc here:
    https://mifos.gitbook.io/docs/payment-hub-ee/overview/installation-instructions/configuration-instructions

  5. Any automated procedures available.n/a Helm charts provided.

  6. Validation indicators/markers for the running instance of your Payment Hub.@Manoj VM Do we have these documented I note on the demo last week you had expected state I can try and snip that out if we don't have it somewhere.

 

Execution steps

Follow: https://mifos.gitbook.io/docs/payment-hub-ee/overview/installation-instructions/default-cookbook-chart-for-gov-use-case

  1. Install/upgrade Chart

    git clone https://github.com/openMF/ph-ee-env-template.git cd ph-ee-env-template helm dep up helm/g2p-sandbox helm package helm/g2p-sandbox helm repo index . helm install g2psandbox helm/g2p-sandbox --namespace paymenthub --create-namespace

  • Install ServiceMonitor (Do this if you are setting up cluster for the first time), this CRD is added in our terraform script

kubectl apply -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/main/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml

  1. Apply fix to known bugs

    // On pod: operationsmysql-0 in {namespace} with PortForward or Shell in the pod DROP DATABASE `tenants`; DROP DATABASE `rhino`; DROP DATABASE `gorilla`; CREATE DATABASE `tenants`; GRANT ALL PRIVILEGES ON `tenants`.* TO 'mifos'; CREATE DATABASE `rhino`; CREATE DATABASE `gorilla`; GRANT ALL PRIVILEGES ON `rhino`.* TO 'mifos'; GRANT ALL PRIVILEGES ON `gorilla`.* TO 'mifos'; GRANT ALL ON *.* TO 'root'@'%';

  2. Apply secrets creation scripts

    1. Elastic Search Secret

      Source: Github Source

    2. Kibana Secret

      Source: Github Source

    3. bulk-processor secret (ID and KEY are in file keys.txt in S3 bucket)

  3. Upload BPMN-s

  4. Execute tests

  5. Todo fixes

 

Execution steps 2.0

  1. Install upgrade chart