3.1.2. A configuration examples

Service's configuration.


   <component>

      <key>org.exoplatform.services.database.creator.DBCreator</key>

      <type>org.exoplatform.services.database.creator.DBCreator</type>

      <init-params>

      <properties-param>

            <name>db-connection</name>

            <description>database connection properties</description>

            <property name="driverClassName" value="com.mysql.jdbc.Driver" />

            <property name="url" value="jdbc:mysql://localhost/" />

            <property name="username" value="root" />

            <property name="password" value="admin" />

            <property name="additional_property" value="value">

            ...

            <property name="additional_property_n" value="value">

         </properties-param>

         <properties-param>

            <name>db-creation</name>.

            <description>database creation properties</description>.

            <property name="scriptPath" value="script.sql" />

            <property name="username" value="testuser" />

            <property name="password" value="testpwd" />

         </properties-param>

      </init-params>

   </component>

db-connection properties section contains parameters needed for connection to database server

There is four reserved and mandatory properties driverClassName, url, username and password. But db-connection may contain additonal properties.

For example, next additional proprites allows reconnect to MySQL database when connection was refused:


         <properties-param>

            <name>db-connection</name>

            ...

            <property name="validationQuery" value="select 1"/>

            <property name="testOnReturn" value="true"/>

            ...

         </properties-param>

db-creation properties section contains paramaters for database creation using DDL script:

scriptPath: absolute path to DDL script file;
username: user name for substitution ${username} template in DDL script;
password: user's password for substitution ${password} template in DDL script;

Specific db-connection properties section for different databases.

MySQL:


<property name="driverClassName" value="com.mysql.jdbc.Driver" />

<property name="url" value="jdbc:mysql://localhost/" />

<property name="username" value="root" />

<property name="password" value="admin" />

PostgreSQL:


<property name="driverClassName" value="org.postgresql.Driver" />

<property name="url" value="jdbc:postgresql://localhost/" />

<property name="username" value="root" />

<property name="password" value="admin" />

MSSQL:


<property name="driverClassName" value="com.microsoft.sqlserver.jdbc.SQLServerDriver"/>

<property name="url" value="jdbc:sqlserver://localhost:1433;"/>

<property name="username" value="root"/>

<property name="password" value="admin"/>

Sybase:


<property name="driverClassName" value="com.sybase.jdbc3.jdbc.SybDriver" />

<property name="url" value="jdbc:sybase:Tds:localhost:5000/"/>

<property name="username" value="root"/>

<property name="password" value="admin"/>

Oracle:


<property name="driverClassName" value="oracle.jdbc.OracleDriver" />

<property name="url" value="jdbc:oracle:thin:@db2.exoua-int:1521:orclvm" />

<property name="username" value="root" />

<property name="password" value="admin" />