This topic describes how to install, upgrade, and uninstall Logtail on a Linux server.
Prerequisites
- At least one Linux server is available.
- The type of the network that is required to collect logs is determined. You can determine the network type based on the type of the server on which you want to install Logtail and the region where the server resides. For more information, see Select a network type.
Supported operating systems
You can install Logtail on servers that run one of the following x86-64 Linux operating systems:
- Aliyun Linux 2
- Red Hat Enterprise Linux 6, Red Hat Enterprise Linux 7, and Red Hat Enterprise Linux 8
- CentOS Linux 6, CentOS Linux 7, and CentOS Linux 8
- Debian GNU/Linux 8, Debian GNU/Linux 9, and Debian GNU/Linux 10
- Ubuntu 14.04, Ubuntu 16.04, Ubuntu 18.04, and Ubuntu 20.04
- SUSE Linux Enterprise Server 11, SUSE Linux Enterprise Server 12, and SUSE Linux Enterprise Server 15
- openSUSE Leap 15.1, openSUSE Leap 15.2, and openSUSE Leap 42.3
- Glibc 2.5 or later
Precautions
- The installation command in this topic is applicable to Logtail V0.16.x. If you want to install Logtail V1.0 or upgrade the Logtail version to Logtail V1.0, you must add the version number to the installation or upgrade command. For example, to install Logtail V1.0, run the
./logtail.sh install cn-hangzhou -v v1command. To upgrade the Logtail version to V1.0, run thesudo ./logtail.sh upgrade -v v1command. - If you run the installation command on a server on which Logtail is installed, the installer uninstalls Logtail from the server, deletes the /usr/local/ilogtail directory, and then reinstalls Logtail. If the installation is successful, Logtail starts when the system reboots.
- If the installation fails, submit a ticket.
- If you install Logtail on an Elastic Compute Service (ECS) instance that resides in the classic network and then change the network type to Virtual Private Cloud (VPC), you must update the Logtail configuration. For more information, see Do I need to update Logtail settings after the network type is changed?.
Installation methods
The installation command varies based on the network type of the server on which you want to install Logtail.
Before you run the installation command, replace the
${your_region_name} variable in the command with the value for the region where the project resides. The following table describes the value of
${your_region_name} for each region.
| Region | ${your_region_name} | Region | ${your_region_name} |
|---|---|---|---|
| China (Hangzhou) | cn-hangzhou | US (Virginia) | us-east-1 |
| China (Shanghai) | cn-shanghai | Singapore (Singapore) | ap-southeast-1 |
| China (Qingdao) | cn-qingdao | Australia (Sydney) | ap-southeast-2 |
| China (Beijing) | cn-beijing | Malaysia (Kuala Lumpur) | ap-southeast-3 |
| China (Zhangjiakou) | cn-zhangjiakou | Indonesia (Jakarta) | ap-southeast-5 |
| China (Hohhot) | cn-huhehaote | India (Mumbai) | ap-south-1 |
| China (Ulanqab) | cn-wulanchabu | Japan (Tokyo) | ap-northeast-1 |
| China (Shenzhen) | cn-shenzhen | Germany (Frankfurt) | eu-central-1 |
| China (Heyuan) | cn-heyuan | UAE (Dubai) | me-east-1 |
| China (Guangzhou) | cn-guangzhou | UK (London) | eu-west-1 |
| China (Chengdu) | cn-chengdu | N/A | N/A |
| China (Hong Kong) | cn-hongkong | N/A | N/A |
| Russia (Moscow) | rus-west-1 | N/A | N/A |
| US (Silicon Valley) | us-west-1 | N/A | N/A |
Install Logtail over the Alibaba Cloud internal network
- If you cannot identify the region where the ECS instance resides, you can use the auto parameter in the Logtail installation script to install Logtail.
After you specify the auto parameter in the installation command, the Logtail installation script obtains and uses the metadata of the ECS instance to identify the region where the ECS instance resides. For more information about the metadata of the ECS instance, see Overview of ECS instance metadata.
- Download the Logtail installation script over the Internet.
The download consumes approximately 10 KB of Internet traffic.
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh - Install Logtail by using the auto parameter.
If you run the following command in PowerShell or Command Prompt, the Logtail installation package of the region is automatically downloaded. This download does not consume Internet traffic.
./logtail.sh install auto
- Download the Logtail installation script over the Internet.
- If you can identify the region where the ECS instance resides, you can specify the region in the installation command.
Download the Logtail installation script over the internal network. This download does not consume Internet traffic.
- Obtain the value of ${your_region_name} for the region where the Log Service project resides.
For more information about the value of ${your_region_name} for each region, see Table 1. For example, the value of ${your_region_name} for the China (Hangzhou) region is cn-hangzhou.
- Replace the ${your_region_name} variable in the command with the value for the region where the project resides, and then run the installation command.
wget http://logtail-release-${your_region_name}.oss-${your_region_name}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}
The following table describes the installation command that corresponds to each region where the Log Service project resides.Region Installation command China (Hangzhou) wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-hangzhouChina (Shanghai) wget http://logtail-release-cn-shanghai.oss-cn-shanghai-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-shanghaiChina (Qingdao) wget http://logtail-release-cn-qingdao.oss-cn-qingdao-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-qingdaoChina (Beijing) wget http://logtail-release-cn-beijing.oss-cn-beijing-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-beijingChina (Zhangjiakou) wget http://logtail-release-cn-zhangjiakou.oss-cn-zhangjiakou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-zhangjiakouChina (Hohhot) wget http://logtail-release-cn-huhehaote.oss-cn-huhehaote-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-huhehaoteChina (Ulanqab) wget http://logtail-release-cn-wulanchabu.oss-cn-wulanchabu-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-wulanchabuChina (Shenzhen) wget http://logtail-release-cn-shenzhen.oss-cn-shenzhen-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-shenzhenChina (Heyuan) wget http://logtail-release-cn-heyuan.oss-cn-heyuan-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-heyuanChina (Guangzhou) wget http://logtail-release-cn-guangzhou.oss-cn-guangzhou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-guangzhouChina (Chengdu) wget http://logtail-release-cn-chengdu.oss-cn-chengdu-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-chengduChina (Hong Kong) wget http://logtail-release-cn-hongkong.oss-cn-hongkong-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-hongkongUS (Silicon Valley) wget http://logtail-release-us-west-1.oss-us-west-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install us-west-1US (Virginia) wget http://logtail-release-us-east-1.oss-us-east-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install us-east-1Singapore (Singapore) wget http://logtail-release-ap-southeast-1.oss-ap-southeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-1Australia (Sydney) wget http://logtail-release-ap-southeast-2.oss-ap-southeast-2-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-2Malaysia (Kuala Lumpur) wget http://logtail-release-ap-southeast-3.oss-ap-southeast-3-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-3Indonesia (Jakarta) wget http://logtail-release-ap-southeast-5.oss-ap-southeast-5-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-5Japan (Tokyo) wget http://logtail-release-ap-northeast-1.oss-ap-northeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-northeast-1India (Mumbai) wget http://logtail-release-ap-south-1.oss-ap-south-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-south-1Germany (Frankfurt) wget http://logtail-release-eu-central-1.oss-eu-central-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install eu-central-1UAE (Dubai) wget http://logtail-release-me-east-1.oss-me-east-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install me-east-1UK (London) wget http://logtail-release-eu-west-1.oss-eu-west-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install eu-west-1Russia (Moscow) wget http://logtail-release-rus-west-1.oss-rus-west-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install rus-west-1 - Obtain the value of ${your_region_name} for the region where the Log Service project resides.
Install Logtail over the Internet
The following table describes the installation command that corresponds to each region where the Log Service project resides.
| Region | Installation command |
|---|---|
| China (Hangzhou) | |
| China (Shanghai) | |
| China (Qingdao) | |
| China (Beijing) | |
| China (Zhangjiakou) | |
| China (Hohhot) | |
| China (Ulanqab) | |
| China (Shenzhen) | |
| China (Heyuan) | |
| China (Guangzhou) | |
| China (Chengdu) | |
| China (Hong Kong) | |
| US (Silicon Valley) | |
| US (Virginia) | |
| Singapore (Singapore) | |
| Australia (Sydney) | |
| Malaysia (Kuala Lumpur) | |
| Indonesia (Jakarta) | |
| Japan (Tokyo) | |
| Germany (Frankfurt) | |
| UAE (Dubai) | |
| India (Mumbai) | |
| UK (London) | |
| Russia (Moscow) | |
Install Logtail by using the global acceleration feature
The following table describes the installation command that corresponds to each region where the Log Service project resides.
| Region | Installation command |
|---|---|
| China (Beijing) | |
| China (Qingdao) | |
| China (Hangzhou) | |
| China (Shanghai) | |
| China (Shenzhen) | |
| China (Heyuan) | |
| China (Guangzhou) | |
| China (Zhangjiakou) | |
| China (Hohhot) | |
| China (Ulanqab) | |
| China (Chengdu) | |
| China (Hong Kong) | |
| US (Silicon Valley) | |
| US (Virginia) | |
| Singapore (Singapore) | |
| Australia (Sydney) | |
| Malaysia (Kuala Lumpur) | |
| Indonesia (Jakarta) | |
| Japan (Tokyo) | |
| Germany (Frankfurt) | |
| UAE (Dubai) | |
| India (Mumbai) | |
| UK (London) | |
| Russia (Moscow) | |
Install Logtail offline
Note If you want to upgrade Logtail offline, you can download the latest installation package and run the
chmod +x logtail.sh; ./logtail.sh upgrade-local command.
View the version of Logtail
Go to the installation directory and open the
/usr/local/ilogtail/app_info.json file. The value of the
logtail_version field indicates the version of Logtail.
- Command
cat /usr/local/ilogtail/app_info.json - Response
{ "UUID" : "0DF18E97-0F2D-486F-B77F-*********", "hostname" : "david*******", "instance_id" : "F4FAFADA-F1D7-11E7-846C-00163E30349E_*********_1515129548", "ip" : "**********", "logtail_version" : "0.16.30", "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" : "2020-01-05 13:19:08" }
Upgrade Logtail
You can use the Logtail installation script logtail.sh to upgrade Logtail. The installation script selects an upgrade method based on the configurations of the Logtail that is installed.
Note During the upgrade, Logtail is temporarily stopped, but no log data is lost. After Logtail is upgraded, only the configuration files and checkpoint files are retained. Other files are overwritten.
Start and stop Logtail
- Start Logtail
Run the following command as a root user:
/etc/init.d/ilogtaild start - Stop Logtail
Run the following command as a root user:
/etc/init.d/ilogtaild stop
Uninstall Logtail
Run the following command to uninstall Logtail:
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh;./logtail.sh uninstall