Get Started

WSO2 Open Banking CDS Toolkit contains the customizations done on top of WSO2 Open Banking Accelerator to comply with the Australian Consumer Data Standards specification. This toolkit has been developed as an extension of WSO2 Open Banking Accelerator. The accelerators run on top of WSO2 Identity Server, WSO2 API Manager, WSO2 Streaming Integrator and these are referred to as base products.

This section guides you on how to set up the solution in a local environment. Follow the instructions to find how you can quickly set up and try out a basic flow.

Prerequisites

  1. Download Open Java Development Kit (OpenJDK) version 11 to the local environment.

  2. In the environment variables, update the JAVA_HOME and PATH variables. For instance, you can do this on a Mac/Linux server by adding the following to the ~/.bashrc file:

    export JAVA_HOME="<JDK_LOCATION>"
    export PATH=$PATH:$JAVA_HOME/bin

  3. Setup a database server using any of the following:

    • MySQL 8.0
    • Oracle 19c
    • Microsoft SQL Server 2017
    • PostgreSQL 13

    Info

    See Compatibility if you are using MySQL 8.0.

    Note

    We do not recommend configuring H2 database in the production environment.

Installing base products

  1. Download and extract the following base products:

  2. To configure the Identity Server with the API Manager, download WSO2 IS Connector for API Manager 4.2.0.

Installing WSO2 Open Banking Accelerator

  1. If you have an active WSO2 Open Banking subscription, contact us via WSO2 Online Support System to download Open Banking Accelerator 3.0.0.

    Note

    If you don't have a WSO2 Open Banking subscription, contact us for more information.

  2. Extract the downloaded WSO2 Open Banking Accelerator zip files. WSO2 Open Banking Accelerator contains the following accelerators:

    • wso2-obiam-accelerator-3.0.0
    • wso2-obam-accelerator-3.0.0
    • wso2-obbi-accelerator-3.0.0

Installing WSO2 Open Banking CDS Toolkit

  1. If you have an active WSO2 Open Banking subscription, contact us via WSO2 Online Support System to download Open Banking CDS Toolkit 1.0.0.

    Note

    If you don't have a WSO2 Open Banking subscription, contact us for more information.

  2. Extract the downloaded WSO2 Open Banking CDS Toolkit zip files. WSO2 Open Banking CDS Toolkit contains the following toolkits:

    • wso2ob-is-toolkit-cds-1.0.0
    • wso2ob-apim-toolkit-cds-1.0.0
    • wso2ob-bi-toolkit-cds-1.0.0
  3. This document uses the following placeholders to refer to the following products:

    Product Placeholder
    WSO2 Identity Server <IS_HOME>
    WSO2 API Manager <APIM_HOME>
    WSO2 Open Banking Identity Server Accelerator <OB_IS_ACCELERATOR_HOME>
    WSO2 Open Banking API Manager Accelerator <OB_APIM_ACCELERATOR_HOME>
    WSO2 Open Banking Identity Server CDS Toolkit <OB_IS_TOOLKIT_HOME>
    WSO2 Open Banking API Manager CDS Toolkit <OB_APIM_TOOLKIT_HOME>
    WSO2 IS Connector for API Manager <IS_EXTENSION>

Getting WSO2 Updates

The WSO2 Update tool delivers hotfixes and updates seamlessly on top of products as WSO2 Updates. They include improvements that are released by WSO2. You need to update the base products, accelerators, and toolkits using relevant scripts.

  1. Go to <PRODUCT_HOME>/bin and run the WSO2 Update tool:

    • Repeat this step for the WSO2 Identity Server, API Manager, and Streaming Integrator products.

      ./wso2update_linux 
      ./wso2update_darwin
      ./wso2update_windows.exe
  2. Go to <ACCELERATOR_HOME>/bin and run the WSO2 Update tool:

    • Repeat this step for the WSO2 Open Banking Identity Server, API Manager, and Business Intelligence accelerators.

      ./wso2update_linux 
      ./wso2update_darwin
      ./wso2update_windows.exe
  3. Go to <TOOLKIT_HOME>/bin and run the WSO2 Update tool:

    • Repeat this step for the WSO2 Open Banking Identity Server, API Manager, and Business Intelligence toolkits.

      ./wso2update_linux 
      ./wso2update_darwin
      ./wso2update_windows.exe

For more information, see the WSO2 Updates documentation.

Top