【劔"Tsurugi" Tips集】WebアプリケーションがIPC接続を使う場合は、アプリケーションサーバーの静的ライブラリにTsubakuroを登録する【運⽤Tips】
*****
こちらの記事は、
Tsurugi Advent Calendar 2024（https://adventar.org/calendars/10853）
に参加しています。
劔"Tsurugi"関連のエンジニアが12月25日までの期間、さまざまな記事を掲載していきます。
是非、こちらもご覧ください！
*****
今回から運用Tipsです。
Tsurugiとの通信を⾏うWebアプリケーションでIPC接続を⾏う場合、再デプロイすると不具合が発⽣することがあります。
IPC接続を⾏う場合、クライアントライブラリーであるTsubakuroはnative library（libtsubakuro.so）をロードしています。（Iceaxeも内部ではTsubakuroを使⽤しているので同じです）
Webアプリケーションのアーカイブ（warファイル）がTsubakuroを含んでいる場合、WebアプリケーションをアプリケーションサーバーにデプロイしてIPC接続を実⾏すると、Javaのクラスローダーがnative libraryをロードします。
この状態でWebアプリケーションを再デプロイすると、クラスローダーが新しくなり、再びnative libraryをロードしようとします。しかしクラスローダーはJavaVM内で既にロード済みのnative libraryを再度ロードすることが出来ないので、例外が発⽣します。
これを回避するには、Tsubakuro（Iceaxe）をWebアプリケーションに含めるのではなく、アプリケーションサーバーの静的ライブラリーに含めます。
以下のようにbuild.gradleを記述して gradlew copyStaticLibs を実⾏すると、IceaxeおよびTsubakuroとそれらが依存しているライブラリーのjarファイルが build/static_libs というディレクトリーに出⼒されます。
これらのjarファイルをアプリケーションサーバーの静的ライブラリーを置く場所にコピーしてください。
build.gradle
plugins {
id 'java'
id 'war'
}
dependencies {
providedCompile 'com.tsurugidb.iceaxe:iceaxe-core:1.6.0'
}
task copyStaticLibs(type: Copy) {
from configurations.providedCompile
into "${buildDir}/static_libs"
}実⾏例
$ ./gradlew copyStaticLibs
$ ls -1 build/static_libs/
iceaxe-core-1.6.0.jar
jackson-annotations-2.13.3.jar
jackson-core-2.13.3.jar
jackson-databind-2.13.3.jar
java-jwt-3.19.2.jar
jsr305-3.0.2.jar
protobuf-java-3.17.3.jar
slf4j-api-1.7.36.jar
tsubakuro-common-1.6.0.jar
tsubakuro-connector-1.6.0.jar
tsubakuro-explain-1.6.0.jar
tsubakuro-ipc-1.6.0.jar
tsubakuro-proto-1.6.0.jar
tsubakuro-session-1.6.0.jar
tsubakuro-stream-1.6.0.jarその他の劔"Tsurugi"を使う際に役立つTips集はコチラ！
次世代高速RDB劔"Tsurugi"は、オープンソースで公開中です。
ぜひダウンロードしてみて、触ってみてください。
ダウンロードはコチラから
https://www.tsurugidb.com/