doc-exports/docs/apm/umn/apm_02_0003.html

<a name="apm_02_0003"></a><a name="apm_02_0003"></a>

<h1 class="topictitle1">Connecting Agents</h1>
<div id="body8662426"><div class="section" id="apm_02_0003__en-us_topic_0000001240795513_section17813348121916"><h4 class="sectiontitle">Prerequisites</h4><ul id="apm_02_0003__en-us_topic_0000001240795513_ul129363182820"><li id="apm_02_0003__en-us_topic_0000001240795513_li1793143111287">The network between your host and APM is normal. You can run the <strong id="apm_02_0003__en-us_topic_0000001240795513_b173662153012">Telnet</strong> command to check the network. </li><li id="apm_02_0003__en-us_topic_0000001240795513_li10436047172810">Java supports enhanced Agents.</li></ul>
</div>
<div class="section" id="apm_02_0003__en-us_topic_0000001240795513_section1589121232011"><h4 class="sectiontitle">Procedure</h4><ol id="apm_02_0003__en-us_topic_0000001240795513_ol1351071614214"><li id="apm_02_0003__en-us_topic_0000001240795513_li16341124313510"><span>Log in to the management console.</span></li><li id="apm_02_0003__en-us_topic_0000001240795513_li173133451242"><span>Click <span><img id="apm_02_0003__en-us_topic_0000001240795513_image463017919610" src="en-us_image_0000001737607793.png"></span> on the left and choose <strong id="apm_02_0003__en-us_topic_0000001240795513_b12645114714213">Application</strong> &gt; <strong id="apm_02_0003__en-us_topic_0000001240795513_b18646847134214">Application Performance Management</strong>.</span></li><li id="apm_02_0003__en-us_topic_0000001240795513_li16921646600"><span>In the navigation pane, choose <strong id="apm_02_0003__en-us_topic_0000001240795513_b111992013124516">Application Monitoring</strong> &gt; <strong id="apm_02_0003__en-us_topic_0000001240795513_b14203171311453">Applications</strong>.</span></li><li id="apm_02_0003__en-us_topic_0000001240795513_li19522547498"><span>On the displayed page, click <strong id="apm_02_0003__en-us_topic_0000001240795513_b88121726164617">Connect Application</strong>.</span><p><div class="fignone" id="apm_02_0003__en-us_topic_0000001240795513_fig2036920407611"><span class="figcap"><b>Figure 1 </b>Connecting an application</span><br><span><img id="apm_02_0003__en-us_topic_0000001240795513_image63707407614" src="en-us_image_0000001675786929.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="apm_02_0003__en-us_topic_0000001240795513_li4618164910918"><span>Select a region and application. Click <strong id="apm_02_0003__en-us_topic_0000001240795513_b13400155541413">Create Application</strong>. In the dialog box that is displayed, create an application by referring to <a href="apm_07_0151.html">Creating an Application</a>.</span><p><div class="fignone" id="apm_02_0003__en-us_topic_0000001240795513_fig144971816810"><span class="figcap"><b>Figure 2 </b>Basic information</span><br><span><img id="apm_02_0003__en-us_topic_0000001240795513_image184509181286" src="en-us_image_0000001627467410.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="apm_02_0003__en-us_topic_0000001240795513_li553275751416"><span>Select <strong id="apm_02_0003__en-us_topic_0000001240795513_b03754151746">Enhanced Agent</strong> for <strong id="apm_02_0003__en-us_topic_0000001240795513_b16526147342">Access Mode</strong>.</span></li><li id="apm_02_0003__en-us_topic_0000001240795513_li864564529"><span>Select <strong id="apm_02_0003__en-us_topic_0000001240795513_b1744320128431">Java</strong> for <strong id="apm_02_0003__en-us_topic_0000001240795513_b1545814010576">Backend Language</strong>.</span><p><div class="fignone" id="apm_02_0003__en-us_topic_0000001240795513_fig12605103314161"><span class="figcap"><b>Figure 3 </b>Access mode</span><br><span><img id="apm_02_0003__en-us_topic_0000001240795513_image1860593331618" src="en-us_image_0000001881092662.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="apm_02_0003__en-us_topic_0000001240795513_li83469115814"><span>Use a remote login tool, such as PuTTY, to log in to the Linux host where the Agent is to be installed and run related commands as the user with the root or service permissions.</span></li><li id="apm_02_0003__en-us_topic_0000001240795513_li697555818384"><span>Select an access mode based on the application type and access data by following the instructions.</span><p><div class="fignone" id="apm_02_0003__en-us_topic_0000001240795513_fig641535134"><span class="figcap"><b>Figure 4 </b>Data access</span><br><span><img id="apm_02_0003__en-us_topic_0000001240795513_image44538139" src="en-us_image_0000001627469086.png" title="Click to enlarge" class="imgResize"></span></div>

