Skip to content

v15.2.0 Release - Acacia
Compare
Choose a tag to compare
@oderayi oderayi released this 07 Nov 14:30
v15.2.0
bbc260f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Helm Release Notes

Date Revision Description
2023-10-23 0 Initial draft
2023-10-31 1 RC.1
2023-11-03 2 Release
2023-11-07 3 Release Updated
  • For KNOWN ISSUES, please review the section #6 "Known Issues" below.

0. Summary

Enhancements and non-breaking changes to the v15.1.0 Release, which includes:

  1. Nodejs version of core and supporting services upgraded to v18.17.1 LTS
  2. Performance improvements and metrics around core services: ALS, Central Ledger, Quoting Service based on characterisation and fixes, enhancements done
  3. General maintenance and bug fixes

1. New Features

  1. Performance fixes, enhancements and maintenance:

  2. NodeJS upgrades:

2. Bug Fixes

  1. mojaloop/#2734 Failures in daily cronjob GP tests (mojaloop-simulator), closes mojaloop/2734
  2. mojaloop/#3474 CL Cache expiration values higher than default causes transfer to fail (central-ledger/pull/966), closes mojaloop/#3474
  3. mojaloop/#3527 CL v17.2.0 might have issues on payee notifications, Duplicate transfer ID check as well (object-store-lib), closes mojaloop/3527
  4. mojaloop/#3529 CL high latency in transfer processing(central=ledger), closes mojaloop/#3529
  5. mojaloop/#3579 Provisioning and GP test failing because of Funds In timing problems (testing-toolkit-test-cases/pull/129)
  6. mojaloop/#3580 fix missing toDestination on handling the fspiop source/destination (central-ledger/pull/982), closes mojaloop/3580
  7. mojaloop/#3589 Bulk API Adapter failing due to object-lib-store bug (bulk-api-adapter/pull/102)
  8. mojaloop/#4597 Setup and GP failures when upgrading Mojaloop from v15.1.0 to v15.2.0-rc (testing-toolkit-test-cases), closes mojaloop/3597

3. Application versions

  1. ml-api-adapter: v14.0.0 -> v14.0.5 (Compare)
  2. central-ledger: v17.0.3 -> v17.3.2 (Compare)
  3. account-lookup-service: 14.1.0 -> v15.0.0 (Compare)
  4. quoting-service: v15.0.2 -> v15.5.0 (Compare)
  5. central-settlement: v15.0.0 -> v16.0.0 (Compare)
  6. bulk-api-adapter: v15.0.3 -> v16.0.1 (Compare)
  7. central-event-processor: v12.0.0
  8. email-notifier: v12.0.0 -> v14.0.0 (Compare)
  9. als-oracle-pathfinder: v12.0.0
  10. transaction-requests-service: v14.1.0 -> v14.1.2 (Compare)
  11. event-sidecar: v12.0.0 -> v14.0.0 (Compare)
  12. event-stream-processor: v12.0.0-snapshot.7
  13. simulator: 12.0.0
  14. mojaloop-simulator: v14.0.1 -> v15.0.0 (Compare)
  15. sdk-scheme-adapter: v23.0.1 -> v23.1.1 (Compare)
  16. ml-testing-toolkit: v16.1.1 -> v17.0.0 (Compare)
  17. ml-testing-toolkit-ui: v15.4.0
  18. ml-testing-toolkit-client-lib: v1.2.0
  19. auth-service: v14.0.0 -> v15.0.0 (Compare)
  20. als-consent-oracle: v0.2.0 -> v0.2.2 (Compare)
  21. thirdparty-api-svc: v13.0.2 -> v14.0.0 (Compare)
  22. thirdparty-sdk: v15.1.0 -> v15.1.1 (Compare)

4. API Versions

This release supports the following versions of the Mojaloop family of APIs:

API Supported Versions Notes
FSPIOP v1.1, v1.0
Settlements v2.0
Admin v1.0
Oracle v1.0
Thirdparty v1.0

