Linux 

Supported systems 

Logtail supports the Linux x86-64 (64 bit) servers in the following releases: 

• Aliyun Linux 
• Ubuntu 
• Debian 
• CentOS 
• OpenSUSE

Install Logtail 

Install Logtail in overwrite mode. If you have installed Logtail before, the installer uninstalls the Logtail and deletes the /usr/local/ilogtail directory  before installing Logtail.  By default, Logtail is started after the installation and at startup. 

Download the installer based on the network environment of your machine and the region of Log Service. Select different parameters for installation. 

Follow the steps in Installation method of this document to install Logtail.  If the installation fails, open a ticket.

Installation method 

To install Logtail, download and run the installation script. You must select the installation parameters based on the region and network type.

Installation parameters 

	Note
	To install Logtail in Docker or Kubernetes, the ${your_region_name} is the parameter in the following table.  Copy the corresponding installation statement directly.

The installation parameters for different regions and network types are as follows (we recommend that you copy the corresponding installation statement directly). 

ECS instances of classic network 

Data is written to Log Service by means of the Alibaba Cloud intranet without consuming Internet bandwidth,  which is applicable to Alibaba Cloud Elastic Compute Service (ECS) instances.

• Note: By default, newly created ECS instances in new regions (such as overseas regions) are of Virtual Private Cloud (VPC). See ECS instances of VPC in this document.
• China North  2 (Beijing)

  wget http://logtail-release-bj.oss-cn-beijing-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-beijing 

• China North  1 (Qingdao)

  wget http://logtail-release-qd.oss-cn-qingdao-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-qingdao

• China East 1 (Hangzhou)

  wget http://logtail-release.oss-cn-hangzhou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hangzhou

• China East 2 (Shanghai)

  wget http://logtail-release-sh.oss-cn-shanghai-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shanghai 

• China South  1 (Shenzhen) 

  wget http://logtail-release-sz.oss-cn-shenzhen-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shenzhen

• China North 3  (Zhangjianchou)

  wget http://logtail-release-zjk.oss-cn-zhangjiakou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-zhangjiakou

• China North 5 (Huhehaote)

  wget http://logtail-release-huhehaote.oss-cn-huhehaote-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-huhehaote 

• Hong Kong (China) 

  wget http://logtail-release-hk.oss-cn-hongkong-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hongkong 

• US West 1  (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; sh logtail.sh install us-west-1 

• Asia Pacific SE 1  (Singapore)

  wget http://logtail-release-ap-southeast-1.oss-ap-southeast-1-internal.aliyuncs.com/linux64/logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-1

• Asia Pacific SE 2  (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; sh logtail.sh install ap-southeast-2

• Asia Pacific SE 3  (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; sh logtail.sh install ap-southeast-3

• Asia Pacific NE 1  (Japan)

  wget http://logtail-release-ap-northeast-1.oss-ap-northeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-northeast-1

• EU Central 1  (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; sh logtail.sh install eu-central-1

• Middle East 1  (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; sh logtail.sh install me-east-1 

ECS instances of VPC 

Data is written to Log Service by means of Alibaba Cloud VPC,  which is applicable to Alibaba Cloud ECS instances of VPC.

• China North  2 (Beijing) 

  wget http://logtail-release-bj.vpc100-oss-cn-beijing.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-beijing_vpc 

• China North 1 (Qingdao) 

  wget http://logtail-release-qd.vpc100-oss-cn-qingdao.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-qingdao_vpc 

• China East 1 (Hangzhou) 

  wget http://logtail-release.vpc100-oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hangzhou_vpc 

• China East 2 (Shanghai)

  wget http://logtail-release-sh.vpc100-oss-cn-shanghai.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shanghai_vpc

• China South 1 (Shenzhen) 

  wget http://logtail-release-sz.vpc100-oss-cn-shenzhen.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shenzhen_vpc 

• China North 3 (Zhangjianchou)

  wget http://logtail-release-zjk.oss-cn-zhangjiakou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-zhangjiakou_vpc

• China North 5 (Huhehaote)

  wget http://logtail-release-huhehaote.oss-cn-huhehaote-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-huhehaote

• China (Chengdu) 

  wget http://logtail-release-cn-chengdu.oss-cn-chengdu-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-chengdu

• Hong Kong (China)

  wget http://logtail-release-hk.vpc100-oss-cn-hongkong.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hongkong_vpc 

• US West 1 (Silicon Valley) 

  wget http://logtail-release-us-west-1.vpc100-oss-us-west-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install us-west-1_vpc 

• US East 1  (Virginia) 

  wget http://logtail-release-us-east-1.vpc100-oss-us-east-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install us-east-1 

• Asia Pacific SE 1 (Singapore) 

  wget http://logtail-release-ap-southeast-1.vpc100-oss-ap-southeast-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-1_vpc 

• Asia Pacific SE 2 (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; sh logtail.sh install ap-southeast-2_vpc 

• Asia Pacific SE 3 (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; sh logtail.sh install ap-southeast-3

• Asia Pacific SE 5  (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; sh logtail.sh install ap-southeast-5 

• Asia Pacific NE 1  (Japan) 

  wget http://logtail-release-ap-northeast-1.oss-ap-northeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-northeast-1_vpc 

• EU Central 1 (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; sh logtail.sh install eu-central-1_vpc 

• Middle East 1 (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; sh logtail.sh install me-east-1_vpc 

• Asia Pacific SOU 1  (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; sh logtail.sh install ap-south-1 

Internet (self-built IDCs or other cloud hosts)

Data is written to Log Service by means of Internet, which occupies Internet bandwidth  and is applicable to non-Alibaba Cloud virtual machines or other IDCs.

Note

Log Service cannot obtain the owner information of non-Alibaba Cloud machines. Therefore, you must manually configure the user identification after installing Logtail. For more information, see Configure a user identity for non-Alibaba Cloud ECS instances.  Collect logs from non-Alibaba Cloud ECS instances or ECS instances not in your accountOtherwise,  Logtail has abnormal heartbeat and cannot collect logs.

ECS instances of financial cloud

View 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"
}

Update Logtail

The procedure of updating Logtail is the same as that of installing Logtail. When you update the Logtail, the Logtail is automatically uninstalled first and then the latest version of Logtail is installed.

Manually start and stop Logtail

Uninstall Logtail

Download the installer logtail.sh. For more information, see Install Logtail  in this document.   Run the following command as an administrator in shell mode: 

wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh uninstall