Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel3
minLevel3
maxlevel3
minlevel3
typeflat
separatorpipe

 

 

Warning
titleArchive

This page has been replaced by Configure Application Server-based Data Sources and Data source configuration - problem determination. Some of the information is out of date with respect to new releases of the add-on. However, we have kept the page as it has comments and answers that may still be helpful.

...

Summary

Section


Column

SQL uses datasources defined to the application server to gain access to the database. The datasource is refenced using the datasource parameter. The exact configuration of a datasource is application server and database specific. The configuration must be done by a Conflunece administrator and the Confluence application server must be restarted for changes to be active. The configuration must be done very carefully as any errors will result the datasource being unusable (sad). Each database you need to access in Confluence needs to a have a datasource configuration.

These are the major elements of the configuration

  1. Application server datasource configuration - consult your application server documentation on how this is done and problem determination mechanisms. Note that the configuration may be specific to the application server version. For example, older Tomcat versions have some different configurations.
  2. JDBC driver specific for the database to be accessed - consult your database documentation and other sources for the best JDBC driver to use.
  3. Installation of JDBC driver on the application server
  4. Database access - consult your database documentation on how to configure your database for access

Various users have provided some examples that covers many standard situations. This page can be used to share that type of information as well as problem determination information. This is the best place to start especially if you are not an expert in this area.


Column


Info
titleJust Upgraded Confluence?

A common problem is errors after upgrading Confluence. Ensure that your upgrade procedures include updating your server.xml and copying all the JDBC drivers you use into the appropriate location. Also, check out this page for isolating these or application server version differences that cause problems. If you get errors immediately after an upgrade, this is the most likely cause.



...

Modify <install-dir>/conf/server.xml to add one or more datasource resource elements. server.xml User's Guide - archive is an example of adding a few datasources for various local and non-local databases.

...