Example: Deploying MySQL JDBC driver

As an example, this section explains the specific steps required to register the JDBC driver for the MySQL database.

To register the JDBC driver for the MySQL database:

  1. Unzip the BundleWrapper zip file. If possible, extract the BundleWrapper in C:\temp. If you use a different location, see the InstallPath property in step 5.
  2. Download the MySQL JDBC driver binary jar com.springsource.com.mysql.jdbc-5.1.6.jar from this location:

    http://ebr.springsource.com/repository/app/bundle/version/detail?name=com.springsource.com.mysql.jdbc&version=5.1.6

    Note: If you used Internet Explorer, the file might be downloaded with a .zip extension. If so, rename the downloaded file: change the extension to .jar.
  3. The JDBC driver of MySQL comes in a single jar and can be used as such. Therefore, you can skip the preparation step to merge multiple jars into one jar file. Place the com.springsource.com.mysql.jdbc-5.1.6.jar in the BundleWrapper\OriginalJar folder.
  4. Rename the BundleWrapper\examples\properties.mysql.txt file to properties.txt and copy this file to the \BundleWrapper folder. Modify this file to reflect the driver specifics.

    See Properties.

  5. Run build.bat. A zip file (OSGi bundle) is generated. This file is required to start up the bundle.
  6. Complete these steps:
    1. In ION Desk, select Configure > ION Service. Then click the Configuration Files tab.
    2. In the Custom database drivers section, click Upload.
    3. Upload the zip file.