インストール、アップグレード、または起動中に、Jira では多数のチェックが実行されます。Jira Build Version チェックでは、データベースに保存されているデータのバージョンが、実行しようとしている Jira のバージョンで使用できることを確認します。チェックに失敗すると、Jira は起動に失敗します。これは、データが破損する可能性を防ぐためです。

原因

この問題は起こるべきではないものですが、データおよび Jira インスタンスがこの状態になるケースがいくつかあります。

• テスト、ステージング、または開発環境で新しいバージョンの Jira を試したものの、データベース構成を変更するのを忘れて、本番データベースに対して実行した可能性があるこれにより、データがアップグレードされている可能性がある。
• Jira をアップグレードし、その後、ダウングレードしようとした。
• 移行先のインスタンスよりも新しいバージョンの Jira を使用していた既存の Jira インスタンスからデータを移行している。
• Jira Cloud から Jira Server への移行している。

影響

Jira インスタンスを追加のチェックを行わずに起動しないでください。Jira のバージョンが異なると、異なるデータベース内構造に依存している可能性があります。そのため、間違ったバージョンのデータベースで Jira を実行すると、重大なデータ損失が発生する可能性があります。また、特定のデータベーステーブルが利用できず、Jira の実行が不可能になる場合もあります。

ソリューション

最善かつ最も安全な解決策は、Jira を最新バージョンにアップグレードすることです。これにより、データと Jira バージョンが更新され、同じレベルに同期されます。Jira インスタンスをアップグレードする方法についての完全なガイドは、「Jira アプリケーションのアップグレード」を参照してください。

代替ソリューション: データをダウングレードする

別の解決策は、現在の Jira バージョンと互換性のあるバージョンにデータをダウングレードすることを試みる方法です。

To do this, add the -Djira.downgrade.allowed=true parameter to Jira according to the steps of our Setting properties and options on startup documentation, then restart the application.

 これにより Jira はデータをダウングレードできるかどうか確認し、ダウングレードできる場合はダウングレードを試みます。お客様のセットアップで利用できるかどうかは保証されません。

代替ソリューション: データベース バックアップ

古いデータ バージョンのデータベース バックアップがある場合は、これを使用してデータベースの修復を試みることができます。