在WebSphere上安装Java探针

目录：

• 兼容性
• 在WebSphere上安装Java探针
• 安全性（Java 2 Security）配置

兼容性

基调听云Java探针支持WebSphere 7.0到8.5.5的所有版本，除了有部分8.5.0的版本与该探针不兼容。

在WebSphere上安装Java探针

1. 修改server.xml文件**(不推荐)**，文件路径大致为：WAS_HOME/AppServer/profiles/app_server_name/config/cells/cell_name/nodes/node_name/servers/server_name/server.xml

...
    <jvmEntries ... genericJvmArguments="-javaagent:/${路径}/tingyun/tingyun-agent-java.jar" ... >
    ...
    </jvmEntries>
...

2. 通过管理控制台配置探针**(推荐)**：

• 登录管理控制台:https://ip:9043/ibm/consol

• 浏览：Servers > Application servers > (选择指定的Server);

• 选择：Configuration > Service Infrastructure > Java and Process Management > Process Definition > Additional Properties;

• 在Process Definition > Additional Properties下，选择Java Virtual Machine;

• 在Java Virtual Machine页面中，在Generic JVM arguments选项的文本框中，增加以下内容：

   -javaagent:/${路径}/tingyun/tingyun-agent-java.jar
  

• 点击Apply按钮，然后点击Save按钮；

• 重启服务。

提示：如果启用了 Java安全性(Java 2 Security), 需要授权Tingyun Agent通过JMX获取PMI指标。

参考以下步骤：

安全性（Java 2 Security）配置

如果您使用的是Java 2 Security或WebSphere管理安全性, 需要授予tingyun目录下所有jar文件的执行权限。可以通过修改java.policy文件启用授予全局安全性，也可以修改某个Server的server.policy文件只授权单个Server的权限：

授权所有Server

1. 修改java.policy文件,文件路径大概为：

   WAS_HOME/java/jre/lib/security/java.policy
   

2. 将如下内容添加到java.policy中，file:后面的路径必须指定到tingyun-agent-java.jar的目录，并确保最后存在-。

   grant codeBase "file:/${路径}/tingyun/-" {
       permission java.security.AllPermission;
       permission java.net.SocketPermission "*.networkbench.com", "connect,accept,resolve";
       permission java.lang.RuntimePermission "createClassLoader";
       permission java.lang.RuntimePermission "getClassLoader";
   };
   

3. 重启应用WebSphere

授权单个Server

4. 修改server.policy文件,文件路径大概为：

   WAS_HOME/AppServer/profiles/APP_SERVER_NAME/properties/server.policy
   

5. 将如下内容添加到java.policy中，file:后面的路径必须指定到tingyun-agent-java.jar的目录，并确保最后存在-。

   grant codeBase "file:/${路径}/tingyun/-" {
       permission java.security.AllPermission;
       permission java.net.SocketPermission "*.networkbench.com", "connect,accept,resolve";
       permission java.lang.RuntimePermission "createClassLoader";
       permission java.lang.RuntimePermission "getClassLoader";
   };
   

6. 重启应用WebSphere

提示：每个Server最终的安全性都取决于java.policy和server.policy的并集，切勿在多个文件配置同样的授权。

policy文件的配置格式及语法可参考Default Policy Implementation and Policy File Syntax