Database Drivers page of the Tools|Enterprise Setup dialog box

This is a feature of JBuilder Professional and Enterprise.

Select Tools|Enterprise Setup to display the Enterprise Setup dialog box. Select the Database Drivers tab to display the Database Drivers page. Use this page to add a new database driver to JBuilder.

After installing a JDBC driver following the manufacturer's instructions, use the steps below to set it up in JBuilder.

Creating the .library and .config files

There are three steps to adding a database driver to JBuilder:

The first two steps can be accomplished from the Database Drivers page:

  1. Open JBuilder and choose Tools|Enterprise Setup. Click the Database Drivers tab which displays .config files for all the currently known database drivers.
  2. Click Add to add a new driver, then New to create a new library file for the driver. The library file is used to add the driver to the required libraries list for projects.

    Note: You can also create a new library under Tools|Configure Libraries, but since you would then have to use Enterprise Setup to derive the .config file, it is simpler to do it all here.

  3. Type a name and select a location for the new file in the Create New Library dialog box.
  4. Click Add, and browse to the location of the driver. You can select the directory containing the driver and all it's support files, or you can select just the archive file for the driver. Either will work. JBuilder will extract the information it needs.
  5. Click OK to close the file browser. This displays the new library at the bottom of the library list and selects it.
  6. Click OK. JBuilder creates a new .library file in the JBuilder /lib directory with the name you specified (for example, InterClient.library). It also returns you to the Database Drivers page which displays the name of the corresponding .config file in the list which will be derived from the library file (for example, InterClient.config).
  7. Select the new .config file in the database driver list and click OK. This places the .config file in the JBuilder /lib/ext directory.
  8. Close and restart JBuilder so the changes to the database drivers will take effect, and the new driver will be put on the JBuilder classpath.

Important: If you make changes to the .library file after the .config file has been derived, you must re-generate the .config file using Enterprise Setup, then restart JBuilder.

Now that JBuilder can see the database driver, you must add the database driver library to the Required Libraries list in Project|Properties, or Project|Default Properties. See Adding the JDBC driver to projects.