How to configure extra parameters to your database connection in Bonita?

Blog Categories: 

Component: Bonita | Version: 7.4+ | Edition: Subscription


How do I configure my database connection to handle my Oracle RAC, or my MySQL Database encoding?


You will have to add your configuration to the file located at the root of the setup folder, i.e: BonitaSubscription-7.9.4-tomcat/setup/

Important: First of all, as explained in the header of the file, this file should not be modified manually in most cases, unless you know exactly what you are doing.

The file is used internally by the setup tool to properly configure and initialize the bundle. It is made of both data entered in as well as other data like database driver class name, connection URL, etc. This file should not be modified manually in most cases, unless for specific use-cases like adding parameters in the connection URL or using a specific database driver.

This file contains the Database configuration information that are not inside file (database driver class name, connection URL, etc).
Those information are used internally by the tool to configure properly the bundle + the setup initialization procedure. They use the values provided in file as replacement strings to build new values that will be injected in the tool.


You are allowed to modify these values if, for instance, for Oracle RAC, you need to add parameters in the connection URL, or for MySQL you need to add characterEncoding or other parameter.

Or also if you need to use a specific database Driver java class name.

But in most cases, you don't need to modify this file.


- Example : Oracle RAC:



- Example : Oracle with ServiceName instead of SID:
In this case, the in the file contains the ServiceName instead of the SID.



- Example : MySQL with characterEncoding: