手动安装

本章描述了如何使用-javaagent参数将听云Server Java探针安装到应用的JVM中，以达到监控应用性能的目的。

在安装探针之前，请确认安装环境是否满足：

• 确认已经完成注册，并获取到合法的License。
• 下载探针并解压，确保探针所在目录具有读写权限。
• 备份tingyun目录下tingyun.properties文件，便于修复文件。
• 修改配置文件tingyun.properties中的nbs.license_key和nbs.app_name，详情参见修改配置。
• 确认应用环境在Java探针的支持范围内，详情参见支持列表。

什么是javaagent？以JDK1.7为例参见Oracle Help Center。

快速安装

在安装环境满足要求以后，就可以将探针安装到JVM中。一般的安装方法是将-javaagent配置到JVM的启动参数中：

• Linux or Mac，在-javaagent参数中指出tingyun-agent-java.jar文件的位置。

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

• 在Windows环境下，tingyun-agent-java.jar文件的位置需要包含磁盘分区号，例如：C:/ D:/ E:/等。

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

注：所有配置-javaagent的地方请使用完整路径。

安装完成后，需要重新启动应用服务器。

不同Application Server安装

如果在安装探针或修改JVM启动参数时无法重新启动JVM，则可以根据应用环境选择与之匹配的安装说明进行安装。有关框架和应用程序类型的信息，请参阅以下内容：

• ColdFusion
• Geronimo
• Glassfish
• Grails
• JBoss
• Jetty
• Play 1.x
• Play 2.x
• Resin
• Solr
• Tomcat
• WebLogic
• WebSphere
• WildFly

更多应用服务器支持详情，请参阅支持列表。