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

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

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

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

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

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

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

  2. 次のコードブロックを 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
  3. ファイルを保存します。

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

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

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

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

    Windowsの場合：

    -javaagent:<Drive Letter>:<agent install location>\javaagent.jar
    CODE

    Linuxの場合：

    -javaagent:<agent install location>/javaagent.jar
    CODE
  7. [OK] をクリックする。

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

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

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

  1. JavaエージェントをインストールするWebSphereノード用管理コンソールにログインする。

  2. 左側のナビゲーションツリーで、[Servers > Application servers] を選択する。
  3. サーバ一覧からサーバ名をクリックする。 
    Servers List
  4. [Configuration] タブで、[Java and Process Management] を選択します。
    Java and Process Management
  5. [Generic JVM] 引数フィールドに、Java エージェント javaagent.jar ファイルへのフルパスを含む javaagent オプションを入力します。

    Windowsの場合：

    -javaagent:<Drive Letter>:<agent install location>\javaagent.jar
    CODE

    Linuxの場合：

    -javaagent:<agent install location>/javaagent.jar
    CODE


    たとえば、
    Generic JVM Arguments

  6. [OK] をクリックする。 

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

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

    Windowsの場合：

    -javaagent:<Drive Letter>:<agent install location>\javaagent.jar
    CODE

    Linuxの場合：

    -javaagent:<agent install location>/javaagent.jar
    CODE
  8. [OK] をクリックする。

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

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

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