diff --git a/_sources/install-detail.md.txt b/_sources/install-detail.md.txt index 3984ed2f1..b88d43591 100644 --- a/_sources/install-detail.md.txt +++ b/_sources/install-detail.md.txt @@ -10,7 +10,7 @@ Arthas 支持在 Linux/Unix/Mac 等平台上一键安装,请复制以下内容 curl -L https://alibaba.github.io/arthas/install.sh | sh ``` -上述命令将会下载的启动脚本文件 `as.sh` 到当前目录,你可以放在任何地方或将其加入到 $PATH 中。 +上述命令将会下载的启动脚本文件 `as.sh` 到当前目录,你可以放在任何地方或将其加入到 `$PATH` 中。 直接在shell下面执行`./as.sh`,就会进入交互界面。 @@ -28,7 +28,7 @@ curl -L https://alibaba.github.io/arthas/install.sh | sh as.bat pid ``` -如果需要更好的体验,可以在本地使用 `as.bat pid` 启动 Arthas Server 后,然后在另外的 Linux/Mac 上使用 as.bat pid@ip:port 来远程诊断。 +如果需要更好的体验,可以在本地使用 `as.bat pid` 启动 Arthas Server 后,然后在另外的 Linux/Mac 上使用 `as.sh pid@ip:port` 来远程诊断。 > Windows用户如果在cmd里不能正常显示颜色,可以使用[conemu](https://sourceforge.net/projects/conemu)。 @@ -37,6 +37,42 @@ as.bat pid [手动安装](manual-install.md) +## 手动拼接命令行启动 + +如果启动遇到问题,可以尝试手动拼接出命令行参数来启动。 + +1. 查找目录jvm的java文件路径。 + + 在linux/mac上执行`ps aux | grep java`,在windows上可以通过进程管理器来查看。假设是`/opt/jdk1.8/bin/java`。 + +2. 拼接出命令行 + + ```bash + /opt/jdk1.8/bin/java -Xbootclasspath/a:/opt/jdk1.8/lib/tools.jar \ + -jar /tmp/arthas-packaging/arthas-core.jar \ + -pid 15146 \ + -target-ip 127.0.0.1 -telnet-port 3658 -http-port 8563 \ + -core /tmp/arthas-packaging/arthas-core.jar \ + -agent /tmp/arthas-packaging/arthas/arthas-agent.jar + ``` + 命令行分几部分组成: + + * `-Xbootclasspath` 增加tools.jar + * `-jar /tmp/arthas-packaging/arthas-core.jar` 指定main函数入口 + * `-pid 15146` 指定目标java进程ID + * `-target-ip 127.0.0.1` 指定IP + * `-telnet-port 3658 -http-port 8563` 指定telnet和http端口 + * `-core /tmp/arthas-packaging/arthas-core.jar -agent /tmp/arthas-packaging/arthas/arthas-agent.jar` 指定core/agent jar包 + + 如果是`jdk > 9`,即9/10/11以上的版本,不需要指定`tools.jar`,直接去掉`-Xbootclasspath` 的配置即可。 + + 启动目志输出在`~/logs/arthas/arthas.log`里。 +3. attach成功之后,使用telnet连接 + + ```bash + telnet localhost 3658 + ``` + ## 离线帮助文档 diff --git a/install-detail.html b/install-detail.html index 5f328abe8..70198d0c0 100644 --- a/install-detail.html +++ b/install-detail.html @@ -93,6 +93,7 @@
  • Linux/Unix/Mac
  • Windows
  • 手动安装
  • +
  • 手动拼接命令行启动
  • 离线帮助文档
  • 卸载
  • @@ -179,7 +180,7 @@
    curl -L https://alibaba.github.io/arthas/install.sh | sh
     
    -

    上述命令将会下载的启动脚本文件 as.sh 到当前目录,你可以放在任何地方或将其加入到 $PATH 中。

    +

    上述命令将会下载的启动脚本文件 as.sh 到当前目录,你可以放在任何地方或将其加入到 $PATH 中。

    直接在shell下面执行./as.sh,就会进入交互界面。

    也可以执行./as.sh -h来获取更多参数信息。

    @@ -190,7 +191,7 @@
    as.bat pid
     
    -

    如果需要更好的体验,可以在本地使用 as.bat pid 启动 Arthas Server 后,然后在另外的 Linux/Mac 上使用 as.bat pid@ip:port 来远程诊断。

    +

    如果需要更好的体验,可以在本地使用 as.bat pid 启动 Arthas Server 后,然后在另外的 Linux/Mac 上使用 as.sh pid@ip:port 来远程诊断。

    Windows用户如果在cmd里不能正常显示颜色,可以使用conemu
    @@ -199,12 +200,47 @@

    手动安装

    -

    离线帮助文档

    +

    手动拼接命令行启动

    +

    如果启动遇到问题,可以尝试手动拼接出命令行参数来启动。

    +
      +
    1. 查找目录jvm的java文件路径。

      +

      在linux/mac上执行ps aux | grep java,在windows上可以通过进程管理器来查看。假设是/opt/jdk1.8/bin/java

      +
    2. +
    3. 拼接出命令行

      +
      /opt/jdk1.8/bin/java -Xbootclasspath/a:/opt/jdk1.8/lib/tools.jar \
      + -jar /tmp/arthas-packaging/arthas-core.jar \
      + -pid 15146 \
      + -target-ip 127.0.0.1 -telnet-port 3658 -http-port 8563 \
      + -core /tmp/arthas-packaging/arthas-core.jar \
      + -agent /tmp/arthas-packaging/arthas/arthas-agent.jar
      +
      +
      +

      命令行分几部分组成:

      +
        +
      • -Xbootclasspath 增加tools.jar
      • +
      • -jar /tmp/arthas-packaging/arthas-core.jar 指定main函数入口
      • +
      • -pid 15146 指定目标java进程ID
      • +
      • -target-ip 127.0.0.1 指定IP
      • +
      • -telnet-port 3658 -http-port 8563 指定telnet和http端口
      • +
      • -core /tmp/arthas-packaging/arthas-core.jar -agent /tmp/arthas-packaging/arthas/arthas-agent.jar 指定core/agent jar包
      • +
      +

      如果是jdk > 9,即9/10/11以上的版本,不需要指定tools.jar,直接去掉-Xbootclasspath 的配置即可。

      +

      启动目志输出在~/logs/arthas/arthas.log里。

      +
    4. +
    5. attach成功之后,使用telnet连接

      +
      telnet localhost 3658
      +
      +
      +
    6. +
    +
    +
    +

    离线帮助文档

    最新版本:Arthas

    Download栏下载最新的 doc.zip 包,

    -

    卸载

    +

    卸载