安装Logtail（Linux系统）_用户指南_日志服务

Logtail客户端是日志服务提供的日志采集客户端，本文介绍如何在Linux服务器上安装Logtail客户端。

支持的系统

支持如下版本的Linux x86-64（64位）服务器：

Aliyun Linux
Ubuntu
Debian
CentOS
OpenSUSE
RedHat

安装步骤

说明 Logtail采用覆盖安装模式，若您之前已安装过Logtail，那么安装器会先执行卸载、删除/usr/local/ilogtail 目录后再重新安装。安装后默认启动Logtail并注册开机启动。

执行如下命令下载Logtail安装器。
```
wget http://${service:sls-backend-server:sls_data.endpoint}/logtail.sh -O logtail.sh; chmod 755 logtail.sh
```
说明命令中${service:sls-backend-server:sls_data.endpoint}请替换为真实的Endpoint，您可以在Project概览中查看Endpoint信息。
执行安装命令。
启动Shell终端，以管理员权限执行以下命令，安装Logtail。
```
./logtail.sh install
```
配置阿里云主账号ID。

查看Logtail版本

Logtail会将版本信息记录在/usr/local/ilogtail/app_info.json中的logtail_version字段，例如：

$cat /usr/local/ilogtail/app_info.json
{
   "UUID" : "0DF18E97-0F2D-486F-B77F-*********",
   "hostname" : "david*******",
   "instance_id" : "F4FAFADA-F1D7-11E7-846C-00163E30349E_*********_1515129548",
   "ip" : "**********",
   "logtail_version" : "0.16.0",
   "os" : "Linux; 2.6.32-220.23.2.ali1113.el5.x86_64; #1 SMP Thu Jul 4 20:09:15 CST 2013; x86_64",
   "update_time" : "2018-01-05 13:19:08"
}

升级Logtail

您可以通过Logtail安装器（logtail.sh）来进行Logtail的升级，安装器会根据已经安装的Logtail配置信息自动选择合适的方式进行升级。

说明升级过程中会短暂停止Logtail，但升级只会覆盖必要的文件，配置文件以及Checkpoint文件将会被保留。升级期间日志不会丢失。

执行以下命令升级Logtail：

# 下载安装器
wget http://${service:sls-backend-server:sls_data.endpoint}/logtail.sh -O logtail.sh; chmod 755 logtail.sh
# 执行升级命令
sudo ./logtail.sh upgrade

执行结果：

# 升级成功
Stop logtail successfully.
ilogtail is running
Upgrade logtail success
{
   "UUID" : "***",
   "hostname" : "***",
   "instance_id" : "***",
   "ip" : "***",
   "logtail_version" : "0.16.11",
   "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
   "update_time" : "2018-08-29 15:01:36"
}
# 升级失败：已经是最新版本
[Error]:    Already up to date.

手动启动和停止Logtail

启动
以管理员身份执行：
```
/etc/init.d/ilogtaild start
```
停止
以管理员身份执行：
```
/etc/init.d/ilogtaild stop
```

卸载Logtail

在Shell下以管理员身份执行以下命令，卸载Logtail。

wget http://${service:sls-backend-server:sls_data.endpoint}/logtail.sh -O logtail.sh
chmod 755 logtail.sh
./logtail.sh uninstall