0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Ubuntu 24.04.5 → 26.04.1 アップグレード後に Redmine が起動しない問題を mysql2 の再ビルドで解決

0
Posted at

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 を復旧できました。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?