Qiita Teams that are logged in
You are not logged in to any team

Log in to Qiita Team
Community
OrganizationAdvent CalendarQiitadon (β)
Service
Qiita JobsQiita ZineQiita Blog
2
Help us understand the problem. What is going on with this article?
@groonga

mroongaで「Can't open shared library」エラーが発生した場合の対処方法について

More than 5 years have passed since last update.

もっとgroongaを知ってもらおう!ということで週刊groongaをはじめました。毎週木曜にgroongaやmroonga、rroongaのトピックを投稿予定です。

gihyo.jpさんでgroongaの隔週更新連載が始まっています。第10回の記事も公開されたので、一読をおすすめします。

第1回から第9回までの過去記事については、隔週連載groongaのページを参照してください。

はじめに

MySQLで高速に全文検索するためのオープンソースのストレージエンジンとしてmroonga (むるんが)を公開しています。
最新のバージョンは2013年8月29日にリリースした3.07です。

今回は、mroongaをアップグレードするときに、シンボルが未解決なため「Can't open shared library」エラーが発生してしまったときの対処方法を紹介します。

問題の内容

mroonga 3.07にアップグレードするときに、mroongaが意図せずアンインストールされるという不具合があり、暫定的な対処については、mroongaのリリースアナウンスでも紹介されています。

それとは別に、アップグレード中に以下のようなエラーメッセージが表示されることがあります。

ERROR 1126 (HY000) at line 1: Can't open shared library '/usr/lib64/mysql/plugin/ha_mroonga.so' (errno: 2 undefined symbol: grn_expr_syntax_escape_query)

mroongaはgroongaをストレージエンジンとして使っているので、groongaで新規APIが追加されることがあります。
grn_expr_syntax_escape_query はまさに、groonga 3.0.7で新規に追加されたAPIです。
mroonga 3.07にアップグレードするときに、groonga 3.0.7も一緒にアップグレードされるはずなのにどうしてこうなるのでしょうか。

まずは、エラーが発生したときのプロセスが使用中のファイルを確認してみることにしましょう。mroongaをアップグレードするときには、プラグインをアンインストールしてから、再度インストールするという手順を踏んでいます。lsofでmroongaが使用中になっているかを確認します。

$ sudo lsof -c mysql|grep mroonga
$ 

MySQLがプラグインのファイルであるha_mroonga.soを使用中というわけではなさそうです。では、mroongaが使用しているgroongaも確認してみましょう。

$ sudo lsof -c mysql|grep groonga
mysqld    13602 mysql  DEL    REG              253,0          2890926 /usr/lib64/libgroonga.so.0.0.0

lsofのTYPEがDELとなっていました。 man lsofでドキュメントを確認してみるとマップファイルは削除されたけれども、という状態であることがわかりました。

or DEL for a Linux map file that has been deleted;

groongaのパッケージ自体は更新されているので、新しいlibgroonga.so.0.0.0が参照されるようにすれば良さそうです。

問題への対処方法

古いgroongaの共有ライブラリが参照されたままになっていることが問題であることがわかりました。そのため、この場合の対処としては、MySQLを再起動してからプラグインの再登録を行うのが良さそうです。

$ sudo service mysqld restart
Stopping mysqld:                                           [  OK  ]
Starting mysqld:                                           [  OK  ]

その後、mroongaを再度登録します。

$ mysql -u root -p -e "
    USE mysql;
    DROP FUNCTION IF EXISTS mroonga_snippet;
    DROP FUNCTION IF EXISTS last_insert_grn_id;
    DROP FUNCTION IF EXISTS mroonga_command;
    DROP FUNCTION IF EXISTS mroonga_escape;
    UNINSTALL PLUGIN mroonga;
    FLUSH TABLES;
    DELETE IGNORE FROM mysql.plugin WHERE name = 'mroonga';
    INSTALL PLUGIN mroonga SONAME 'ha_mroonga.so';
    CREATE FUNCTION last_insert_grn_id RETURNS INTEGER SONAME 'ha_mroonga.so';
    CREATE FUNCTION mroonga_snippet RETURNS STRING SONAME 'ha_mroonga.so';
    CREATE FUNCTION mroonga_command RETURNS STRING SONAME 'ha_mroonga.so';
    CREATE FUNCTION mroonga_escape RETURNS STRING SONAME 'ha_mroonga.so';
    "

再度、 lsofで確認してみましょう。

$ sudo lsof -c mysql|grep mroonga
mysqld    2010 mysql  mem    REG              253,0   273160 2892514 /usr/lib64/mysql/plugin/ha_mroonga.so.0.0.0
$ sudo lsof -c mysql|grep groonga
mysqld    2010 mysql  mem    REG              253,0  2228768 2890548 /usr/lib64/libgroonga.so.0.0.0
mysqld    2010 mysql   10w   REG              253,0      468 1181820 /var/lib/mysql/groonga.log

TYPEがmemになっているので、共有ライブラリが再度読み込まれていることがわかります。
groonga 3.0.7で新規に追加されたAPIをmroonga_escapeが使っているので、以下のように動作確認を行うことができます。

mysql> select mroonga_escape("(仮)*", "()");
+--------------------------------+
| mroonga_escape("(仮)*", "()") |
+--------------------------------+
| \(仮\)*                       |
+--------------------------------+
1 row in set (0.00 sec)

きちんと結果を取得できていることがわかります。

まとめ

今回は、mroongaをアップグレードするときに、シンボルが未解決なため「Can't open shared library」エラーが発生してしまったときの対処方法を紹介しました。

mroongaの基本的な動作を知るためのユーザガイドもあります。インストールしたら試してみてください。

2
Help us understand the problem. What is going on with this article?
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
groonga
Groonga関連情報を提供します。Groongaだけでなく、RroongaやMroongaなどの情報も提供します。

Comments

No comments
Sign up for free and join this conversation.
Sign Up
If you already have a Qiita account Login
2
Help us understand the problem. What is going on with this article?