Health Check: Database Collation in Microsoft SQL Server

Still need help?

The Atlassian Community is here for you.

Ask the community

This Knowledge Base article was written specifically for the Atlassian Server platform. Due to the Functional differences in Atlassian Cloud, the contents of this article cannot be applied to Atlassian Cloud applications.

Purpose

This check retrieves the collation of the database and determines if it is within the list of collations supported by Atlassian. This article focuses on Microsoft SQL Server. For more about details please check Health Check: Database Collation.

Understanding the Results 

The database collation '<collation>' and table collation '<collation>' are supported by JIRA.

The database is configured using a supported collation.

The database collation '<collation>' and table collation '<collation>' are not supported by JIRA.

The JIRA instance is using an unsupported configuration. See the Resolution section for steps on how to resolve this issue.

The database collation '<collation>' is unsupported by JIRA. The table collation '<collation>' is supported by JIRA.

The JIRA instance is using an unsupported configuration. See the Resolution section for steps on how to resolve this issue.

The table collation '<collation>' is unsupported by JIRA. The database collation '<collation>' is supported by JIRA.

The JIRA instance is using an unsupported configuration. See the Resolution section for steps on how to resolve this issue.

Solution 

To fix this, the database collation needs to be corrected. The best and recommended way to achieve this is:

  1. Create a new database with the required collation as per the appropriate documentation in Connecting JIRA to a Database.
  2. Follow our Switching Databases to migrate JIRA from the old databases (with the incorrect collation) to the new one, with the correct collation.

Supported Collations in Microsoft SQL Server

  • SQL_Latin1_General_CP437_CI_AI
  • Latin1_General_CI_AI

How to Verify Table Collations

SELECT DISTINCT C.collation_name 
FROM   sys.tables AS T 
       INNER JOIN sys.columns C 
               ON T.object_id = C.object_id 
WHERE  collation_name IS NOT NULL; 

How to Verify Database Collations

SELECT DISTINCT C.collation_name 
FROM   sys.tables AS T 
       INNER JOIN sys.columns C 
               ON T.object_id = C.object_id 
WHERE  collation_name IS NOT NULL; 

There is a known bug where Latin1_General_CI_AI is displayed as an unsupported database in JIRA. The bug fix is released on JIRA 7.8.0  JRASERVER-59378 - Getting issue details... STATUS

Description This check retrieves the collation of the database and determines if it is within the list of collations supported by Atlassian. This article focuses on Microsoft SQL Server.
Product Jira, Confluence, Bamboo, Bitbucket, Fisheye, Crucible
Platform Server
Last modified on Oct 11, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.