IBM WebSphereとInfoSphereスタートアップ設定

Java Agentでは、-javaagent 引数コマンドラインオプションを WebSphere に渡すことで、アプリケーションサーバエージェントがアプリをモニタリングする適切な権限を持っていることが確認されます。

セキュリティ要件および構成

WebSphereでエージェントが正しく機能するにはすべての権限が必要となります。サーバーレベルおよびプロフィールレベルの両方にすべての権限を付与します。

セキュリティが設定されたWebSphereを実行

J2EE セキュリティまたはグローバルセキュリティが有効であるときに WebSphere を実行する場合は、WebSphere の server.policy ファイルを変更し、WebSphere と Java エージェント間の相互作用の問題を防ぐ必要があります。

codeBase 値は、ソースコードの場所を示します。その場所から、コードに権限を付与する必要があります。codeBase は URL 値であり、末尾の文字によって異なります。末尾が " "/-"" の codeBase は、ディレクトリ内のすべてのファイル（クラスファイルと JAR ファイルの両方）と一致します。また、ディレクトリに含まれるサブディレクトリ内のすべてのファイルと再帰的に一致します。

<websphere_home>/properties または <websphere_profile_home>/properties に配置されている server.policy ファイルに移動します。

次のブロックを WebSphere server.policy ファイルに追加します。

Syntax

grant codeBase "file:</full/path/to/agent_install_directory>/-" { permission java.security.AllPermission; };

JAVA

Example

grant codeBase "file:/opt/appdynamics/javagent/agent4.5.1.23676/-" { permission java.security.AllPermission; };

JAVA

ファイルを保存します。

パフォーマンスモニタリングの統計

JMX 機能を動作させるには、[Application servers > <server_name> > Performance Monitoring Infrastructure (PMI)] で [Currently monitored statistic set] を [None ] 以外のオプションに設定します。

WebSphere 7.x、8.x、9.x、InfoSphere 8.xのインストゥルメント化

アプリケーションサーバーエージェントをインストールするWebSphereノード用管理コンソールにログインする。
管理コンソールで、[Servers > Server Types >] [WebSphere application servers] を選択する。
サーバー名を選択する。
[Server Infrastructure] セクションで、[Java and Process Management] > [Process Definition] を選択します。
[Additional Properties] セクションで、[Java Virtual Machine] を選択します。
[Generic JVM] 引数フィールドに、AppDynamics javaagent.jar ファイルへのフルパスを含む javaagent オプションを入力します。

Windowsの場合：
```
-javaagent:<Drive Letter>:<agent install location>\javaagent.jar
```
CODE
Linuxの場合：
```
-javaagent:<agent install location>/javaagent.jar
```
CODE
[OK] をクリックする。

WebSphere は Equinox を OSGi コンテナとして使用します。Java エージェントパッケージを次のように OSGi bootdelegation システムプロパティに追加しなければならない場合もあります。

-Dorg.osgi.framework.bootdelegation=META-INF.services,com.singularity.*,com.ibm.*

CODE

WebSphere 6.xのインストゥルメント化

JavaエージェントをインストールするWebSphereノード用管理コンソールにログインする。
左側のナビゲーションツリーで、[Servers > Application servers] を選択する。
サーバ一覧からサーバ名をクリックする。
[Configuration] タブで、[Java and Process Management] を選択する。
[Generic JVM] 引数フィールドに、Java エージェント javaagent.jar ファイルへのフルパスを含む javaagent オプションを入力します。
Windowsの場合：
```
-javaagent:<Drive Letter>:<agent install location>\javaagent.jar
```
CODE
Linuxの場合：
```
-javaagent:<agent install location>/javaagent.jar
```
CODE
たとえば、
[OK] をクリックする。

WebSphere 5.xのインストゥルメント化

アプリケーションサーバーエージェントをインストールするWebSphereノード用管理コンソールにログインする。
管理コンソールで、[Servers] を選択する。
[Application Servers] をクリックする。
サーバー名をクリックする。
[Additional Properties] で、[Process Definition] をクリックします。
次のページの [Additional Properties] の下で、[Java Virtual Machine] をクリックします。
[Generic JVM] 引数フィールドに、Java エージェント javaagent.jar ファイルへのフルパスを含む javaagent オプションを入力します。

Windowsの場合：
```
-javaagent:<Drive Letter>:<agent install location>\javaagent.jar
```
CODE
Linuxの場合：
```
-javaagent:<agent install location>/javaagent.jar
```
CODE
[OK] をクリックする。

Javaエージェントの構成を確認

Java エージェントをインストールした WebSphere ノードの server.xml ファイルをチェックして、構成設定を確認します。server.xml ファイルには以下のエントリが必要です。

<jvmEntries ... genericJvmArguments='-javaagent:E:\test1\AppServerAgent\javaagent.jar' disableJIT="false"/>

CODE