Troubleshoot a Jira Server startup failed error

お困りですか?

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

コミュニティに質問

プラットフォームについて: Server と 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)


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

ソリューション

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

メモリの割り当て 

原因

起動プロセス中、バンドルされたプラグインは $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 ディレクトリにあります) をアンチウィルス ソフトウェアがスキャンした場合、起動プロセスを妨害したり停止させたりして、正常な実行の妨げになることがあります。 

ソリューション

Exclude your JIRA INSTALLATION DIRECTORY and your JIRA HOME DIRECTORY from being scanned by the anti-virus. However, sometimes, even though an exception has been added, the problem might still persists, in those cases, please try disabling your anti-virus entirely. Further information regarding the correlation between anti-virus and JIRA application performance can be viewed in this KB - Common causes for Jira Server crashes and performance issues.

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

原因

Jira アプリケーション インスタンスのプラグイン キャッシュが破損している可能性があります。このような破損したキャッシュにより、Jira アプリケーションの処理が中断されたり、Jira アプリケーションが起動できない場合があります。

ソリューション

プラグインのキャッシュをクリアし、再作成する必要があります。これを行うには、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 ホーム ディレクトリのロックを解除する方法」をご参照ください。

A customized incorrect OGSI boot delegation value is set

原因

If the startup parameter -Datlassian.org.osgi.framework.bootdelegation is defined, it may conflict with Jira's required defaults when using Java 11. This parameter may have been set to support a monitoring agent. 

ソリューション

See Jira fails to start on Java 11 with plugin load errors when integrated with a monitoring agent for instructions. 


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

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

はい
いいえ
この記事についてのフィードバックを送信する

このセクションの項目

Powered by Confluence and Scroll Viewport.