<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="apm_02_0003__en-us_topic_0000001240795513_table12674171035614" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="apm_02_0003__en-us_topic_0000001240795513_row116741110125611"><th align="left" class="cellrowborder" valign="top" width="10.85%" id="mcps1.3.2.2.9.2.2.2.4.1.1"><p id="apm_02_0003__en-us_topic_0000001240795513_p3675111075611">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="80.33%" id="mcps1.3.2.2.9.2.2.2.4.1.2"><p id="apm_02_0003__en-us_topic_0000001240795513_p17675610175611">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.82%" id="mcps1.3.2.2.9.2.2.2.4.1.3"><p id="apm_02_0003__en-us_topic_0000001240795513_p2067516102561">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="apm_02_0003__en-us_topic_0000001240795513_row12628113854514"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p153281623511">APM_AK</p>
<p id="apm_02_0003__en-us_topic_0000001240795513_p1811692813194">APM_SK</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p19531150933">AK and SK for installing JavaAgent. To obtain <strong id="apm_02_0003__en-us_topic_0000001240795513_b4726112454515">APM_AK</strong> and <strong id="apm_02_0003__en-us_topic_0000001240795513_b1826832719459">APM_SK</strong>, see <a href="apm_07_0034.html">Access Keys</a>.</p>
<p id="apm_02_0003__en-us_topic_0000001240795513_p223211310157">When you copy the command to install JavaAgent, delete <strong id="apm_02_0003__en-us_topic_0000001240795513_b75947331259">{}</strong> when setting <strong id="apm_02_0003__en-us_topic_0000001240795513_b09846375511">APM_AK</strong> and <strong id="apm_02_0003__en-us_topic_0000001240795513_b21999408510">APM_SK</strong>.</p>
<p id="apm_02_0003__en-us_topic_0000001240795513_p69161151103815">Example:</p>
<pre class="screen" id="apm_02_0003__en-us_topic_0000001240795513_screen15018016397">curl -k https://javaagent.***/apm_agent_install2.sh -o apm_agent_install.sh &amp;&amp; bash apm_agent_install.sh -ak * -sk * -masteraddress https://**** -obsaddress https://javaagent.***.com -version latest; history -cw; history -r </pre>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p57941771918">Yes</p>
</td>
</tr>
<tr id="apm_02_0003__en-us_topic_0000001240795513_row0615195015438"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p66167504435">Probe Installation Path</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p146161250134317">Path for installing the Agent.</p>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p176161150144316">Yes</p>
</td>
</tr>
<tr id="apm_02_0003__en-us_topic_0000001240795513_row1167561075618"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p126751210155615">appName</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p15675191016566">Component name, which must start with a letter. A component can contain multiple environments. The names of components under an application must be unique. If there are duplicate names, use <strong id="apm_02_0003__en-us_topic_0000001240795513_b37731226101118">instanceName</strong> to distinguish them.</p>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p206757102566">Yes</p>
</td>
</tr>
<tr id="apm_02_0003__en-us_topic_0000001240795513_row1067631012567"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p367671065614">env</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p17676010135611">Name of an environment where an application is deployed. A program can be deployed in different environments (such as the test or live network environment). Each environment is deployed in one region and has a unique region attribute. If this parameter is blank, the default environment will be used.</p>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p1467631025616">No</p>
</td>
</tr>
<tr id="apm_02_0003__en-us_topic_0000001240795513_row967612102566"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p10676510125615">envTag</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p1267671095618">Environment tag for filtering environments. Different environments may have the same tag. This parameter can be left blank.</p>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p42451326195910">No</p>
</td>
</tr>
<tr id="apm_02_0003__en-us_topic_0000001240795513_row2677141095615"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p1867716106563">business</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p967701010568">Name of an application that already exists (a global concept). If this parameter is left blank, the automatically created application will be used.</p>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p1594892611597">No</p>
</td>
</tr>
<tr id="apm_02_0003__en-us_topic_0000001240795513_row56775104566"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p1267714108561">subBusiness</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p1961013338290">Name of a sub-application (a global concept), which is similar to a folder. If it is left blank, resources will be mounted to the root application. There can be up to three layers of sub-applications. For example, for <strong id="apm_02_0003__en-us_topic_0000001240795513_b2244248163820">a/b/c</strong>, <strong id="apm_02_0003__en-us_topic_0000001240795513_b424514482388">a</strong>, <strong id="apm_02_0003__en-us_topic_0000001240795513_b624519483383">b</strong>, and <strong id="apm_02_0003__en-us_topic_0000001240795513_b11245184813810">c</strong> respectively represents a layer.</p>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p145513278599">No</p>
</td>
</tr>
<tr id="apm_02_0003__en-us_topic_0000001240795513_row106777106563"><td class="cellrowborder" valign="top" width="10.85%" headers="mcps1.3.2.2.9.2.2.2.4.1.1 "><p id="apm_02_0003__en-us_topic_0000001240795513_p898181317811">User Application</p>
</td>
<td class="cellrowborder" valign="top" width="80.33%" headers="mcps1.3.2.2.9.2.2.2.4.1.2 "><p id="apm_02_0003__en-us_topic_0000001240795513_p394812137816">Name of a user application.</p>
</td>
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.2.2.9.2.2.2.4.1.3 "><p id="apm_02_0003__en-us_topic_0000001240795513_p1379172815599">Yes</p>
</td>
</tr>
</tbody>
</table>
</div>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="apm_02_0002.html">Monitoring Java Applications</a></div>
</div>
</div>


<script language="JavaScript">
<!--
image_size('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>