Windows インストーラーを利用したアップグレードで過去のインストール ディレクトリの削除に失敗する
プラットフォームについて: 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 は除く
プラットフォームについて: 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 は除く
要約
症状 1
Jira をアップグレードすると、次のエラーで失敗する。Error while attempting to remove the previous installation directory. Some files may be in use. Please close all related programs and try again."
症状 2
エラーは表示されないが "uninstalling previous version" プロセスでスタックし、1 時間以上待っている。これは次の既知の問題です。 - JRASERVER-71842Getting issue details... STATUS
診断
- エラーはインストーラーで返されているため、
atlassian-jira.log
にエラーは存在しない。 - Windows 環境でインストールを行おうとすると、Jira によって次の install4j フォルダにログが記録されます。
<INSTALL-FOLDER>\.install4j\installation.log
<INSTALL-FOLDER>\.install4j\files.log
<INSTALL-FOLDER>\.install4j\error.log
アップグレードまたは遅延を発生させるエラーについては上記のログをご確認ください。
- Jira のインストールおよびローカル ホーム ディレクトリで、大量のデータが含まれるフォルダがあるかどうかを確認します。
- Inspect Jira directory permissions as per the suggestion in How to fix directory permissions in Windows for Jira Server
原因
これは次のいずれかの原因で発生することが確認されています。
- 原因 1: Jira インストーラーが対象のディレクトリに対する適切な権限を持っていない。この件については次の機能リクエストがあります。 - JRA-63068Getting issue details... STATUS
- 原因 2: サービス停止がバックアップ処理の開始に間に合っていない。
- 原因 3: 他のアプリケーションまたはプロセスが Jira のファイルにアクセスしてそれらをロックしている。
- 原因 4: このメッセージは、ディスクに容量が残っていない場合にも表示されます。
- 原因 5: Jira インストーラーで Windows サービスが適切に終了されていない。
- 原因 6: 既存の Jira インストール フォルダ単独で 10 GB 以上のファイル サイズがある。
ソリューション
- 原因 1 のソリューション: インストーラーを実行しているユーザーが Jira ディレクトリに対する適切な権限を持っていることを確認します。
Unix システムの場合、Jira ホーム/インストール ディレクトリで次のコマンドを実行して、異なるユーザーが所有するファイル/ディレクトリを確認できます。
find . ! -user <username>
- 原因 2 のソリューション: アップグレードの実行前に Jira サービスを停止します。
- 原因 3 のソリューション: アップグレード中に対象のファイルにアクセスしてるアプリケーションがないことを確認します。Windows の場合は次の例のように Process Explorer で Find を使うことで行なえます。
- 原因 4 のソリューション: Jira のホーム ディレクトリのディスク領域を増やします。
- 原因 5 のソリューション: インストーラーのアップグレードを続行する前に Windows サービスをシャットダウンします。
- 原因 6 のソリューション: 既存の Jira のインストール ディレクトリのサイズが 1 GB 未満であることを確認します。Jira のインストール フォルダ内の大規模なファイル (logs フォルダなど) を別の場所に移動するかバックアップできます。