-
Bug
-
Resolution: Fixed
-
Low
-
6.14.1
-
43
-
Severity 3 - Minor
-
9
-
Problem Definition
When upgrading Confluence to 6.14 or later, admins see the following message that English_United States.1252 is not UTF-8
This is a false warning and can be ignored, provided the client encoding is set correctly.
Background
I've had several users on Community reach out to me regarding this confusion, for example:
Until September 2019, the Database Setup for Postgresql doc specified that:
Collation must also be set to utf8. Other collations, such as "C", are known to cause issues with Confluence.
This is clear to Linux users, but for Windows users, their options might look like the following:
- C
- POSIX
- English_United States.1252
During setup of the database in Windows, users are to select a locale, and are presented with the following selections:
Expected behavior
Confluence health check does not give the false warning when using .1252 collations
Suggested Solution
We should update the health check to accept the Windows equivalent of UTF-8.
Notes
UTF-8 encoding can be used with any locale.
In addition, I reviewed this blog post, Locale in Windows, and it appears that you should be able to use English_United States.1252.
Although I believe this is addressed with the following line:
Choose the locale that best matches your geographic location.
- relates to
-
CONFSERVER-58052 post-upgrade health-check throws false warning: The database collation 'en_US.utf8' is not supported by Confluence. You need to use 'utf-8'.
-
- Closed
-
-
XPLN-992 You do not have permission to view this issue
-
XPLN-1027 You do not have permission to view this issue
-
XPLN-1238 You do not have permission to view this issue
- mentioned in
-
Page No Confluence page found with the given URL.
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
Form Name |
---|
I have added the following note to the documentation to indicate that you should use the UTF-8 equivalent character type and collation when running PostgreSQL on Windows.
If you are running PostgreSQL on Windows use the equivalent character type and collation for your locale, for example English_United States.1252.
I will leave this issue open, and update the description to make it about improving the upgrade check to recognise this collation.