5. Testing notes

  1. This release has been validated against the following Dependency Test Matrix:

    Dependency Version Notes
    Kubernetes v1.28 AWS EKS, AWS EKS Supported Version Notes
    containerd v1.6.19
    Nginx Ingress Controller helm-ingress-nginx-4.7.0 / ingress-controller-v1.8.0
    Amazon Linux v2
    MySQL bitnami/mysql:8.0.32-debian-11-r0
    Kafka bitnami/kafka:3.3.1-debian-11-r1
    Redis bitnami/redis:7.0.5-debian-11-r7
    MongoDB bitnami/mongodb:6.0.2-debian-11-r11
    Testing Toolkit Test Cases v15.2.0
    example-mojaloop-backend v15.0.0 README

  2. It is recommended that all Mojaloop deployments are verified using the Mojaloop Testing Toolkit. More information can be found in the Mojaloop Deployment Guide.

  3. The testing-toolkit-test-cases (See above Dependency Test Matrix for exact version required for this release) Golden Path collections expects:

    • the Quoting service operating mode to be set quoting-service.config.simple_routing_mode_enabled=true (in helm mojaloop/values.yaml under quoting-service config). If this is incorrectly configured, it will result in several failures in the quoting-service tests (7 expected failures). If this is disabled, ensure that you update the corresponding test-case environment variable parameter SIMPLE_ROUTING_MODE_ENABLED ( in helm mojaloop/values.yaml ml-testing-toolkit -> extraEnvironments.hub-k8s-default-environment.json.inputValues) to match.
    • the on-us transfers (in mojaloop/values.yaml "enable_on_us_transfers: false" under centralledger-handler-transfer-prepare -> config and cl-handler-bulk-transfer-prepare -> config) configuration to be disabled. The test-case environment variable parameter (ON_US_TRANSFERS_ENABLED (in helm mojaloop/values.yaml ml-testing-toolkit -> extraEnvironments.hub-k8s-default-environment.json.inputValues), the same name used on postman collections) must similarly match this value.

  4. Simulators

    • We recommend using Testing Toolkit instead of Postman which is better suited for the async nature of the Mojaloop API specification (see above)
    • Mojaloop-Simulator is enabled by default (six instances used for single transfers usually and three more specific to bulk).
    • Ensure that correct Postman Scripts are used if you wish to test against the Mojaloop-Simulators:
    • Legacy Simulators are still required and deployed by default; disabling this will cause issues since there is Account Lookup directory mocking functionality in this service.

  5. Thirdparty Testing Toolkit Test Collections are not repeatable. Please refer to the following issue for more information #2717 - Thirdparty TTK Test-Collection is not repeatable. It is possible to manually cleanup persistent data to re-run the test if required.

  6. Bulk API Helm Tests

    Refer to the Testing Deployments section in the main README for detailed information on how to enable bulk-api-adapter tests.

  7. Thirdparty API Helm Tests

    Refer to thirdparty/README.md#validating-and-testing-the-3p-api on how to enabled and execute Thirdparty verification tests.

  8. Testing the new Bulk functionality (sdk-scheme-adapter)

    For details regarding deployment and validation of simulators needed for bulk (for adoption provided in sdk-scheme-adapter) refer to deploying Mojaloop TTK simulators.

6. Known Issues

  1. #2119 - Idempotency for duplicate quote request
  2. #2322 - Helm install failing with with "medium to large" release names
  3. #2317 - Mojaloop Helm deployments are not compatible when deployed to ARM-arch based hosts
  4. #2435 - Quoting-Service is incorrectly handling failed responses to FSPs when forwarding requests
  5. Test issues causing instability/intermitant failures on Test Case Results
    1. #2717 - Thirdparty TTK Test-Collection is not repeatable
    2. #2925 - Helm Test Intermittent failure with 'Generic ID not found

7. Contributors

Note: companies are in alphabetical order, individuals are in no particular order.

Full Changelog: v15.1.0...v15.2.0

Contributors

oderayi, dfry, and 7 other contributors
Assets 3
Loading