<liclass="toctree-l1"><aclass="reference external"href="https://github.com/alibaba/arthas/issues?q=label%3Aquestion-answered">Questions and answers</a></li>
<liclass="toctree-l1"><aclass="reference external"href="https://github.com/alibaba/arthas">Fork me at GitHub</a></li>
<spanid="manually-install-arthas"></span><h1>Manually Install Arthas<aclass="headerlink"href="#manually-install-arthas"title="Permalink to this headline">¶</a></h1>
<p>If the download speed is slow, try to use <aclass="reference external"href="https://maven.aliyun.com/">Ali cloud mirror repository</a>, for example, to download version <codeclass="docutils literal notranslate"><spanclass="pre">3.x.x</span></code> (you can replace <codeclass="docutils literal notranslate"><spanclass="pre">3.x.x</span></code> in the example URL if you want to download other version), the download URL is: https://maven.aliyun.com/repository/public/com/taobao/arthas/arthas-packaging/3.x.x/arthas-packaging-3.x.x-bin.zip</p>
<spanid="startup-with-as-sh-as-bat"></span><h2>Startup with as.sh/as.bat<aclass="headerlink"href="#startup-with-as-sh-as-bat"title="Permalink to this headline">¶</a></h2>
<divclass="section"id="linux-unix-mac">
<spanid="linux-unix-mac"></span><h3>Linux/Unix/Mac<aclass="headerlink"href="#linux-unix-mac"title="Permalink to this headline">¶</a></h3>
<p>You can install Arthas with one single line command on Linux, Unix, and Mac. Pls. copy the following command and paste it into the command line, then press <em>Enter</em> to run:</p>
<divclass="highlight-bash notranslate"><divclass="highlight"><pre><span></span>curl -L https://alibaba.github.io/arthas/install.sh <spanclass="p">|</span> sh
</pre></div>
</div>
<p>The command above will download the bootstrap script <codeclass="docutils literal notranslate"><spanclass="pre">as.sh</span></code> to the current directory. You can move it the any other place you want, or put its location in <codeclass="docutils literal notranslate"><spanclass="pre">$PATH</span></code>.</p>
<p>You can enter its interactive interface by executing <codeclass="docutils literal notranslate"><spanclass="pre">as.sh</span></code>, or execute <codeclass="docutils literal notranslate"><spanclass="pre">as.sh</span><spanclass="pre">-h</span></code> for more help information.</p>
</div>
<divclass="section"id="windows">
<spanid="windows"></span><h3>Windows<aclass="headerlink"href="#windows"title="Permalink to this headline">¶</a></h3>
<p>Latest Version, Click To Download: <aclass="reference external"href="http://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=com.taobao.arthas&a=arthas-packaging&e=zip&c=bin&v=LATEST"><imgalt="Arthas"src="https://img.shields.io/maven-central/v/com.taobao.arthas/arthas-packaging.svg?style=flat-square"/></a></p>
<p>Download and unzip, then find <codeclass="docutils literal notranslate"><spanclass="pre">as.bat</span></code> from ‘bin’ directory. For now this script will only take one argument <codeclass="docutils literal notranslate"><spanclass="pre">pid</span></code>, which means you can only diagnose the local Java process. (Welcome any bat script expert to make it better :heart:)</p>
<spanid="manual-command-line-startup"></span><h2>Manual command line startup<aclass="headerlink"href="#manual-command-line-startup"title="Permalink to this headline">¶</a></h2>
<p>If you fail to boot Arthas with the provided batch file, you could try to assemble the bootstrap command in the following way.</p>
<ol>
<li><pclass="first">Locate java in the target JVM:</p>
<p>Let’s suppose we are using <codeclass="docutils literal notranslate"><spanclass="pre">/opt/jdk1.8/bin/java</span></code>, then the command should be:</p>
<li><codeclass="docutils literal notranslate"><spanclass="pre">-jar</span><spanclass="pre">/tmp/arthas-packaging/arthas-core.jar</span></code> specifies main entry</li>
<li><codeclass="docutils literal notranslate"><spanclass="pre">-pid</span><spanclass="pre">15146</span></code> specifies the target java process PID</li>
<li><codeclass="docutils literal notranslate"><spanclass="pre">-target-ip</span><spanclass="pre">127.0.0.1</span></code> specifies the IP</li>
<li><codeclass="docutils literal notranslate"><spanclass="pre">-telnet-port</span><spanclass="pre">3658</span><spanclass="pre">-http-port</span><spanclass="pre">8563</span></code> specifies telnet and HTTP ports for remote access</li>
<li><codeclass="docutils literal notranslate"><spanclass="pre">-core</span><spanclass="pre">/tmp/arthas-packaging/arthas-core.jar</span><spanclass="pre">-agent</span><spanclass="pre">/tmp/arthas-packaging/arthas/arthas-agent.jar</span></code> specifies core/agent jar package</li>
</ul>
<p>If you are running on JDK 1.9 or above，then it’s unncessary to add <codeclass="docutils literal notranslate"><spanclass="pre">tools.jar</span></code> in option <codeclass="docutils literal notranslate"><spanclass="pre">-Xbootclasspath</span></code>.</p>
<p>You can find the logs from <codeclass="docutils literal notranslate"><spanclass="pre">~/logs/arthas/arthas.log</span></code>.</p>
</li>
<li><pclass="first">Use telnet to connect once attaching to the target JVM (in step 2) succeeds</p>
Built with <ahref="http://sphinx-doc.org/">Sphinx</a> using a <ahref="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <ahref="https://readthedocs.org">Read the Docs</a>.
