Unsupported collation error thrown in Jira server using PostgreSQL
プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Fisheye および Crucible は除く
目的
If your Postgres database doesn't use the recommended collation you can run this procedure to bring them into line with our documentation: Connecting Jira applications to PostgreSQL
以降の手順は、2 つのサーバー間で適切な照合を保持しながら Postgres データベースを移動するためにも使用できます。
ソリューション
はじめる前に
データベースの変更を行う場合は必ず事前にバックアップを取得してください。可能な場合は、まずステージング サーバーで SQL コマンドの変更、挿入、更新、または削除を行うようにします。
該当有無の確認
The following line is being thrown in atlassian-jira.log:
****************************************************************************************************
You are using an unsupported postgres72 collation: ja_JP.UTF-8. This may cause some functionality to not work.
Please use POSIX.UTF-8 or C.UTF-8 or C or POSIX as the collation instead.
****************************************************************************************************Run the following query against your old database. You will need to adjust the collation if it returns any results other than "POSIX.UTF-8", "C.UTF-8", "C", or "POSIX".
SELECT datcollate FROM pg_database WHERE datname='<Jira database name>';照合の変更方法
エクスポート ウィザードが完了すると同じ名前の 2 つのデータベースが作成されるため、このセクションを始める前に十分なディスク容量があることを確認してください。
- Create an XML backup
- Jira を停止します。
Create a new database as per our guidelines and adjust the $JIRAHOME/dbconfig.xml file to change Jira database connection to point to the newly created database (You can also use the Jira Config tool to configure the dbconfig.xml file)
- Please refer to Setting up a PostgreSQL Database for Jira. for more information on how to create the new database and how to configure the dbconfig.xml file.
- Copy or move the backup .zip file created in step 1 into the $JIRAHOME/import/ path
- Start Jira again (when Jira starts connected to an empty database, the setup wizard will start)
- In the setup wizard, choose the option for "Import existing data" (if you reach a screen to create an admin account in the setup wizard, you have gone too far, go back)
- Select the filename.zip located in the $JIRAHOME/import/ which you copied in step 5
- Complete import and ensure that everything is working correctly
- You may want to run Using the database integrity checker to verify your data
お困りですか?
アトラシアン サポートに、次の情報を添えてお問い合わせください。
- 転送プロセスでエラーが発生している場合はエラー メッセージ
- The most recent Jira logs from the Home Directory (if you're having problems starting Jira).
照合の修正の問題のトラブルシューティングをお手伝いいたします。