如何从Logtail升级到LoongCollector（主机场景）_日志服务(SLS)-阿里云帮助中心

本文介绍日志服务Logtail向LoongCollector升级以及LoongCollector回滚至Logtail版本的操作流程。

Logtail升级到LoongCollector介绍

LoongCollector在日志场景中完成全面升级，从功能、性能、稳定性多维度深度优化。此次重构iLogtail架构，核心C++引擎引入流水线设计，实现输入/处理/输出模块插件化，支持灵活组合。每项采集任务对应独立配置，精准定义数据采集、处理及传输全流程。更多信息，请参见日志采集效能跃迁：iLogtail 到 LoongCollector 的全面升级。

主机场景

从Logtail升级到LoongCollector

请根据主机操作系统，参照下表对应命令升级Logtail至LoongCollector。

主机类型

操作系统

下载方式

安装方式

Linux

ARM

主机可联网，直接下载。

wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

根据网络情况选择安装命令。

#公网方式安装
chmod +x loongcollector.sh; ./loongcollector.sh upgrade

x86-64

ARM

主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包。

wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

请将安装脚本和安装包拷贝至需要安装LoongCollector的服务器上后，根据网络情况选择安装命令。

#公网方式安装
chmod +x loongcollector.sh; ./loongcollector.sh upgrade-local

x86-64

主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包。

wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

如果显示以下信息，则表示升级成功。

Try to stop ilogtail ...
kill process Name: ilogtail pid: 878
kill process Name: ilogtail pid: 879
stop successfully
Stop ilogtail successfully.
Upgrading loongcollector files ...
Upgrade loongcollector files successfully.
Starting loongcollector ...
loongcollector is running
Upgrade loongcollector successfully.

从LoongCollector回滚到Logtail

请根据主机操作系统，参照下表对应命令将LoongCollector回滚到Logtail。

说明

必须要重新下载logtail.sh脚本，不能使用原来的logtail.sh脚本。

操作系统	下载方式	升级方式
ARM与x86-64	主机可联网： `wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;`	下载完成后执行升级命令。 `chmod +x logtail.sh; sudo ./logtail.sh upgrade;` 如果需要指定某个特定版本，则执行如下命令。 `# 比如指定 1.8.7 版本，根据实际情况替换版本号。 chmod +x logtail.sh; sudo ./logtail.sh upgrade -v -v 1.8.7;`

ARM	主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包： `wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz;`	请将安装脚本和安装包拷贝至需要升级Logtail的服务器上后，执行如下升级命令。 `chmod +x logtail.sh; ./logtail.sh upgrade-local;`
x86-64	主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包： `wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz;`

Kubernetes场景

从Logtail升级至LoongCollector

自建集群

卸载Logtail：执行如下命令，卸载已安装的logtail-ds、alibaba-log-controller等组件：
警告
该命令会递归删除result目录中所有资源，若目录下存在其他资源请谨慎使用。
```
kubectl delete -R -f result
```
安装LoongCollector：参考自建集群安装LoongCollector操作安装LoongCollector。

阿里云ACK 集群

登录容器服务管理控制台，在左侧导航栏选择集群列表。
在集群列表页面，单击目标集群名称，然后在左侧导航栏，单击组件管理。
在日志与监控页签中，找到logtail-ds，单击卸载，根据界面提示单击确定，完成卸载。
单击loongcollector卡片的安装，在弹框中单击确认，完成loongcollector的安装。

从LoongCollector回滚到Logtail

自建集群

卸载LoongCollector：执行如下命令，卸载已安装的loongcollector等组件。
重要
此命令默认不会删除由 Chart 安装的 CRD资源。
```
helm uninstall loongcollector -n kube-system
```
安装Logtail：参考安装Logtail组件安装Logtail。

阿里云ACK 集群

登录容器服务管理控制台，在左侧导航栏选择集群列表。
在集群列表页面，单击目标集群名称，然后在左侧导航栏，单击组件管理。
在日志与监控页签中，找到loongcollector，单击卸载，根据界面提示单击确定，完成卸载。
单击logtail-ds卡片的安装，在弹框中单击确认，完成logtail的安装。