JNDI Data Sources

The JNDI data source accesses a database connection previously defined in the application server and published as a JNDI resource or service. Instead of specifying a driver and database as you do with JDBC data sources, you need to specify only the JNDI service name in your application server.

Application servers use JDBC connections themselves to expose a database through JNDI. You must specify the JNDI service name of a JDBC connection. Your application server must also have the appropriate JDBC drivers and be configured to use them.

For information about setting up a JNDI connection in your application server, see the following sections:

JNDI Services on Apache Tomcat
Working With Data Sources
JNDI Services on WebLogic

To create a JNDI data source:

1. Log on as an administrator.
2. Click View > Repository, expand the folder tree, and right-click a folder to select Add Resource > Data Source from the context menu. Alternatively, you can select Create > Data Source from the main menu on any page and specify a folder location later. If you installed the sample data, the suggested folder is Data Sources. The New Data Source page appears.
3. In the Type field, select JNDI Data Source. The information on the page changes to reflect what’s needed to define a JNDI data source.

You have the option to use profile attributes to derive the values for data source parameters. See Attributes in Data Source Definitions

4. Fill in the service name. This is the name the application server exposes through JNDI.

JNDI Data Source Page

Set the Time Zone field when the date-time values stored in the target RDBMS do not indicate a time zone. When date-time values are stored in a format other than local time zone offset relative to Greenwich Mean time (GMT), you must specify a time zone so that the server can convert date-time values read from the target database properly. Set the Time Zone field to the correct time zone for the data in the data base. The list of available time zones is configurable, as described in Specifying Additional Time Zones.

When in doubt, leave the Time Zone field blank.

5. Click Test Connection to validate the data source. If the validation fails, ensure that the values you entered are correct, that the database is exposed through JNDI, and that the database is running. Also see the troubleshooting section JNDI Services on Apache Tomcat.
6. When the test is successful, click Save. The Save dialog appears.

Saving the JNDI Connection

7. Enter the data source name and, optionally, a description. the Resource ID appears based on the name you enter.
8. Expand the folder tree and select the location for your data source, then click Save. The data source appears in the repository.

For details about configuring and exposing a JNDI database connection at the application server level, refer to the documentation provided with your application server.