Javaが動作せず、Instana Agentのログが出力されない場合の対処法
はじめに
AIX環境において、Javaが動作せず、Instana Agentのログが出力されない現象が発生しました。本記事では、この現象の概要、原因の分析、具体的な解決手段について説明します。
現象
Javaを実行しようとした際、以下のエラーメッセージが表示され、Javaが起動しない。
[XXX:root /usr2/instana/instana-agent/jvm/bin] ./java -version
failed to open </usr2/instana/instana-agent/jvm/lib/default/libjvm.so>
- reason:
0509-022 モジュール /usr2/instana/instana-agent/jvm/lib/default/libjvm.so をロードできません。
0509-150 従属モジュール libc++.a(shr_64.o) をロードできませんでした。
0509-022 モジュール libc++.a(shr_64.o) をロードできません。
0509-026 システム・エラー: このパス名のファイルまたはディレクトリーは存在しません。
> Failed to find VM - aborting
また、[Agent_Installation]/bin/status や java -version コマンドでも同様のエラーが発生しました。
原因分析
この問題の主な原因は、Javaランタイムが依存する libc++.a (XL C++ ランタイムライブラリ) がシステム上に存在しない、または正しくインストールされていないことにあります。
具体的には、libjvm.so が必要とする依存ライブラリである libc++.a(shr_64.o) をロードできないため、Javaの起動が失敗しています。
類似の既知の問題
この問題は以下の既知の問題とも関連があります。
解決手段
以下の手順で問題を解決できます。
1. libc++.aの存在確認
以下のコマンドで libc++.a が存在するか確認します。
find /usr -name libc++.a
ファイルが見つからない場合、次のステップに進みます。
2. XL C++ ランタイムの再インストールまたは更新
xlC.rte パッケージが正しくインストールされているか確認します。
手順
Step1. IBM公式サイトから適切なバージョンのXL C++ ランタイムをダウンロードします。
Step2. 以下のコマンドでインストールまたは再インストールを行います。
smitty installp
Step3. インストール後、以下のコマンドでパッケージが正しくインストールされたか確認します。
lslpp -l xlC\*
3. LIBPATH環境変数の設定
libc++.a が存在するディレクトリ (例: /usr/lib や /usr/lpp/xlC/lib) が LIBPATH に含まれているか確認します。
手順
- 現在の
LIBPATHを確認します。
echo $LIBPATH
- 含まれていない場合、以下のコマンドで追加します。
export LIBPATH=/usr/lib:/usr/lpp/xlC/lib:$LIBPATH
- この設定をシェルプロファイル (例:
~/.bash_profile) またはJava起動スクリプトに追加します。
4. 依存関係の確認
libjvm.so の依存関係を確認します。
dump -H /usr2/instana/instana-agent/jvm/lib/default/libjvm.so
リストされたライブラリがシステム上に存在するか確認し、欠けている場合はインストールします。
5. ファイルの権限確認
Javaを実行するユーザーが必要なファイルやディレクトリに適切な読み取り・実行権限を持っているか確認します。
ls -l /usr2/instana/instana-agent/jvm/lib/default/libjvm.so
ls -l /usr/lib/libc++.a
必要に応じて権限を修正します。
6. Javaの再インストール
IBM公式サイトからAIX用の正しいバージョンのJava 11をダウンロードし、再インストールします。
ダウンロード先
手順
Step1. 既存のJavaをアンインストールします。
Step2. ダウンロードしたJavaをインストールします。
7. システムの互換性確認
AIXのバージョン (例: 7200-05-07-2346) とJavaのバージョンが互換性があるか確認します。必要に応じて、適切なパッチやアップデートを適用します。
8. IBMサポートへの問い合わせ
上記の手順をすべて試しても問題が解決しない場合は、IBMのAIXサポートに連絡して詳細な支援を受けてください。