doc-exports/docs/lts/umn/lts_02_0014.html
Liu, Siying 35cd899fe1 LTS UMN 20230609 version.
Reviewed-by: Mützel, Andrea <andrea.muetzel@t-systems.com>
Co-authored-by: Liu, Siying <liusiying@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-committed-by: Liu, Siying <liusiying@noreply.gitea.eco.tsi-dev.otc-service.com>
2023-08-08 15:12:51 +00:00

24 lines
5.9 KiB
HTML

<a name="lts_02_0014"></a><a name="lts_02_0014"></a>
<h1 class="topictitle1">Upgrading ICAgent</h1>
<div id="body32001227"><p id="lts_02_0014__en-us_topic_0000001167072801_p202708754819">To deliver a better collection experience, LTS regularly upgrades ICAgent. When LTS prompts you that a new ICAgent version is available, you can follow the directions here to obtain the latest version.</p>
<div class="note" id="lts_02_0014__en-us_topic_0000001167072801_note10915102418718"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="lts_02_0014__en-us_topic_0000001167072801_p2035235217345">Linux hosts support ICAgent upgrade on the <strong id="lts_02_0014__en-us_topic_0000001167072801_b11644150154714">Host Management</strong> page of the LTS console.</p>
</div></div>
<div class="section" id="lts_02_0014__en-us_topic_0000001167072801_section3441614134517"><h4 class="sectiontitle">Procedure</h4><ol id="lts_02_0014__en-us_topic_0000001167072801_ol137191020164513"><li id="lts_02_0014__en-us_topic_0000001167072801_li18355417101">Log in to the LTS console and choose <strong id="lts_02_0014__en-us_topic_0000001167072801_b777918904810">Host Management</strong> in the navigation pane on the left.</li><li id="lts_02_0014__en-us_topic_0000001167072801_li1321353322419">On the <strong id="lts_02_0014__en-us_topic_0000001167072801_b207653311556">Host Management</strong> page, click the <strong id="lts_02_0014__en-us_topic_0000001167072801_b07663325516">Hosts</strong> tab.</li><li id="lts_02_0014__en-us_topic_0000001167072801_li16352317442">Select <strong id="lts_02_0014__en-us_topic_0000001167072801_b11791111914447">Hosts</strong>. Select one or more hosts where ICAgent is to be upgraded, and click <strong id="lts_02_0014__en-us_topic_0000001167072801_b7792111964411">Upgrade ICAgent</strong>.<p id="lts_02_0014__en-us_topic_0000001167072801_p2692181411159">Select <strong id="lts_02_0014__en-us_topic_0000001167072801_b24411128527">CCE Cluster</strong>. In the drop-down list on the right, select the cluster whose ICAgent is to be upgraded, and click <strong id="lts_02_0014__en-us_topic_0000001167072801_b936455785112">Upgrade ICAgent</strong>.</p>
<div class="fignone" id="lts_02_0014__en-us_topic_0000001167072801_fig57484201226"><span class="figcap"><b>Figure 1 </b>Upgrading ICAgent</span><br><span><img id="lts_02_0014__en-us_topic_0000001167072801_image12721196217" src="en-us_image_0000001460235561.png"></span></div>
<div class="p" id="lts_02_0014__en-us_topic_0000001167072801_p4751182010211"><div class="note" id="lts_02_0014__en-us_topic_0000001167072801_note1249649132614"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="lts_02_0014__en-us_topic_0000001167072801_ul5742236152714"><li id="lts_02_0014__en-us_topic_0000001167072801_li1088163816131">If you create a CCE cluster for the first time, ICAgents will be installed on hosts in the cluster by default, and logs will be reported to AOM. <strong id="lts_02_0014__en-us_topic_0000001167072801_b6480931104412">Output to AOM</strong> is enabled by default. To report logs to LTS, disable <strong id="lts_02_0014__en-us_topic_0000001167072801_b1848053114442">Output to AOM</strong> before upgrading ICAgents. You are advised to choose <strong id="lts_02_0014__en-us_topic_0000001167072801_b10755651162110">Log Ingestion</strong> &gt; <strong id="lts_02_0014__en-us_topic_0000001167072801_b11716957162118">Cloud Service</strong> &gt; <strong id="lts_02_0014__en-us_topic_0000001167072801_b12804164228">Cloud Container Engine (CCE)</strong> to collect container data and output it to LTS instead of AOM.</li><li id="lts_02_0014__en-us_topic_0000001167072801_li37427362279">CCE cluster ID (ClusterID): Each cluster has a fixed ID.</li><li id="lts_02_0014__en-us_topic_0000001167072801_li31551451286">When ICAgent is upgraded, LTS creates log groups and host groups for your CCE cluster. The name of the log group and host group is <strong id="lts_02_0014__en-us_topic_0000001167072801_b1817575681513">k8s-log-</strong><em id="lts_02_0014__en-us_topic_0000001167072801_i10710165911151">{ClusterID}</em>. You can create an ingestion configuration (<strong id="lts_02_0014__en-us_topic_0000001167072801_b17402193175214">Cloud Services</strong> &gt; <strong id="lts_02_0014__en-us_topic_0000001167072801_b657153935215">Cloud Container Engine (CCE)</strong>) to add logs of the current CCE cluster to the log group.</li><li id="lts_02_0014__en-us_topic_0000001167072801_li136821029111010">If the ICAgent is not installed on hosts in a cluster or the ICAgent version is too early, click <strong id="lts_02_0014__en-us_topic_0000001167072801_b17543332121711">Upgrade ICAgent</strong> to install the ICAgent on all hosts in the cluster.</li></ul>
</div></div>
</div>
</li><li id="lts_02_0014__en-us_topic_0000001167072801_li1171912084518">In the displayed dialog box, click <strong id="lts_02_0014__en-us_topic_0000001167072801_b3259561916055">OK</strong>.<p id="lts_02_0014__en-us_topic_0000001167072801_p1371942016456">The upgrade begins. This process takes about a minute. When the ICAgent status changes from <strong id="lts_02_0014__en-us_topic_0000001167072801_b17825628006055">Upgrading</strong> to <strong id="lts_02_0014__en-us_topic_0000001167072801_b10507146055">Running</strong>, the ICAgent upgrade has completed.</p>
<div class="note" id="lts_02_0014__en-us_topic_0000001167072801_note146831515326"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="lts_02_0014__en-us_topic_0000001167072801_p64694159325">If the ICAgent is abnormal after the upgrade or if the upgrade fails, log in to the host and run the installation command. ICAgent can be re-installed on top of itself.</p>
</div></div>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="lts_04_0012.html">Managing Hosts</a></div>
</div>
</div>