<!DOCTYPE html>
<!-- [if IE 8]><html class="no - js lt - ie9" lang="en" > <![endif] -->
<!-- [if gt IE 8]><! --> < html class = "no-js" lang = "en" > <!-- <![endif] -->
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< title > Manually Install Arthas — Arthas 3.0.5 documentation< / title >
< link rel = "shortcut icon" href = "_static/favicon.ico" / >
< link rel = "stylesheet" href = "_static/css/theme.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/pygments.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/overrides.css" type = "text/css" / >
< link rel = "index" title = "Index" href = "genindex.html" / >
< link rel = "search" title = "Search" href = "search.html" / >
< script src = "_static/center_page.js" > < / script >
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.13.1/styles/github.min.css" >
< script src = "_static/js/modernizr.min.js" > < / script >
< / head >
< body class = "wy-body-for-nav" >
< div class = "wy-grid-for-nav" >
< nav data-toggle = "wy-nav-shift" class = "wy-nav-side" >
< div class = "wy-side-scroll" >
< div class = "wy-side-nav-search" >
< a href = "index.html" class = "icon icon-home" > Arthas
< / a >
< div class = "version" >
3.0.5
< / div >
< div role = "search" >
< form id = "rtd-search-form" class = "wy-form" action = "search.html" method = "get" >
< input type = "text" name = "q" placeholder = "Search docs" / >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< / div >
< / div >
< div class = "wy-menu wy-menu-vertical" data-spy = "affix" role = "navigation" aria-label = "main navigation" >
< ul >
< li class = "toctree-l1" > < a class = "reference internal" href = "install-detail.html" > Installation< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "quick-start.html" > Quick start< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "advanced-use.html" > Advanced usage< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "commands.html" > Commands< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "docker.html" > Docker< / a > < / li >
< li class = "toctree-l1" > < a class = "reference external" href = "https://github.com/alibaba/arthas/issues?q=label%3Auser-case" > User cases< / a > < / li >
< li class = "toctree-l1" > < a class = "reference external" href = "https://github.com/alibaba/arthas/issues?q=label%3Aquestion-answered" > Questions and answers< / a > < / li >
< li class = "toctree-l1" > < a class = "reference external" href = "https://github.com/alibaba/arthas" > Fork me at GitHub< / a > < / li >
< li class = "toctree-l1" > < a class = "reference external" href = "https://github.com/alibaba/arthas/blob/master/CONTRIBUTING.md" > CONTRIBUTING< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "release-notes.html" > Release Notes< / a > < / li >
< / ul >
< / div >
< / div >
< / nav >
< section data-toggle = "wy-nav-shift" class = "wy-nav-content-wrap" >
< nav class = "wy-nav-top" aria-label = "top navigation" >
< i data-toggle = "wy-nav-top" class = "fa fa-bars" > < / i >
< a href = "index.html" > Arthas< / a >
< / nav >
< div class = "wy-nav-content" >
< div class = "rst-content" >
< div role = "navigation" aria-label = "breadcrumbs navigation" >
< ul class = "wy-breadcrumbs" >
< li > < a href = "index.html" > Docs< / a > » < / li >
< li > Manually Install Arthas< / li >
< li class = "wy-breadcrumbs-aside" >
< a href = "https://github.com/alibaba/arthas/blob/master/site/src/site/sphinx/en/manual-install.md" class = "fa fa-github" > Edit on GitHub< / a >
< / li >
< / ul >
< hr / >
< / div >
< div role = "main" class = "document" itemscope = "itemscope" itemtype = "http://schema.org/Article" >
< div itemprop = "articleBody" >
< div class = "section" id = "manually-install-arthas" >
< span id = "manually-install-arthas" > < / span > < h1 > Manually Install Arthas< a class = "headerlink" href = "#manually-install-arthas" title = "Permalink to this headline" > ¶< / a > < / h1 >
< div class = "section" id = "manually-install-arthas" >
< span id = "id1" > < / span > < h2 > Manually Install Arthas< a class = "headerlink" href = "#manually-install-arthas" title = "Permalink to this headline" > ¶< / a > < / h2 >
< ol >
< li > < p class = "first" > Download the latest version< / p >
< p > < strong > Latest version, Click To Download< / strong > : < a class = "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" > < img alt = "Arthas" src = "https://img.shields.io/maven-central/v/com.taobao.arthas/arthas-packaging.svg?style=flat-square" / > < / a > < / p >
< p > If the download speed is slow, try to use < a class = "reference external" href = "https://maven.aliyun.com/" > Ali cloud mirror repository< / a > , for example, to download version < tt class = "docutils literal" > 3.x.x< / tt > (you can replace < tt class = "docutils literal" > 3.x.x< / tt > 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 >
< / li >
< li > < p class = "first" > Unzip zip file< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > unzip arthas-packaging-bin.zip
< / pre > < / div >
< / div >
< / li >
< li > < p class = "first" > Install Arthas< / p >
< p > It is recommended to completely remove all old versions of Arthas before installation.< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > sudo su admin
rm -rf /home/admin/.arthas/lib/* # remove all the leftover of the old outdated Arthas
cd arthas
./install-local.sh # switch the user based on the owner of the target Java process.
< / pre > < / div >
< / div >
< / li >
< li > < p class = "first" > Start Arthas< / p >
< p > Make sure < tt class = "docutils literal" > shutdown< / tt > the old Arthas server before start.< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > ./as.sh
< / pre > < / div >
< / div >
< / li >
< / ol >
< / div >
< div class = "section" id = "startup-with-as-sh-as-bat" >
< span id = "startup-with-as-sh-as-bat" > < / span > < h2 > Startup with as.sh/as.bat< a class = "headerlink" href = "#startup-with-as-sh-as-bat" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "section" id = "linux-unix-mac" >
< span id = "linux-unix-mac" > < / span > < h3 > Linux/Unix/Mac< a class = "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 >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > curl -L https://alibaba.github.io/arthas/install.sh | sh
< / pre > < / div >
< / div >
< p > The command above will download the bootstrap script < tt class = "docutils literal" > as.sh< / tt > to the current directory. You can move it the any other place you want, or put its location in < tt class = "docutils literal" > $PATH< / tt > .< / p >
< p > You can enter its interactive interface by executing < tt class = "docutils literal" > as.sh< / tt > , or execute < tt class = "docutils literal" > as.sh -h< / tt > for more help information.< / p >
< / div >
< div class = "section" id = "windows" >
< span id = "windows" > < / span > < h3 > Windows< a class = "headerlink" href = "#windows" title = "Permalink to this headline" > ¶< / a > < / h3 >
< p > Latest Version, Click To Download: < a class = "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" > < img alt = "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 < tt class = "docutils literal" > as.bat< / tt > from ‘ ’ < tt class = "docutils literal" > pid< / tt > , which means you can only diagnose the local Java process. (Welcome any bat script expert to make it better :heart:)< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > as.bat < pid>
< / pre > < / div >
< / div >
< / div >
< / div >
< div class = "section" id = "manual-command-line-startup" >
< span id = "manual-command-line-startup" > < / span > < h2 > Manual command line startup< a class = "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 > < p class = "first" > Locate java in the target JVM:< / p >
< ul class = "simple" >
< li > Linux/Unix/Mac: < tt class = "docutils literal" > ps aux | grep java< / tt > < / li >
< li > Windows: open the Process Monitor to search java< / li >
< / ul >
< / li >
< li > < p class = "first" > Assemble bootstrap command:< / p >
< p > Let’ < tt class = "docutils literal" > /opt/jdk1.8/bin/java< / tt > , then the command should be:< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "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
< / pre > < / div >
< / div >
< p > Note:< / p >
< ul class = "simple" >
< li > < tt class = "docutils literal" > -Xbootclasspath< / tt > adds tools.jar< / li >
< li > < tt class = "docutils literal" > -jar /tmp/arthas-packaging/arthas-core.jar< / tt > specifies main entry< / li >
< li > < tt class = "docutils literal" > -pid 15146< / tt > specifies the target java process PID< / li >
< li > < tt class = "docutils literal" > -target-ip 127.0.0.1< / tt > specifies the IP< / li >
< li > < tt class = "docutils literal" > -telnet-port 3658 -http-port 8563< / tt > specifies telnet and HTTP ports for remote access< / li >
< li > < tt class = "docutils literal" > -core /tmp/arthas-packaging/arthas-core.jar -agent /tmp/arthas-packaging/arthas/arthas-agent.jar< / tt > specifies core/agent jar package< / li >
< / ul >
< p > If you are running on JDK 1.9 or above， ’ < tt class = "docutils literal" > tools.jar< / tt > in option < tt class = "docutils literal" > -Xbootclasspath< / tt > .< / p >
< p > You can find the logs from < tt class = "docutils literal" > ~/logs/arthas/arthas.log< / tt > .< / p >
< / li >
< li > < p class = "first" > Use telnet to connect once attaching to the target JVM (in step 2) succeeds< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > telnet 127.0.0.1 3658
< / pre > < / div >
< / div >
< / li >
< / ol >
< / div >
< / div >
< / div >
< / div >
< footer >
< hr / >
< div role = "contentinfo" >
< p >
© Copyright 2018, Alibaba Middleware Group, and contributors.
< / p >
< / div >
Built with < a href = "http://sphinx-doc.org/" > Sphinx< / a > using a < a href = "https://github.com/rtfd/sphinx_rtd_theme" > theme< / a > provided by < a href = "https://readthedocs.org" > Read the Docs< / a > .
< / footer >
< / div >
< / div >
< / section >
< / div >
< script type = "text/javascript" >
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'3.0.5',
LANGUAGE:'en',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
< / script >
< script type = "text/javascript" src = "_static/jquery.js" > < / script >
< script type = "text/javascript" src = "_static/underscore.js" > < / script >
< script type = "text/javascript" src = "_static/doctools.js" > < / script >
< script type = "text/javascript" src = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML" > < / script >
< script type = "text/javascript" src = "_static/js/theme.js" > < / script >
< script type = "text/javascript" >
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
< / script >
< div class = "github-fork-ribbon-wrapper right" >
< div class = "github-fork-ribbon" >
< a href = "https://github.com/alibaba/arthas" > Fork me at GitHub< / a >
< / div >
< / div >
< script type = "text/javascript" src = "_static/add_badges.js" > < / script >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.13.1/highlight.min.js" > < / script >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/highlightjs-line-numbers.js/2.5.0/highlightjs-line-numbers.min.js" > < / script >
< script >
document.querySelectorAll('div.hljs > pre').forEach(function(block) {
hljs.highlightBlock(block);
hljs.lineNumbersBlock(block);
});
< / script >
< script >
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?d5c5e25b100f0eb51a4c35c8a86ea9b4";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
< / script >
< / body >
< / html >
