Adding MySQL datasource to JBOSS AS 7

Retrieve the MySQL Connector

The connector can be downloaded from: http://dev.mysql.com/downloads/connector/j/. The current version at the time of writing is 5.1.24, further sections of this guide assume that version number.

Unzip the connector to your downloads folder and save the location of the main JAR in a variable which we can refer to later:

Add a Module to AS 7

AS 7 uses a module system to provide isolation in class loading. We need to create a new module which contains the MySQL Connector J JAR. Move to the the AS installation directory and create the folder structure for the new module:

export JBOSS_HOME=~/Development/jboss-as-web-7.0.0.Final cd $JBOSS_HOME mkdir -p modules/com/mysql/main

Copy the driver jar to the new directory and move to that directory: cp MYSQL_JAR $JBOSS_HOME/modules/com/mysql/main cd $JBOSS_HOME/modules/com/mysql/main

Define the module in XML. This is the key part of the process. 

vi module.xml If the version of the jar has changed, remember to update it here: <?xml version="1.0" encoding="UTF-8"?>   <module xmlns="urn:jboss:module:1.0" name="com.mysql"> <resources> <resource-root path="mysql-connector-java-5.1.24-bin.jar"/> </resources> <dependencies> <module name="javax.api"/> </dependencies> </module> The new module directory should now have the following contents: module.xml mysql-connector-java-5.1.24-bin.jar

Create a Driver Reference

Now the module has been created, we need to make a reference to it from the main application server configuration file:

cd $JBOSS_HOME/standalone/configuration vi standalone.xml

 <subsystem xmlns="urn:jboss:domain:datasources:1.0">
            <datasources>

         <!-- My Local Datasource -->
<datasource
jndi-name="java:/db" pool-name="my_pool"
enabled="true" jta="true" use-java-context="true" use-ccm="true">
<connection-url>jdbc:mysql://localhost:3306/local_db_dev</connection-url>
<driver>mysql</driver>
<security>
<user-name>root</user-name>
<password>root</password>
</security>
<statement>
<prepared-statement-cache-size>100</prepared-statement-cache-size>
<share-prepared-statements/>
</statement>
</datasource>

                              <drivers>
   <driver name="mysql" module="com.mysql">
   <driver-class>com.mysql.jdbc.Driver</driver-class>
                                            <xa-datasource-class>
                                                    com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
                                          </xa-datasource-class>
</driver>
                            </drivers>
           </datasources>
 </subsystem>

Start the Application Server

Now try running the application server. Make sure you run initially as a user which has write access to the modules directory where you placed the MySQL connector JAR. This is because the appication server seems to generate an index of the directories inside the JAR.

Hopefully, among the application server’s console output you should see the following:

20:31:33,843 INFO [org.jboss.as.connector.subsystems.datasources] (MSC service thread 1-1) Bound data source [java:/db]