Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.
This documentation is for WSO2 Message Broker version 3.2.0. For the latest documentation, see the documentation for WSO2 Enterprise Integrator.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Changing the default database

By default, WSO2 products are shipped with an embedded H2 WSO2 MB contains two embedded H2 databases: The default Carbon database, which is used for storing user management and registry data. We recommend that you use , and the default broker-specific database.

You can change the default database configurations in WSO2 MB by setting up new physical databases, and updating the relevant configurations. We recommend the use of an industry-standard RDBMS such as Oracle, PostgreSQL, MySQL, MS SQL, etc. when you set up your production environment. You can change the default database configuration by simply setting up a new physical database and updating the configurations in the product server to connect to that database. For instructions on setting up and configuring databases, see Working with Databases in the WSO2 Administration Guide

  • For information on setting up a new database for your profile, see Setting up the Physical Database in the WSO2 Administration Guide.


    Add the database drivers to the <EI_HOME>/lib/ directory when setting up the database.

  • Once you set up a new Carbon database, see Changing the Carbon Database for instructions on updating the configurations.
  • Once you set up a new broker-specific database, see Changing the Default Broker Database for instructions on updating the configurations.


Configuring users, roles and permissions