This topic describes how to install, upgrade, and uninstall Logtail on a Linux server.
Prerequisites
- At least one Linux server is available.
- The network type required for log collection is determined based on the server type and the region in which the server resides. For more information, see Select a network type.
Supported systems
Logtail supports the following x86-64 (64-bit) Linux operating systems:
- Aliyun Linux
- Ubuntu
- Debian
- CentOS
- OpenSUSE
- RedHat
Precautions
- If you have installed Logtail, the installer uninstalls the existing version of Logtail, deletes the /usr/local/ilogtail directory, and then reinstalls Logtail. By default, Logtail runs after it is installed and launches when the system reboots.
- If the installation fails, click here to submit a ticket.
- After Logtail is installed, if the network type of the ECS instance is switched from the classic network 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
Select the corresponding installation command based on the network type of the server.
Before you run the installation command, set the ${your_region_name} parameter to the region where the project resides. The following table lists the
value of the ${your_region_name} parameter that corresponds to each region.
| Region | ${your_region_name} | Region | ${your_region_name} |
|---|---|---|---|
| China (Hangzhou) | cn-hangzhou | Singapore | ap-southeast-1 |
| China (Shanghai) | cn-shanghai | Australia (Sydney) | ap-southeast-2 |
| China (Qingdao) | cn-qingdao | Malaysia (Kuala Lumpur) | ap-southeast-3 |
| China (Beijing) | cn-beijing | Indonesia (Jakarta) | ap-southeast-5 |
| China (Zhangjiakou-Beijing Winter Olympics) | cn-zhangjiakou | India (Mumbai) | ap-south-1 |
| China (Hohhot) | cn-huhehaote | Japan (Tokyo) | ap-northeast-1 |
| China (Shenzhen) | cn-shenzhen | Germany (Frankfurt) | eu-central-1 |
| China (Chengdu) | cn-chengdu | UAE (Dubai) | me-east-1 |
| China (Heyuan) | cn-heyuan | UK (London) | eu-west-1 |
| China (Hong Kong) | cn-hongkong | N/A | N/A |
| US (Silicon Valley) | us-west-1 | N/A | N/A |
| US (Virginia) | us-east-1 | N/A | N/A |
Install Logtail over the Alibaba Cloud internal network
- If you cannot identify the region where the ECS instance is located, 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. For more information about the metadata of the ECS instance, see Metadata.
- Download the Logtail installation script over the public network.
This download consumes about 10 KB public network 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.
After you run the following command, the Logtail installation program of the corresponding region is automatically downloaded. This download does not consume public network traffic.
./logtail.sh install auto
- Download the Logtail installation script over the public network.
- If you have identified the region where the ECS is located, select the installation
command that corresponds to the region.
Download the Logtail installation script over the internal network, and install Logtail. The download does not consume public network traffic.
- Obtain the value of the
${your_region_name}parameter for the region to which the project belongs.For more information about the value of the
${your_region_name}parameter for each region, see Region names. For example, the value of the${your_region_name}parameter for China (Hangzhou) iscn-hangzhou. - Replace
${your_region_name}with the corresponding value, 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 lists the installation command that corresponds to each region.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-Beijing Winter Olympics) 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 (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 (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 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-1 - Obtain the value of the
Install Logtail over the public network
The following table lists the installation command that corresponds to each region.
| Region | Installation command |
|---|---|
| China (Hangzhou) |
|
| China (Shanghai) |
|
| China (Qingdao) |
|
| China (Beijing) |
|
| China (Zhangjiakou-Beijing Winter Olympics) |
|
| China (Hohhot) |
|
| China (Shenzhen) |
|
| China (Heyuan) |
|
| China (Chengdu) |
|
| China (Hong Kong) |
|
| US (Silicon Valley) |
|
| US (Virginia) |
|
| Singapore |
|
| Australia (Sydney) |
|
| Malaysia (Kuala Lumpur) |
|
| Indonesia (Jakarta) |
|
| Japan (Tokyo) |
|
| Germany (Frankfurt) |
|
| UAE (Dubai) |
|
| India (Mumbai) |
|
| UK (London) |
|
Install Logtail by using Global Acceleration
The following table lists the installation command that corresponds to each region.
| Region | Installation command |
|---|---|
| China (Beijing) |
|
| China (Qingdao) |
|
| China (Hangzhou) |
|
| China (Shanghai) |
|
| China (Shenzhen) |
|
| China (Zhangjiakou-Beijing Winter Olympics) |
|
| China (Hohhot) |
|
| China (Heyuan) |
|
| China (Chengdu) |
|
| China (Hong Kong) |
|
| US (Silicon Valley) |
|
| US (Virginia) |
|
| Singapore |
|
| Australia (Sydney) |
|
| Malaysia (Kuala Lumpur) |
|
| Indonesia (Jakarta) |
|
| Japan (Tokyo) |
|
| Germany (Frankfurt) |
|
| UAE (Dubai) |
|
| India (Mumbai) |
|
| UK (London) |
|
View the Logtail version
Open the /usr/local/ilogtail/app_info.json file. The version of Logtail is shown in the
logtail_version field of the file.
$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"
}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 installed Logtail.
Note During upgrade, Logtail is temporarily stopped, but no log data loss occurs. After
Logtail is upgraded, the configuration files and checkpoint files are retained. Other
original 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 commands to download the Logtail installation script (logtail.sh) and 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