This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Working with Databases

The databases that are used for WSO2 Message Broker (MB) are stored in the <MB_HOME>/repository/database directory. By default, WSO2 MB is shipped with two embedded H2 databases as described in the table given below.

DatabaseDescription
WSO2CARBON_DB.h2.db

This is the Carbon database, which is used by default for storing Registry and User Management data.

In addition to the above databases, if the product uses features of WSO2 Identity Server or WSO2 Enterprise Store (ES), data which are specific to these features will also reside in the embedded Carbon database by default. However, for production environments, we recommend that you use separate RDBMS databases to store identity-related and storage-related data.

WSO2MB_DB.h2.dbThis is a product-specific database, which is used for storing data relevant to MB.

These embedded H2 databases are suitable for development, testing, and some production environments. For most production environments, however, we recommend to use industry-standard RDBMSs such as Oracle, MySQL, MS SQL, etc. 

The following topics explain how you can replace the default databases explained above with industry-standard DBMSs: