This topic describes how to install the Logtail client on Linux servers.
Supported systems
The following Linux x86-64 systems are supported:
- Aliyun Linux
- Ubuntu
- Debian
- CentOS
- OpenSUSE
- Red Hat
Prerequisites
- Your account has at least one server under it.
- You have determined the required network type for log collection according to the server type and region to which the server belongs. For more information, see Select a network type.
Figure 1. Select a network type
Precautions
- If Logtail is already installed, the Logtail installer will uninstall your current version of Logtail, delete the
/usr/local/ilogtaildirectory, and reinstall Logtail. Then, Logtail is started and registered by default. ${your_region_name}is an installation parameter used for Docker and Kubernetes installation, and you can copy it from the installation parameter table.- If the installation fails, open a ticket for technical support.
Installation methods
Choose one of the following installation methods according to the network type you selected.
Before running the installation command, you need to replace the value of
${your_region_name} with the actual installation parameter required. You can copy the required installation parameter based on the corresponding region from the following table.
| Region | Installation parameter |
|---|---|
| China (Hangzhou) | cn-hangzhou |
| China (Shanghai) | cn-shanghai |
| China (Qingdao) | cn-qingdao |
| China (Beijing) | cn-beijing |
| China (Zhangjiakou) | cn-zhangjiakou |
| China (Hohhot) | cn-huhehaote |
| China (Shenzhen) | cn-shenzhen |
| China (Chengdu) | cn-chengdu |
| Hong Kong | cn-hongkong |
| US (Silicon Valley) | us-west-1 |
| US (Virginia) | us-east-1 |
| Singapore | ap-southeast-1 |
| Australia (Sydney) | ap-southeast-2 |
| Malaysia (Kuala Lumpur) | ap-southeast-3 |
| Indonesia (Jakarta) | ap-southeast-5 |
| India (Mumbai) | ap-south-1 |
| Japan (Tokyo) | ap-northeast-1 |
| Germany (Frankfurt) | eu-central-1 |
| UAE (Dubai) | me-east-1 |
| UK (London) | eu-west-1 |
Install Logtail through the Alibaba Cloud intranet
The Alibaba Cloud intranet is a GiB-level shared network, which provides a faster and more stable data transfer than the Internet and does not consume Internet bandwidth.
The Alibaba Cloud intranet applies to Alibaba Cloud ECS servers that are deployed in the region to which the Log Service project belongs.
You can use either of the following methods to install Logtail:
- Enable automatic installation parameter selection.
If you are unsure about the region of the ECS server, you can specify the auto parameter of the Logtail installer. Then, the Logtail installer will obtain the metadata from the server to automatically locate the region of the ECS server.
To enable automatic installation parameter selection, follow these steps:- Download the Logtail installer through the Internet by running the following command:
Note This operation requires access to the Internet and consumes about 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 - Use the auto parameter by running the following command:
Note This operation does not consume Internet traffic. The installation program will be automatically downloaded.
./logtail.sh install auto
- Download the Logtail installer through the Internet by running the following command:
- Manually install Logtail.
You can manually install the Logtail installer through the intranet, which does not consume Internet traffic.
To install Logtail, choose the required installation parameter and run the installation command. Specifically, you need to choose the correct parameter from the installation parameter table, replace${your_region_name}with the required parameter, and run the following installation command:Note In the installation command,${your_region_name}indicates the region to which the Log Service project belongs. For example, the installation parameter for the China (Hangzhou) region iscn-hangzhou.
Alternatively, after confirming the region to which the Log Service project belongs, you can run the corresponding installation command listed in the following table to install Logtail: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}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 (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 (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-chengduHong 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
Install Logtail through the Internet
Data is written into Log Service through the Internet, which consumes Internet bandwidth.
This method applies to on-premises IDCs and servers provided by other cloud product vendors.
Note Log Service cannot obtain owner information about non-ECS servers, so you must manually configure AliUids after installing Logtail. Otherwise, Logtail heartbeats become abnormal or Logtail cannot collect logs. For details about how to configure AliUids, see Configure AliUids for ECS servers under other Alibaba Cloud accounts and on-premises IDCs.
To install Logtail, choose the required installation parameter and run the installation command. Specifically, you need to choose the correct parameter from the installation parameter table, replace
${your_region_name} with the required parameter, and run the following installation command:
Note In the installation command,
${your_region_name} indicates the region to which the Log Service project belongs. For example, the installation parameter for the China (Hangzhou) region is
cn-hangzhou.
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}-internet
Alternatively, after confirming the region to which the Log Service project belongs, you can run the corresponding installation command listed in the following table to install Logtail:
| Region | Installation command |
|---|---|
| China (Hangzhou) | |
| China (Shanghai) | |
| China (Qingdao) | |
| China (Beijing) | |
| China (Zhangjiakou) | |
| China (Hohhot) | |
| China (Shenzhen) | |
| China (Chengdu) | |
| 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 with global acceleration enabled
If your server is deployed in an overseas on-premises IDC or provided by another cloud product vendor, data transfer through the Internet may be unstable or delayed. In this case, you can enable the global acceleration function. Global acceleration accelerates log collection with the help of Alibaba Cloud CND edge nodes and provides greater advantages in terms of data transfer effectiveness and network stability for log collection through the Internet.
To install Logtail, choose the required installation parameter and run the installation command. Specifically, you need to choose the correct parameter from the installation parameter table, replace
${your_region_name} with the required parameter, and run the following installation command:
Note In the installation command,
${your_region_name} indicates the region to which the Log Service project belongs. For example, the installation parameter for the China (Hangzhou) region is
cn-hangzhou.
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}-acceleration
Alternatively, after confirming the region to which the Log Service project belongs, you can run the corresponding installation command listed in the following table to install Logtail:
| Region | Installation command |
|---|---|
| China (Beijing) | |
| China (Qingdao) | |
| China (Hangzhou) | |
| China (Shanghai) | |
| China (Shenzhen) | |
| China (Zhangjiakou) | |
| China (Hohhot) | |
| China (Chengdu) | |
| 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
Logtail records version information in the
logtail_version field in the
/usr/local/ilogtail/app_info.json file. For example:
$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 installer (logtail.sh) to upgrade Logtail. The installer automatically chooses an appropriate upgrade method according to the Logtail settings.
Note During the upgrade, Logtail is stopped, and only necessary files are overwritten. The configuration file, the Checkpoint file, and all logs are retained.
Upgrade Logtail by running the following command:
# Download the Logtail installer.
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh
# Run the upgrade command.
sudo ./logtail.sh upgrade
Response:
# The upgrade succeeded.
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"
}
# The upgrade failed: The current version is the latest version.
[Error]: Already up to date.Manually start and stop Logtail
- Start Logtail as the admin user by running the following command:
/etc/init.d/ilogtaild start - Stop Logtail as the admin user by running the following command:
/etc/init.d/ilogtaild stop
Uninstall Logtail
Download the Logtail installer logtail.sh, and then uninstall Logtail by running the following command:
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh
chmod 755 logtail.sh; ./logtail.sh uninstall