Helma Logo
main list history
previous version  overview  next version

Version 1 by zumbrunn on 18. February 2009, 21:33

<small><b>Description</b></small>
This file is located in Helma's installation directory. It contains a list of data sources and data source properties setting up the basic connection between Helma and relational databases.

To define data sources, the property <tt>sources</tt> is assigned a comma-separated list of names (certainly, the list can contain only one element):

<tt>sources = <i>dataSourceName</i></tt>

In consequence the following properties of the data source(s) must be set:

<tt><i>dataSourceName</i>.url
<i>dataSourceName</i>.driver
<i>dataSourceName</i>.user
<i>dataSourceName</i>.password</tt>

<small><b>Example</b></small>
<tt>sources = mySqlDB, oracleDB, hsqlDB

mySqlDB.url = jdbc:mysql://db.domain.com/mysql
mySqlDB.driver = org.gjt.mm.mysql.Driver
mySqlDB.user = username
mySqlDB.password = secretPassword

oracleDB.url = jdbc:oracle://db.domain.com/oracle
oracleDB.driver = oracle.jdbc.driver.OracleDriver
oracleDB.user = username2
oracleDB.password = secretPassword2

hsqlDB.url = jdbc:hsqldb:dbData
hsqlDB.driver=org.hsqldb.jdbcDriver
hsqlDB.user=sa
hsqlDB.password=</tt>

Additional properties are ignored by Helma but forwarded to the relational database as connection properties.

<small><b>Example</b> (see http://bugs.mysql.com/bug.php?id=7369)</small>
<tt>sources = mySqlDB

mySqlDB.url = jdbc:mysql://db.domain.com/mysql
mySqlDB.driver = org.gjt.mm.mysql.Driver
mySqlDB.user = username
mySqlDB.password = secretPassword
mySqlDB.zeroDateTimeBehavior = convertToNull</tt>


<small><b>Note:</b></small>
It's possible to set further configuration values in the db.properties as for example:

<tt>mySqlDB.useUnicode=true
mySqlDB.characterEncoding=UTF-8</tt>

see also:
<a href="http://grazia.helma.org/pipermail/helma-user/2004-August/002723.html">  example on the mailing list</a>
<a href="http://help.antville.org/stories/811460/#816656">about charset handling with antville</a>

     removed
     added