Java Agentの適用方法

対象アプリケーションサーバへJava Agentを適用するためには、JVM起動引数にSheltyのJava Agent用の引数を追加し、対象のアプリケーションサーバの再起動を行ってください。

但し、アプリケーションサーバの種類やバージョン、開発環境によっては、SheltyのJava Agent用の引数に加えて、追加の引数指定が必要となります。

Java Agent適用にあたり実施した変更については、対象ファイル、変更内容についていつでも参照できるように記録を残してください。Java Agentの削除時、緊急停止を行いたい場合に必要となります。

【表　アプリケーションサーバ毎の追加引数の有無】

-javaagent:{JavaAgent のパス}/java/javaagent.jar=instance={SheltyでのInstance番号}

-javaagent:{JavaAgentのパス}/java/javaagent.jar=instance_key={Agent導入画面で指定したInstanceキー}

※「SheltyでのInstance番号」とは、Agent導入画面のJava(AP+RT)の行の「Instance」欄に表示されている数字です。

(例) Linux環境でデフォルトパスにAgent導入している場合

-javaagent:/opt/iim/shelty/java/javaagent.jar=instance=1

(例) Windows環境でE:\iimSheltyフォルダにAgent導入している場合

なお、JVM引数のサンプルはSheltyのAgent導入画面から確認することが可能です。

Agent導入画面で保存ボタンをクリックすると、Java(AP+RT)の行の備考に「適用手順を表示」のリンクが表示されます。「適用手順を表示」をクリックしてダウンロードされる手順書を参照してください。

【図　Agent導入(Java(AP+RT))】

【図　適用手順を表示(Java(AP+RT))】

同一スクリプトで複数のJVMを起動している場合、個々のInstanceキーを設定することができません。その場合は、下記のようにinstance_envに環境変数を設定することで個々のインスタンスに対応します。

事前に環境変数に格納されるインスタンス名を導入画面のInstanceキーで設定しておく必要があります。

現在サポートされている環境変数は下記の通りです。

【表　 instance_env で使用可能な環境変数】

！注意
Interstage、JBoss EAP、Websphereの場合は下記の追加設定を行ってください。

JVM引数の追加によりアプリケーションサーバの起動に問題が生じた場合は、以下を参照してください。

ES/1 Shelty Manual2.8.0