Versions Compared

Key

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

ContentContents

Table of Contents
outlinetrue
stylenone

...

If you have installed DBCF 3.0.x on JIRA 7.x or DBCF 3.1.x / DBCF 4.0.x on JIRA 6.x, perform the following steps:

  1. Uninstall katl-commons.
  2. Uninstall Power Database Fields PRO.
  3. Install the version of Power Database Fields PRO that is compatible with your Jira.
  4. katl-commons should get updated automatically and should now have the correct version as well.

    Note

    After you uninstall katl-commons, some plugins might remain disabled, so you might need to re-enable them manually.


...

Expand
titleStep-by-step guide for SQL Server databases
  1. Download the latest jdbc driver for sql server (at this moment it is sqljdbc4.2)  
  2. Extract the archive and copy the .jar file (sqljdbc42.jar) to lib folder, from your JIRA
  3. Update the resource from context.xml accordingly. It should look like this:

    Code Block
    <Resource name="CONNECTION_NAME"
        auth="Container"
        type="javax.sql.DataSource"
        username="USERNAME"
        password="PASSWORD"
        driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
        url="jdbc:sqlserver://SERVER:PORT;DatabaseName=DATABASE_NAME"/>


  4. Restart Jira.

...

Expand
titleStep-by-step guide for Postgres databases
  1. Download the latest jdbc driver for Postgres (at this moment it is postgresql-9.4-1204.jdbc4)  
  2. Copy the .jar file (postgresql-9.4-1204.jdbc4.jar) to lib folder, from your JIRA

  3. Restart Jira.

Note

The same problem might occur for other databases as well (Oracle, MySQL, hsql). In this case, follow the same steps, updating the driver and restarting the Jira instance.

Starting with version 4.0.0, you no longer need to change the resource in the context.xml file and can add the resource directly from the UI, via the Datasources page.


...

Expand
titleStep-by-step guide
  1. Go to the Database Custom Field page.
  2. In the SQL query, usually in the WHERE clause, use the custom field id (e.g. customfield_12345) or the standard fields between braces. You can find the list of standard fields and more details about dynamic query on the Dynamic Query (SQL) page.

Info

Note that this only works for single value Custom Fields. If you need to use multiple value CF, there is a recipe for it here: Using DBCF Database custom fields queries: IN clauses