Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Table of Contents
maxLevel3
minLevel3
styleborder:1
locationtop
typeflat
separatorpipe

...

Setup Database and the Database User

1. Download and install MySQL on your computer. Use the following command:

...

7. Log out from the MySQL prompt by typing the "quit" command.

Code Block
quit;

Setup Configuration Files

1. Edit the default database configuration defined in the the master-datasources.xml  file file located at $CARBON_HOME/repository/conf/datasources  directory directory as below. Both the database configurations in registry.xml  and  and user-mgt.xml  refer refer this data source.


Info
titleNote

Replace these settings with your own custom values:

Code Block
languagehtml/xml
<datasource>
       <name>WSO2_CARBON_DB</name>
       <description>The datasource used for registry and user manager</description>
       <jndiConfig>
           <name>jdbc/WSO2CarbonDB</name>
       </jndiConfig>
       <definition type="RDBMS">
           <configuration>
               <url>jdbc:mysql://localhost:3306/regdb</url>
               <username>regadmin</username>
               <password>regadmin</password>
               <driverClassName>com.mysql.jdbc.Driver</driverClassName>
               <maxActive>80</maxActive>
               <maxWait>60000</maxWait>
               <minIdle>5</minIdle>
               <testOnBorrow>true</testOnBorrow>
               <validationQuery>SELECT 1</validationQuery>
               <validationInterval>30000</validationInterval>
           </configuration>
       </definition>
</datasource>
The database configuration options
  • url - The URL of the database.
  • username  - The name of the database user.

  • password - The password of the database user.
  • driverClassName  - The class name of the database driver.
  • maxActive - The maximum number of active connections that can be allocated from this pool at the same time or negative for no limit.
  • maxWait - The maximum number of milliseconds that the pool will wait (when there are no available connections) for a connection to be returned before throwing an exception or <= 0 to wait indefinitely.
  • minIdle - The minimum number of active connections that can remain idle in the pool without extra ones being created or 0 to create none.

Setup Drivers

Download the MySQL Java connector JAR from http://dev.mysql.com/downloads/connector/j/5.1.html and place it in the $CARBON_HOME/repository/components/lib directory.

Info
titleTip

Here, $CARBON_HOME refers to the directory where you are running the WSO2 ESB BPS instance.

Create Database

Automatic Database Creation

1. When you start the server for the first time, use the -Dsetup option. It will create all the tables in the given MySQL database.

...

Code Block
wso2server.bat -Dsetup

2. The WSO2 ESB BPS is configured to run with MySQL database.

Manual Database Creation

1. Run the MySQL scripts for both registry and user manager (embedded) databases, provided with the WSO2 ESBBPS, using the below commands (outside the MySQL prompt).

...

Excerpt
hiddentrue

Instructions on how to set up WSO2 ESb BPS with MySQL database.