Jira Server の Startup Failed エラーのトラブルシューティング

お困りですか?

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

コミュニティに質問

プラットフォームについて: サーバーと Data Center のみ。この記事は、サーバーおよび Data Center プラットフォームのアトラシアン製品にのみ適用されます。

問題

このページは、スタートアップに失敗する問題のトラブルシューティングのための全般的なガイドです。エラーについて詳細に解説している多数のナレッジベース記事へのリンクもご案内します。

診断

Jira アプリケーションを起動しようとすると失敗する。"JIRA Startup Failed" という旨のエラーが表示される。

JIRA Startup Failed

You cannot access JIRA at present. Look at the table below to identify the reasons:

Description

The following plugins are required by JIRA, but have not been started:

* Atlassian JIRA - Plugins - Project Config Plugin (com.atlassian.jira.jira-project-config-plugin)
* Embedded Gadgets Plugin (com.atlassian.gadgets.embedded)
* Gadget Dashboard Plugin (com.atlassian.gadgets.dashboard)
* Opensocial Plugin (com.atlassian.gadgets.opensocial)
* Gadget Directory Plugin (com.atlassian.gadgets.directory)
* Atlassian JIRA - Plugins - Gadgets Plugin (com.atlassian.jira.gadgets)

(info) 上述の例のプラグインに特定のパターンはなく、多くの場合はランダムで表示される点にご注意ください。

ソリューション

さまざまな原因が考えられ、それぞれについて個別の解決方法があります。 

メモリの割り当て 

原因

起動プロセス中、バンドルされたプラグインは $JIRA_INSTALL/atlassian-jira/WEB-INF/classes/atlassian-bundled-plugins.zip ファイルから展開されて $JIRA_HOME/plugins/.bundled-plugins になり$JIRA_HOME/plugins/installed-plugins$JIRA_HOME/plugins/.osgi-plugins. に抽出されます。

このプロセスはリソースの使用量が比較的大きく、必要なリソースが不足している場合、展開中にプラグインがタイムアウトして Jira アプリケーションが使用できなくなります。 

ソリューション

Jira アプリケーション インスタンスのメモリを増やす必要があります。必要な増加量はインスタンスのサイズに依存するため、具体的な推奨値はありません。Jira アプリケーションを Linux で使用しているか、Windows でスタンドアロン アプリケーションとして使用しているか、または Windows サービスとして実行しているかどうかに応じて、異なる方法でメモリを増やします。これら 3 つの方法については、ナレッジベース記事「Jira のメモリを増加させる」で詳細に説明しています。

アンチウィルス ソフト

原因

Jira アプリケーションとアンチウィルス ソフトウェアは競合が発生することが多く、同じタイミングに同じ場所で実行することが難しい場合があります。起動中、Jira アプリケーションは多数の一次ファイルを作成し、そこから読み取りを行います。これらすべてのファイル (通常は JIRA_INSTALLATION または JIRA_HOME ディレクトリにあります) をアンチウィルス ソフトウェアがスキャンした場合、起動プロセスを妨害したり停止させたりして、正常な実行の妨げになることがあります。 

ソリューション

アンチウィルスのスキャン対象から JIRA INSTALLATION DIRECTORY と JIRA HOME DIRECTORY を除外します。ただし場合によっては、例外を追加したにもかかわらず、問題が継続することがあります。このような場合はアンチウィルス ソフトウェア全体を無効化することをお試しください。アンチウィルス ソフトウェアと Jira アプリケーション のパフォーマンスの相関の詳細については、ナレッジベース記事「Jira Server のクラッシュとパフォーマンスの問題のよくある原因」をご参照ください。

プラグインのキャッシュの破損

原因

It is possible the plugin caches of your JIRA application instance enter into a corrupted state. These corrupted caches can disrupt your JIRA application operations, as well as cause your JIRA applications to not be able to startup.

ソリューション

プラグインのキャッシュをクリアし、再作成する必要があります。これを行うには、Jira を再起動します。これによってプラグインのキャッシュが再作成されます。

次の手順でプラグイン キャッシュを手動でクリアすることもできます。

  • Jira を停止します。 
  • <Jira ホーム>/plugins/.bundled-plugins ディレクトリを削除します (これは再起動時に再生成されます)
  • <Jira ホーム>/plugins/.ogsi-plugins ディレクトリを削除します (これは再起動時に再生成されます)
  • Jira を起動します。

互換性のない Java バージョン

原因

Jira アプリケーションの実行には Java が必要です。Jira 5.1.x などの Jira アプリケーションの古いバージョンは、Java 7 (JDK 1.7) との互換性を持ちません。Jira 5.0.x を Java 7 で実行すると、プラグインに問題が発生します。

ソリューション

