update start-arthas.md and add en/start-arthas.md. #51

site/src/site/sphinx/en/start-arthas.md

@@ -0,0 +1,76 @@
+Start Arthas
+=====
+
+## Interactive Mode
+
+```bash
+./as.sh
+```
+
+```sh
+➜  bin git:(develop) ✗ ./as.sh
+Found existing java process, please choose one and hit RETURN.
+  [1]: 3088 org.jetbrains.idea.maven.server.RemoteMavenServer
+* [2]: 12872 org.apache.catalina.startup.Bootstrap
+  [3]: 2455
+Attaching to 12872...
+  ,---.  ,------. ,--------.,--.  ,--.  ,---.   ,---.
+ /  O  \ |  .--. ''--.  .--'|  '--'  | /  O  \ '   .-'
+|  .-.  ||  '--'.'   |  |   |  .--.  ||  .-.  |`.  `-.
+|  | |  ||  |\  \    |  |   |  |  |  ||  | |  |.-'    |
+`--' `--'`--' '--'   `--'   `--'  `--'`--' `--'`-----'
+$
+```
+
+## Non-Interactive Mode
+
+Startup script is as follows:
+
+```bash
+./as.sh <PID>[@IP:PORT]
+```
+
+
+
+### Parameter Description
+
+* PID: Target Java process ID(Make sure that the user executing the command has sufficient permissions to operate the target Java process.)
+
+* IP: The address that Arthas Server listens on, the default value is `127.0.0.1`. Arthas allows multiple users to access simultaneously without interfering with each other.
+
+* PORT: Arthas Server port，the default value is 3658
+
+### Sample
+
+* If you do not specify IP and PORT, the default is 127.0.0.1 and 3658
+
+	> ./as.sh 12345
+
+	Equivalent to:
+
+	> ./as.sh 12356@127.0.0.1:3658
+
+### Remote Diagnosis
+
+After starting Arthas Server, users can use `telnet` connect to the remote Arthas Server, for example：
+
+```bash
+telnet 192.168.1.119 3658
+```
+
+### sudo Support
+
+If you need to switch users, such as `admin`, you need to add the -H parameter.
+
+```bash
+sudo -u admin -H ./as.sh 12345
+```
+
+
+### Windows Support
+
+`as.bat` script only supports one parameter: pid
+
+```bash
+as.bat <pid>
+```

site/src/site/sphinx/start-arthas.md

@@ -1,9 +1,11 @@
 启动 Arthas
--
+=====
 
 ## 交互模式启动
 
-> ./as.sh
+```bash
+./as.sh
+```
 
 ```sh
 ➜  bin git:(develop) ✗ ./as.sh
@@ -24,14 +26,16 @@ $
 
 启动脚本如下：
 
-> ./as.sh \<PID\>[@IP:PORT]
+```bash
+./as.sh <PID>[@IP:PORT]
+```
 
 
 
 ### 参数说明
 
 * PID：目标 Java 进程 ID（请确保执行当前执行命令的用户必须有足够的权限操作对应的 Java 进程）
-* IP：目标服务器 IP 地址，当 Arthas Server 启动后，其他人可以通过指定 IP 的形式加载到对应目标机器的 Java 进程中，从而实现远程协助。Arthas 允许多个用户同时访问，并且各自的命令不会相互干扰执行
+* IP：Arthas Server 侦听的地址，默认值是 `127.00.1`。Arthas允许多个用户同时访问，并且各自的命令不会相互干扰执行
 * PORT：目标服务器 Arthas Server 的端口号，默认的端口号是 3658
 
 ### 示例
@@ -46,27 +50,25 @@ $
 
 ### 远程诊断
 
-服务器启动 Arthas Server 后，其他人可以使用 Arthas Console Client 远程连接上去进程诊断，请参考：
+服务器启动 Arthas Server 后，其他人可以使用 telnet 远程连接上去进程诊断，例如：
 
-> ./as.sh PID@RemoteIP:RemotePort
-	
-其中 PID 为远程服务器上的 Java 进程 ID，RemoteIP 为远程服务器的 IP 地址，RemotePort 为远程服务器上 Arthas Server 的端口，默认为 3658。
+```bash
+telnet 192.168.1.119 3658
+```
 
 ### sudo 支持
 
 成熟的线上管理环境一般都不会直接开放 JVM 部署用户权限给你，而是通过 sudo-list 来控制和监控用户的越权操作。由于 as.sh 脚本中会对当前用户的环境变量产生感知，所以需要加上 -H 参数
 
-	> sudo -u admin -H ./as.sh 12345
-
-### telnet 的支持
-
-Arthas 支持通过 telnet 来访问服务端，如果当你手头的机器没有安装 Arthas Console Client，你可以简单的通过 telnet 命令来进行访问。
+```bash
+sudo -u admin -H ./as.sh 12345
+```
 
-	> telnet 10.232.12.113 3658
-
-当然了，telnet 命令没有 `Tab` 自动补全，各种操作体验也不如 Arthas Client Console。
 
 ### Windows 环境支持
 
-* 目前 Arthas 提供了 `as.bat` 脚本，用于 Windows 环境下的诊断场景；此脚本暂时只接受一个参数 pid，即只能诊断本机上的 Java 进程；
-* 另外，`as.bat` 脚本在体验方面还有一些问题，如果需要更好的体验，可以在本地使用 `as.bat pid` 启动 Arthas Server 后，然后在另外的 Linux/Mac 上使用 as.bat pid@ip:port 来远程诊断；
+目前`as.bat`脚本只支持一个参数：pid
+
+```bash
+as.bat <pid>
+```