首页 帮助中心 基调听云Server WebSphere
基调听云Server

在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:/${路径}/tingyun/tingyun-agent-java.jar" ... >
    ...
    </jvmEntries>
...
  1. 通过管理控制台配置探针**(推荐)**:
  • 登录管理控制台: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

  1. 修改server.policy文件,文件路径大概为:

    WAS_HOME/AppServer/profiles/APP_SERVER_NAME/properties/server.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最终的安全性都取决于java.policyserver.policy的并集,切勿在多个文件配置同样的授权。

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