Java のサポート対象バージョンを実行していることを確認します。Jira のサポート対象プラットフォームのページを参照し、ご利用の Jira アプリケーションのバージョンを選択します。

データベースでプラグインが無効化されている

原因

プラグインがデータベースで無効化されているために起動できない場合があります。これらを有効化して使用するには、SQL 操作が必要です。

ソリューション

プラグインを有効化するために使用できる SQL クエリがあります。この詳細については、ナレッジベース記事「プラグインが無効化されているために Jira を起動できない」をご参照ください。

ステップ 2 のクエリが結果を返さない場合、このソリューションは現在の状況に適用されない点にご注意ください。

プラグイン側で起動のための時間が不足している

原因

プラグインの抽出はリソースの使用量が比較的大きいため、リソースが不足している場合に抽出プロセスに時間がかかることがあります (リソースは不足してはいるものの、インスタンスを起動するための必要量は満たしているため、全体のシャットダウンは行われません)。 

ソリューション

パラメータを編集して、Jira がプラグインの抽出に十分な時間を提供し、起動に失敗したと見なして処理を中断しないようにします。これを行うには、Jira アプリケーションの起動パラメータに次の値を挿入します。挿入方法については「起動時のプロパティとオプションの設定」をご参照ください。

-Datlassian.plugins.enable.wait=300

Jira アプリケーションに変更を反映するため、パラメータを追加したあとはインスタンスを再起動してください。

Jira アプリケーションがロックされている

原因

プラグインの抽出はリソースの使用量が比較的大きいため、リソースが不足している場合に抽出プロセスに時間がかかることがあります (リソースは不足してはいるものの、インスタンスを起動するための必要量は満たしているため、全体のシャットダウンは行われません)。 

  1. Jira アプリケーションが不正にシャットダウンされたか、シャットダウンに失敗した。
  2. 同じデータベースを指している 2 つめの Jira アプリケーション インスタンスが開始された。これは、Jira アプリケーションのテスト インスタンスが本番環境を指している場合に発生する可能性があります。
  3. 稀に、プラグインのインストール後、Jira アプリケーションで起動時に PermGen メモリが不足する場合があります。「Jira が java.lang.OutOfMemoryError PermGen Space エラーでクラッシュする」をご参照ください。

ソリューション

Jira アプリケーションのロック ファイルを削除します。手順については、「Jira ホーム ディレクトリのロックを解除する方法」をご参照ください。

Obsolete or incompatible plugins

原因

Incompatible or obsolete plugins could cause start up issues. The logs might show an error as below:

2 plugins are unaccounted for.
    Unaccounted for plugins load as artifacts but fail to resolve into full plugins.


ソリューション

Remove incompatible plugins jar files from  Jira Home Directory/plugins/installed-plugins folder. 

ディスク読み込みのパフォーマンスが低速

原因

I/O が低速なため、Jira で時間内にプラグインを読み込めません。

ソリューション

IO パフォーマンスを確認するためのディスク速度のテストを実行します。よくあるソリューションには次のようなものがあります。

  • リモート ディスクまたは共有ドライブ。
  • アンチウイルス ソフトまたは別のスキャン アプリケーション。
  • 低速なネットワーク上での他のマシンへの同期。
  • VMware などの仮想化 OS (詳細については「Jira サーバーを仮想環境で実行する」をご確認ください)。
  • ディスクのデフラグ ジョブが実行中である。
  • ディスク障害などの、ハードウェアの問題。
  • ファイル システムの暗号化。
  • OS が制御している、ファイルの自動圧縮。
  • Java バージョンと OS での固有の問題。これは稀な例ですが、JVM 内のバグや既知の問題が特定の OS でパフォーマンスを悪化される可能性があります。
  • ディスクを同時に使用している他のアプリケーションまたは処理。
  • ディスクのキャパシティが満杯に近い。特定の OS ではこれによってディスクでのパフォーマンスが悪化する場合があります (この例の場合は Solaris)。
  • Windows で、Lucene のファイル削除で問題が発生している。

カスタマイズされた誤った OGSI bootdelegation 値が設定されている

原因

起動パラメーター -Datlassian.org.osgi.framework.bootdelegation が定義されている場合、Java 11 を利用する場合に Jira で要求されるデフォルト値と競合している可能性があります。このパラメーターは監視エージェントをサポートするために設定されている可能性があります。

ソリューション

手順については「Jira を Java 11 で監視エージェントと連携しているときにプラグインの読み込みエラーで開始に失敗する」をご確認ください。 

説明このページは、スタートアップに失敗する問題のトラブルシューティングのための全般的なガイドです。エラーについて詳細に解説している多数のナレッジベース記事へのリンクもご案内します。
製品Jira
プラットフォームサーバー
最終更新日 2022 年 8 月 8 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.