OutOfMemoryError により Backlog エンタープライズ が表示できなくなりました

Backlog エンタープライズ プロフェッショナル 1.9.0 以降でしたら 以下の手順で対処できる可能性があります。

まずは Tomcat のログファイルに以下のようなエラーメッセージが出力されているかご確認ください。

Tomcat のログファイルパス : /opt/backlog/tomcat/logs/catalina.out

エラーメッセージ :

java.lang.OutOfMemoryError: Metaspace

上記のエラーが出力されている場合は以下の設定ファイルでメタスペースの値を上げてください。

設定ファイルパス : /opt/backlog/scripts/env

修正箇所 : -XX:MetaspaceSize と -XX:MaxMetaspaceSize の値を上げてください。

BACKLOG_CATALINA_OPTS="-Djava.awt.headless=true -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true -Dsolr.solr.home=/opt/backlog/data/solr -Xms512m -Xmx512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=128m"

また、1.9.0 をご利用のお客様は -XX:MetaspaceSize 、-XX:MaxMetaspaceSize の指定方法に誤りがある可能性があります。申し訳ございませんが以下のように変更をお願いいたします。

  • -XX:PermSize → -XX:MetaspaceSize
  • -XX:MaxPermSize → -XX:MaxMetaspaceSize

設定ファイルを修正した後は backlog-app の再起動が必要です。

service backlog-app stop

ps aux | grep tomcat

ps コマンドで停止を確認できない場合は kill コマンドで停止させてください。

service backlog-app start

-XX:MetaspaceSize および -XX:MaxMetaspaceSize の適切な値は、お客様の環境に左右されます。サーバー監視ツールの導入などで、必要なメモリ容量を調整してください。