Required plugin com.atlassian.stash.ssh-plugin has failed to start エラーで起動できない

質問

Bitbucket Server サービス起動後、TOPページへアクセスすると以下のエラーが表示され、Bitbucket Server の画面を表示できない。

A fatal error has occurred

The following problem occurred, which prevents Atlassian Bitbucket from starting:

  • Required plugin com.atlassian.stash.ssh-plugin has failed to start

回答

Bitbucket Server の起動待ち時間を延長することで解決できる可能性があります。

Bitbucket Server 起動時にアドオンも合わせて起動していきますが、これらの処理がデフォルトの待ち時間(60秒)に間に合わず、Bitbucket Server の起動に失敗するケースがあります。

以下の手順で起動待ち時間を300秒へ延長するオプションを追加し、改善されるかご確認をお願いします

  1. Bitbucket Server サービスを停止する。
  2. 以下のプラグインキャッシュディレクトリを削除する。

    <Bitbucket_Home>/plugins/.bundled-plugins
    <Bitbucket_Home>/plugins/.osgi-cache
  3. <Bitbucket_INSTALL>/bin/_start-webapp.shを開き、以下のパラメータを追加する。
    (Bitbucket Server ver.4.xの場合は、<Bitbucket_INSTALL>/bin/setenv.sh)

    JVM_SUPPORT_RECOMMENDED_ARGS="-Datlassian.plugins.enable.wait=300"
  4. Bitbucket Server サービスを起動する。


上記対応で回避できない場合は、以下の対応をお願いします。

本現象に関する Atlassian社 のドキュメントは以下になります。ドキュメントに記載の Situation ごとに検証します。

"Required plugin com.atlassian.stash.ssh-plugin has failed to start" is displayed when accessing the Bitbucket Server web interface

Situation 2 は冒頭で紹介した方法となりますので、残りの Situation 1 と Situation 3 を検証します。

Situation 1 

仮想環境でよく発生する現象で、/dev/random の乱数生成処理が遅い場合に発生する事例があります。
/dev/random を /dev/urandom へ変更する方法で回避されるか確認します。

(情報) /dev/urandom に変更した場合、この設定は高速動作が目的であり、安全性に欠けますため、セキュリティ上問題になる可能性があります。そのため、設定時はサーバー管理者へ確認をお願いします。

  1. Bitbucket Server サービスを停止する。
  2. <Bitbucket_INSTALL>/bin/_start-webapp.sh を開き、以下のパラメータを追加する。
    (Bitbucket Server ver.4.xの場合は、<Bitbucket_INSTALL>/bin/setenv.sh)

    JVM_SUPPORT_RECOMMENDED_ARGS="-Djava.security.egd=file:/dev/./urandom"
  3. Bitbucket Server サービスを起動する。

Situation 3

起動オプションに以下が含まれている場合は、削除し Bitbucket Server の再起動をします。

-Dsun.net.spi.nameservice.provider.1=dns,sun

リックソフト株式会社 は、日本でトップレベルのAtlassian Platinum Solution Partnerです。
大規模ユーザーへの対応実績が認められたEnterpriseの認定をうけ、高度なトレーニング要件をクリアし、小規模から大規模のお客様まで対応可能な実績を示したパートナー企業です。


Copyright © Ricksoft Co., Ltd. プライバシーポリシー お問い合わせ