問題

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

診断

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)

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

ソリューション

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

• メモリの割り当て
• アンチウィルス ソフト
• プラグインのキャッシュの破損
• 互換性のない Java バージョン
• データベースでプラグインが無効化されている
• プラグイン側で起動のための時間が不足している
• Jira がロックされている
• Incompatible or Obsolete Plugins
• ディスクからプラグインを読み込むためのパフォーマンスが低速
• カスタマイズされた誤った OGSI bootdelegation 値が設定されている

• Incorrect Jira Shared Home Location (Clustered Data Center Only)

メモリの割り当て 

原因

During the startup process, the bundled plugins are unpacked from the $JIRA_INSTALL/atlassian-jira/WEB-INF/classes/atlassian-bundled-plugins.zip file into $JIRA_HOME/plugins/.bundled-plugins, while the $JIRA_HOME/plugins/installed-plugins are extracted to $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 のクラッシュとパフォーマンスの問題のよくある原因」をご参照ください。

There are cases where you will see "com.atlassian.plugin.PluginParseException: Cannot open JAR file:" error in the the logs. In this case, please check KB on Jira Data Center node will not start due to restricted access to $SHARED_HOME for further details. 

原因

The Jira application fails to start after java.lang.NoClassDefFoundError: PanwHooks exception. This exception can be found in the atlassian-jira.log file. This is caused by a security malware scanner blocking the Jira process from starting as they found Log4j libraries as vulnerable.

ソリューション

Our Security team investigated the impact of the Log4j remote code execution vulnerability (CVE-2021-44228) and has determined that no Atlassian on-premises products are vulnerable to CVE-2021-44228. Please check the FAQ for CVE-2021-44228 for more detail. Further information regarding this can be viewed in this KB - Jira is not starting up after java.lang.NoClassDefFoundError: PanwHooks exception.

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

原因

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 のクエリが結果を返さない場合、このソリューションは現在の状況に適用されない点にご注意ください。

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

原因

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

ソリューション

Increase the value for the parameter below so that JIRA provides more time for the plugins to be extracted, instead of cutting it off and assuming that it failed to startup. Use one of the methods mentioned in Setting Properties and Options on Startup:

-Datlassian.plugins.enable.wait=600

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 で監視エージェントと連携しているときにプラグインの読み込みエラーで開始に失敗する」をご確認ください。 

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

原因

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

ソリューション

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

Incorrect Jira Shared Home Location (Clustered Data Center Only)

原因

Jira Data Center will initialize plugins from the cluster's configured Jira shared home location.  If the shared home location is incorrect or inaccessible Jira will fail to start.  

ソリューション

Update the cluster.properties file within each node to point to the correct shared home location for the cluster.  Additional details around configuring the shared home location can found within Set up a Jira Data Center Cluster (steps 2 and 3).