安装前须知
为保证Java Agent安装后能够支持自动升级与版本回退，安装过程中请满足以下条件：
n 当您有多个Java应用，请确保各个应用的Java Agent安装目录严格分离，避免多个应用公用同一个Java Agent安装目录的情况。
n Java Agent安装目录中，建议使用应用名称作为唯一标识，如JavaAgent_应用名，不建议使用版本号作为后缀。
n 确保启动应用服务的用户持有对Java Agent安装目录及父目录的读写权限。
n 应用重启之后，Java Agent才可生效，并在透视宝平台的采集组件列表中生成一条记录。
安装Java Agent
若需要监控Java应用和Java虚拟机，在透视宝平台的顶部导航栏单击
，进入Server服务页面中选择Java语言，参考以下步骤下载并安装Java Agent。
获取授权编号
授权编号是透视宝用户身份识别的License Key，每个用户对应一个唯一的授权编号，在后续配置中需要使用。
下载Java Agent
单击下载Java Agent（版本）或复制Wget链接，下载最新版本的Java Agent安装包。
Java Agent支持Linux、Windows、Aix操作系统，支持JDK1.6及以上版本。
在Linux&Aix系统下安装Java Agent
1. 创建cloudwise文件夹（如/var/cloudwise）并确保拥有读写权限，例如：
mkdir -p /var/cloudwise
2. 解压缩安装包到cloudwise目录，例如：
unzip JavaAgent_2.3.8.zip -d /var/cloudwise
3. 在Java Agent的conf目录（如JavaAgent_2.3.8/conf）下的agent.properties文件中，配置License Key，例如：
LicenseKey=J45Engw88Nc/fR1k7e53nrZc**iqtDYEDmZ6rDu3xxXS7sIIBIhBerA!!!!
4. 在Java Agent的conf目录（如JavaAgent_2.3.8/conf）下的agent.properties文件中，配置数据发送地址，例如：
ConfigDomain=http://data.toushibao.com #实际按具体数据发送地址配置 SendDomain=http://data.toushibao.com
5. 配置Web容器。
安装Java Agent后，您需要根据应用的服务器配置对应的Web容器，详细说明请参考“4.1.5配置Web容器”。
注意：配置完成后，请重启对应的Web容器。
6. 启动Java Agent。
按照上述步骤配置完成后，启动应用即可成功启动Java Agent。
7. 监控Java虚拟机。
启动Java Agent后，可以在透视宝的Server>JVM页面查看JVM运行状态。
要深入监控JVM，请参考《4.1.3配置Java Agent》配置相关参数。
8. 在Docker中安装Java Agent。
在Docker中安装Java Agent，请参考《0在Docker中安装Java Agent》按流程安装。
安装配置完成后，大致两分钟后您就可以在透视宝平台的Server模块中查看数据。
注意：从来没人访问过的应用不会出现在应用清单中。
在Windows系统下安装Java Agent
1. 创建cloudwise文件夹（如/var/cloudwise）并确保拥有读写权限。
2. 解压缩安装包到cloudwise目录。
3. 在Java Agent的conf目录（如JavaAgent_2.3.8/conf）下的agent.properties文件中，配置License Key，例如：
LicenseKey=J45Engw88Nc/fR1k7e53nrZc**iqtDYEDmZ6rDu3xxXS7sIIBIhBerA!!!!
4. 在Java Agent的conf目录（如JavaAgent_2.3.8/conf）下的agent.properties文件中，配置数据发送地址，例如：
ConfigDomain=http://data.toushibao.com #实际按具体数据发送地址配置 SendDomain=http://data.toushibao.com
5. 根据应用的服务器配置对应的Web容器，详细说明请参考“4.1.5配置Web容器”。
6. 启动Java Agent。
按照上述步骤配置完成后，启动应用即可成功启动Java Agent。
7. 监控Java虚拟机。
安装JavaAgent并配置Web容器后，可以在透视宝平台的Server>JVM页面查看JVM运行状态。
要深入监控JVM，请参考《4.1.3配置Java Agent》配置相关参数。
安装配置完成后，大致两分钟后您就可以在Server模块中查看数据。
注意：从来没人访问过的应用不会出现在应用清单中。
在Docker中安装Java Agent
要监控Docker中的Java应用，需要安装Java Agent，请按照下述步骤进行安装。
版本说明：本安装说明仅针对JavaAgent_2.3.8版本，使用老版本探针请及时升级，或沿用以往部署安装方式。
注意：该安装方法仅适用于使用Dockerfile构建镜像的场景，同时请确保Docker镜像中安装有curl命令。
以tomcat镜像为例，安装流程如下:
1. 修改脚本文件。
启动tomcat镜像为容器，将容器中的/usr/local/tomcat/bin/catalina.sh文件拷贝到宿主机/data/cloudwise目录下，并对catalina.sh文件进行如下修改:
在 #----- Execute The Requested Command上面添加如下内容：
if [ "$1" = "start" -o "$1" = "run" ]; then export JAVA_OPTS="$JAVA_OPTS -javaagent:/data/cloudwise/JavaAgent_2.3.8/lib/agent.jar" fi
2. 创建Dockerfile文件。
在透视宝平台的
>Server服务页面中选择Java语言，下载并解压缩Java Agent到宿主机的/data/cloudwise/目录下。在/data/cloudwise/目录下创建Dockerfile文件，内容如下：
FROM tomcat:7-jre8 ADD ./JavaAgent_2.3.8/ /data/cloudwise/JavaAgent_2.3.8 ADD ./catalina.sh /usr/local/tomcat/bin/catalina.sh
3. 创建镜像并启动容器
通过如下命令构建镜像：
docker build -t <new_image> .
通过如下命令将新生成的镜像启动为容器：
docker run -dit -p 8080:8080 --name test_java_agent <new_image>
注意：Java Agent配置文件中的ConfigDomain和SendDomain默认是data.toushibao.com。在私有环境中，如果不方便修改Host文件，需要调整为ip:port的形式。