首页 帮助中心 听云Server 在WebSphere上安装Java探针
听云Server

在WebSphere上安装Java探针

在WebSphere上安装Java探针

目录:

兼容性

听云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:/path/to/tingyun/tingyun-agent-java.jar" ... >
	...
	</jvmEntries>
...

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

  • 1、登录管理控制台:https://ip:9043/ibm/consol
  • 2、浏览:**Servers > Application servers > (选择指定的Server)**;
  • 3、选择:**Configuration > Service Infrastructure > Java and Process Management > Process Definition > Additional Properties**;
  • 4、在**Process Definition > Additional Properties**下,选择**Java Virtual Machine**;
  • 5、在**Java Virtual Machine**页面中,在**Generic JVM arguments**选项的文本框中,增加以下内容:
     -javaagent:/path/to/tingyun/tingyun-agent-java.jar
  • 6、点击**Apply**按钮,然后点击**Save**按钮;

  • 7、重启服务。
  • 提示:如果启用了 Java安全性(Java 2 Security), 需要授权Tingyun Agent通过JMX获取PMI指标。

  • 参考以下步骤:



安全性(Java 2 Security)配置

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

授权所有Server
  • 修改**java.policy**文件,文件路径大概为:

    WAS_HOME/java/jre/lib/security/java.policy
  • 将如下内容添加到java.policy中,file:后面的路径必须指定到tingyun-agent-java.jar的目录,并确保最后存在-

    grant codeBase "file:/path/to/tingyun/-" {
    	permission java.security.AllPermission;
    	permission java.net.SocketPermission "*.networkbench.com", "connect,accept,resolve";
    	permission java.lang.RuntimePermission "createClassLoader";
    	permission java.lang.RuntimePermission "getClassLoader";
    };
  • 重启应用WebSphere

授权单个Server
  • 修改**server.policy**文件,文件路径大概为:

    WAS_HOME/AppServer/profiles/APP_SERVER_NAME/properties/server.policy
  • 将如下内容添加到java.policy中,file:后面的路径必须指定到tingyun-agent-java.jar的目录,并确保最后存在-

    grant codeBase "file:/path/to/tingyun/-" {
    	permission java.security.AllPermission;
    	permission java.net.SocketPermission "*.networkbench.com", "connect,accept,resolve";
    	permission java.lang.RuntimePermission "createClassLoader";
    	permission java.lang.RuntimePermission "getClassLoader";
    };
  • 重启应用WebSphere

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

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