Ubuntu 24.04.5 → 26.04.1 アップグレード後の Redmine / mysql2 修復
Ubuntu 24.04.5 から 26.04.1 へアップグレードした後、Redmine が起動できなくなりました。
調査したところ、Redmine が使用している Ruby Gem mysql2 のネイティブ拡張 mysql2.so が、アップグレード前の MySQL クライアントライブラリを参照したままになっていました。
mysql2 のネイティブ拡張を再ビルドすることで修復できました。
環境
- Ubuntu 24.04.5 → 26.04.1
- Redmine 7.0.0
- Ruby 4.0.6
- Rails 8.1.3
- MySQL 8.0系 → 8.4系
mysql2-0.5.7- 旧ライブラリ:
libmysqlclient.so.21 - 新ライブラリ:
libmysqlclient.so.24
原因
Ubuntu 24.04.5 では、MySQL 8.0系のクライアントライブラリを使用していました。
Ubuntu 24.04.5
↓
MySQL 8.0系
↓
libmysqlclient.so.21
↓
mysql2.so
Ubuntu 26.04.1 へのアップグレード後は、MySQL クライアントライブラリが新しくなり、
Ubuntu 26.04.1
↓
MySQL 8.4系
↓
libmysqlclient.so.24
となりました。
しかし、Ruby Gem の mysql2 に含まれるネイティブ拡張 mysql2.so は、Ubuntu 24.04.5 の環境でビルドされたものが残っています。
そのため、
mysql2.so
↓
libmysqlclient.so.21
という古いライブラリを参照した状態になっていました。
つまり、
OS側
libmysqlclient.so.24
mysql2.so
libmysqlclient.so.21
という不整合が発生していたわけです。
修正方法
Redmine をインストールしているディレクトリへ移動します。
cd /var/lib/redmine
mysql2 のネイティブ拡張を再ビルドします。
bundle pristine mysql2
今回使用している mysql2 は 0.5.7 のままで、Gem のバージョンを変更する必要はありません。
bundle pristine mysql2 によって、インストール済みの mysql2-0.5.7 からネイティブ拡張が再構築され、現在の環境にインストールされている MySQL クライアントライブラリに合わせられます。
修正後の確認
再ビルド後、mysql2.so がどの libmysqlclient を参照しているか確認します。
ldd /var/lib/redmine/vendor/bundle/ruby/*/gems/mysql2-0.5.7/lib/mysql2/mysql2.so
今回の確認結果は、
libmysqlclient.so.24 => /usr/lib/x86_64-linux-gnu/libmysqlclient.so.24
となりました。
これにより、
mysql2.so
↓
libmysqlclient.so.24
↓
MySQL 8.4系
という、Ubuntu 26.04.1 の環境に合ったリンクになっていることを確認できました。
まとめ
Ubuntu のアップグレードによって MySQL クライアントライブラリが変更された場合、Ruby のネイティブ拡張が古い共有ライブラリを参照したままになることがあります。
今回のケースでは、
libmysqlclient.so.21
↓
libmysqlclient.so.24
への変更に対して、mysql2.so が古いライブラリを参照していました。
修正は以下の2ステップだけです。
cd /var/lib/redmine
bundle pristine mysql2
その後、
ldd /var/lib/redmine/vendor/bundle/ruby/*/gems/mysql2-0.5.7/lib/mysql2/mysql2.so
で、
libmysqlclient.so.24 => /usr/lib/x86_64-linux-gnu/libmysqlclient.so.24
となっていることを確認しました。
この対応によって、Ubuntu 24.04.5 → 26.04.1 のアップグレード後に起動できなくなっていた Redmine を復旧できました。