Jira Server のアップグレードまたは移行後にカスタム アバターが不足している
プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。
サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
症状
Custom project, request type, issue type or user avatars are missing after migrating JIRA applications to a new version or different server.
原因
Custom project, request type, issue type or user avatars are not stored as part of the database or XML backup and so need to be migrated manually after upgrading or migrating JIRA applications.
原因 1
If you have recently migrated your JIRA server from one server to another, and your JIRA version is at least 6.1.7, then it's possible that the <jira-home>
/data/avatars directory was not migrated. As this is where general avatars are stored, this directory should be migrated along with the rest of the JIRA file system from the old server.
原因 2
Jira 6.1.7 未満のバージョンからバージョン 6.1.7 以降にアップグレード/移行する場合、Jira インスタンスを開始する前の時点で、既存のインスタンスの avatars ディレクトリが利用可能である必要があります。これは、アップグレード タスクが avatars ディレクトリで実行され、これらのファイルのリネームを行うためです。ファイルが利用できない場合はファイルの更新が行えず、avatars ディレクトリとファイル システムとの同期が失われます。
この状況を回避するには、Jira を Jira 6+ 環境にアップグレードする前に avatars ディレクトリのコピーを取得し、Jira ホームの avatars ディレクトリに配置します。これにより、アバターが期待されたバージョンに正常に移行されます。
Basically, you must have the avatars directory ready and available in the avatars directory (under <jira-home>
/data/avatars) when upgrading to JIRA 6.1.7 and higher from a version older than 6.1.7.
診断
原因 1
- Your JIRA version is equal to or greater than 6.1.7
- JIRA_HOME/data/avatars (or if multi-node data Jira Data Center,
<jira-shared-home>
/data/avatars) was not migrated with the other JIRA data
原因 2
- You upgraded/migrated JIRA from a version less than JIRA 6.1.7 to a version equal or greater than version 6.1.7
- Jira データベースで次のクエリを実行します。
SELECT id, filename FROM avatar;
- avatars ディレクトリ
<jira-home>/data/avatars/
のファイル名が、報告されたファイル名に一致することを確認します。ファイル名はID_[size]_FILENAME
の形式を持ちます。 In some cases you may notice an extension:
'*jrvtg.png'
This is an indication that the avatar files have been upgraded from an older version of JIRA.
ソリューション
- 古い Jira アプリケーション インスタンスの
<jira-home>/data/avatars/
にある画像を新しいインスタンスに移動またはコピーします。 - If Cause 2, ensure the Avatars directory file names match those in the database
The same applies for user profile custom avatars.