Versions Compared

Old Version 3

changes.mady.by.user Sireesha Dugginapeddi [Appfire] (Inactive)

Saved on

compared with

New Version 4

changes.mady.by.user Saumya Sunder (Inactive)

Saved on

Key

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

...

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.

...

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 in 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 cover 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. User's Guide is an example of adding a few datasources for various local and non-local databases.

The essential element is something like the following, where the datasource name is myDS:

...

  1. In the WebLogic console, under Services > JDBC, create a data source (see WebLogic's documentation on how to Configure JDBC data sources for more information).
  2. Take note of the JNDI name you used to create the data source.
  3. Point the SQL macro to that JNDI name (datasource parameter).

...

  • Check your application server (server.xml) configuration and ensure the DNS host name is valid on the server running confluence

    No Format
    sql: Unexpected program error: com.atlassian.renderer.v2.macro.MacroException:
 org.apache.tomcat.dbcp.dbcp.SQLNestedException:
 Cannot create PoolableConnectionFactory (Unknown server host name 'myserver'.)


Error - port

  • Database The database may not be listening on the requested port - verify the port configuration in server.xml and database

    No Format
    sql: Unexpected program error: com.atlassian.renderer.v2.macro.MacroException:
 org.apache.tomcat.dbcp.dbcp.SQLNestedException:
 Cannot create PoolableConnectionFactory (Network error IOException: Connection refused)


...

  • Make sure your database server is accepting connections from the Confluence server TCP address and the user is authorized to connect.

...

Add a validation query to your configuration. This helps the application server connection pool to recover from database connection problems.

...