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

エンタープライズのバージョンによって対応の違いがあります。( 2023年10月17日現在 )

backlog-webのログファイル(logs/backlog-web/backlog-web.XXXXXXXX.log)に次のようなエラーメッセージが出力されている場合、次の手順をお試しください。

java.lang.OutOfMemoryError: Metaspace

.envのメタスペースの値を変更する

このエラーが出力されている場合は、設定ファイル(.envファイル)でメタスペース(-XX:MaxMetaspaceSize)の値を上げてください。

BACKLOG_WEB_JAVA_OPTS='-Xmx2048M -Xms512m
    -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m'
      

backlog-webを再起動する

docker-compose up -d backlog-web

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

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"
      

backlog-appを再起動する

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

Red Hat Enterprise Linux 6 serverまたはCentOS 6の場合

service backlog-app stop
ps aux | grep tomcat
service backlog-app start

backlog-appのプロセスが終了できないことがあります。psコマンドでtomcatのプロセスが残ったままになっていないかを確認してください。

tomcatのプロセスが残ったままの場合はkillコマンドで停止してください。

Red Hat Enterprise Linux 7またはCentOS 7の場合

systemctl stop backlog.target
ps aux | grep tomcat
systemctl start backlog.target

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