<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="arthas-install"></span><h1>Arthas Install<aclass="headerlink"href="#arthas-install"title="Permalink to this headline">¶</a></h1>
<divclass="section"id="linux-unix-mac">
<spanid="linux-unix-mac"></span><h2>Linux/Unix/Mac<aclass="headerlink"href="#linux-unix-mac"title="Permalink to this headline">¶</a></h2>
<p>You can install Arthas in one single line as:</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 line above will download the booting script <codeclass="docutils literal notranslate"><spanclass="pre">as.sh</span></code> to the current directory and you can then start Arthas by <codeclass="docutils literal notranslate"><spanclass="pre">./as.sh</span></code>, for more help info you can use <codeclass="docutils literal notranslate"><spanclass="pre">./as.sh</span><spanclass="pre">-h</span></code> to check the details.</p>
<p>By the way, you can also add the absolute path of the script <codeclass="docutils literal notranslate"><spanclass="pre">as.sh</span></code> to <codeclass="docutils literal notranslate"><spanclass="pre">$PATH</span></code> to make it available globally.</p>
</div>
<divclass="section"id="windows">
<spanid="windows"></span><h2>Windows<aclass="headerlink"href="#windows"title="Permalink to this headline">¶</a></h2>
<p>Download the latest <codeclass="docutils literal notranslate"><spanclass="pre">bin.zip</span></code>, unzip the package and you can find the <codeclass="docutils literal notranslate"><spanclass="pre">as.bat</span></code>. 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>
<p>If you are asking for better UX, you can start the Arthas Server locally by <codeclass="docutils literal notranslate"><spanclass="pre">as.bat</span><spanclass="pre"><pid></span></code> and then use <codeclass="docutils literal notranslate"><spanclass="pre">./as.sh</span><spanclass="pre"><pid>@<ip>:<por></span></code>in another Linux/Unix/Mac machine.</p>
<p>Another tip:</p>
<p>If in Windows, the color is not working as expect. You can try <aclass="reference external"href="https://sourceforge.net/projects/conemu">conemu</a> to get it to work.</p>
</div>
<divclass="section"id="manual-installation">
<spanid="manual-installation"></span><h2>Manual Installation<aclass="headerlink"href="#manual-installation"title="Permalink to this headline">¶</a></h2>
<spanid="advanced-manual-boot"></span><h2>Advanced Manual Boot<aclass="headerlink"href="#advanced-manual-boot"title="Permalink to this headline">¶</a></h2>
<p>If you cannot boot Arthas, try to pass in all the critical options manually as the following steps:</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> specify main entry</li>
<li><codeclass="docutils literal notranslate"><spanclass="pre">-pid</span><spanclass="pre">15146</span></code> specify the target java process pid</li>
<li><codeclass="docutils literal notranslate"><spanclass="pre">-target-ip</span><spanclass="pre">127.0.0.1</span></code> specify 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> specify telnet and http ports</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> specify core/agent jar package</li>
<p>But if you are using JDK 1.9 or above，then you do not need 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>F.Y.I the booting log will be printed to <codeclass="docutils literal notranslate"><spanclass="pre">~/logs/arthas/arthas.log</span></code>.</p>
<spanid="offline-help-documentation"></span><h2>Offline Help Documentation<aclass="headerlink"href="#offline-help-documentation"title="Permalink to this headline">¶</a></h2>
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>.
