Follow the below instructions to set up the remote Derby database.
Preparing the Derby Database
1. Download Apache Derby from http://apache.mesi.com.ar/db/derby/db-derby-10.8.2.2/ and save it to your computer.
2. Install Apache Derby on your computer using instructions given at http://db.apache.org/derby/manuals.
3. Go to the
<derby-installation directory>/bin directory and run the Derby network server start script. Usually, it is named
Setup Configuration Files
1. Edit the default database configuration defined in the
master-datasources.xml file located at
$CARBON_HOME/repository/conf/datasources directory as below. Both the database configurations in
user-mgt.xml refer this data source.
Replace the following settings with your own custom values:
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.
In contrast to the embedded Derby, in the remote registry, you will set the database driver name (the
driverName element) to the value
org.apache.derby.jdbc.ClientDriver and the database URL (the
url element) to the database remote location.
$DERBY_HOME/lib in to
$CARBON_HOME/repository/components/extensions directory (to the class path of the WSO2 ESB web application).
Automatic Database Creation
1. The first time you start the server, run it with the -Dsetup option so that it will create the Derby database.
- For Windows:
- For Linux:
2. The WSO2 ESB is configured to run using a remote Apache Derby database.
Manual Database Creation
1. Run the
ij tool located in the
<derby-installation directory>/bin directory.
2. Create the database and connect to it using the following command inside the
Replace the database file path, user name, and password in the below command to suit your requirements.
3. Exit from the
ij tool by typing the exit command.
4. Log in to the
ij tool with the username and password you just used to create the database.
5. Run the Derby scripts for both the registry and user manager (embedded) databases, provided with the WSO2 ESB, using the following command:
6. Restart the server. Now WSO2 ESB is running using a remote Apache Derby database.