Jira Server のアップグレードまたは移行後にカスタム アバターが不足している


アトラシアン コミュニティをご利用ください。



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 の形式を持ちます。
  • (info) '*jrvtg.png' 拡張子が表示される場合があります。これは、アバター ファイルが Jira の古いバージョンからアップグレードされていることを示唆しています。 


  1. 古い Jira アプリケーション インスタンスの <jira-home>/data/avatars/ にある画像を新しいインスタンスに移動またはコピーします。
  2. If Cause 2, ensure the Avatars directory file names match those in the database

Below there is an example of custom avatars, and the relation between the database entries and file system:

Custom project avatar

Custom project request type avatar

Custom issue type avatar

Database entries and file system files on <jira-home>/data/avatars

The same applies for user profile custom avatars.

最終更新日 2022 年 6 月 27 日


Powered by Confluence and Scroll Viewport.