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