This topic describes how to install Logtail on a Windows server.

Prerequisites

  1. At least one server is available.
  2. 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 Windows servers:

  • Windows 7 (Client) 32bit
  • Windows 7 (Client) 64bit
  • Windows Server 2008 32bit
  • Windows Server 2008 64bit
  • Windows Server 2012 64bit
  • Windows Server 2016 64bit

Install Logtail

  1. Download the Logtail installation package.
  2. Decompress the logtail_installer.zip package to the current directory.
  3. Run the installation command based on the network type and the region where the Log Service project is located.

    Open Windows PowerShell or Command Prompt as an administrator. Switch to the logtail_installer directory, and then run the installation command. The following table lists the installation command that corresponds to each network type and region.

    Region Alibaba Cloud internal network Public network Global Acceleration
    China (Qingdao) .\logtail_installer.exe install cn-qingdao .\logtail_installer.exe install cn-qingdao-internet .\logtail_installer.exe install cn-qingdao-acceleration
    China (Beijing) .\logtail_installer.exe install cn-beijing .\logtail_installer.exe install cn-beijing-internet .\logtail_installer.exe install cn-beijing-acceleration
    China (Zhangjiakou-Beijing Winter Olympics) .\logtail_installer.exe install cn-zhangjiakou .\logtail_installer.exe install cn-zhangjiakou-internet .\logtail_installer.exe install cn-zhangjiakou-acceleration
    China (Hohhot) .\logtail_installer.exe install cn-huhehaote .\logtail_installer.exe install cn-huhehaote-internet .\logtail_installer.exe install cn-huhehaote-acceleration
    China (Hangzhou) .\logtail_installer.exe install cn-hangzhou .\logtail_installer.exe install cn-hangzhou-internet .\logtail_installer.exe install cn-hangzhou-acceleration
    China (Shanghai) .\logtail_installer.exe install cn-shanghai .\logtail_installer.exe install cn-shanghai-internet .\logtail_installer.exe install cn-shanghai-acceleration
    China (Shenzhen) .\logtail_installer.exe install cn-shenzhen .\logtail_installer.exe install cn-shenzhen-internet .\logtail_installer.exe install cn-shenzhen-acceleration
    China (Chengdu) .\logtail_installer.exe install cn-chengdu .\logtail_installer.exe install cn-chengdu-internet .\logtail_installer.exe install cn-chengdu-acceleration
    China (Hong Kong) .\logtail_installer.exe install cn-hongkong .\logtail_installer.exe install cn-hongkong-internet .\logtail_installer.exe install cn-hongkong-acceleration
    US (Silicon Valley) .\logtail_installer.exe install us-west-1 .\logtail_installer.exe install us-west-1-internet .\logtail_installer.exe install us-west-1-acceleration
    US (Virginia) .\logtail_installer.exe install us-east-1 .\logtail_installer.exe install us-east-1-internet .\logtail_installer.exe install us-east-1-acceleration
    Singapore .\logtail_installer.exe install ap-southeast-1 .\logtail_installer.exe install ap-southeast-1-internet .\logtail_installer.exe install ap-southeast-1-acceleration
    Australia (Sydney) .\logtail_installer.exe install ap-southeast-2 .\logtail_installer.exe install ap-southeast-2-internet .\logtail_installer.exe install ap-southeast-2-acceleration
    Malaysia (Kuala Lumpur) .\logtail_installer.exe install ap-southeast-3 .\logtail_installer.exe install ap-southeast-3-internet .\logtail_installer.exe install ap-southeast-3-acceleration
    Indonesia (Jakarta) .\logtail_installer.exe install ap-southeast-5 .\logtail_installer.exe install ap-southeast-5-internet .\logtail_installer.exe install ap-southeast-5-acceleration
    India (Mumbai) .\logtail_installer.exe install ap-south-1 .\logtail_installer.exe install ap-south-1-internet .\logtail_installer.exe install ap-south-1-acceleration
    Japan (Tokyo) .\logtail_installer.exe install ap-northeast-1 .\logtail_installer.exe install ap-northeast-1-internet .\logtail_installer.exe install ap-northeast-1-acceleration
    Germany (Frankfurt) .\logtail_installer.exe install eu-central-1 .\logtail_installer.exe install eu-central-1-internet .\logtail_installer.exe install eu-central-1-acceleration
    UAE (Dubai) .\logtail_installer.exe install me-east-1 .\logtail_installer.exe install me-east-1-internet .\logtail_installer.exe install me-east-1-acceleration
    UK (London) .\logtail_installer.exe install eu-west-1 .\logtail_installer.exe install eu-west-1-internet .\logtail_installer.exe install eu-west-1-acceleration
    Note Log Service cannot obtain the information about the owner Alibaba Cloud account of an ECS instance that does not belong to the current Alibaba Cloud account. In addition, Log Service cannot obtain the information about cloud service providers of third-party cloud servers or on-premises servers. For more information, see Configure an account ID for a server.

Installation path

After you run the installation command, Logtail is installed in the following path by default. The path cannot be modified.
  • 32-bit Windows: C:\Program Files\Alibaba\Logtail
  • 64-bit Windows: C:\Program Files (x86)\Alibaba\Logtail
Note You can run 32-bit and 64-bit applications in a 64-bit Windows operating system. However, the operating system stores 32-bit applications in separate x86 folders to ensure compatibility.

Logtail for Windows is a 32-bit application. Therefore, it is installed in the Program Files (x86) folder in 64-bit Windows. If Logtail for 64-bit Windows becomes available in the future, Logtail will be installed in the Program Files folder.

View the version of Logtail

Find and open the app_info.json file in the installation directory. The logtail_version field shows the version of Logtail.

In the following example, the version of Logtail is 1.0.0.0: 
{
    "logtail_version" : "1.0.0.0"
}

Upgrade Logtail

  • Automatic upgrade

    Logtail for Windows supports automatic upgrade. However, Logtail earlier than V1.0.0.0 must be manually upgraded.

  • Manual upgrade

    You can follow the procedure of Logtail installation to manually upgrade Logtail. You only need to download and decompress the latest installation package, and then install Logtail. For more information, see Install Logtail.

    Note During manual upgrade, the files in the original installation directory are deleted. We recommend that you back up the files before you perform manual upgrade.

Start and stop Logtail

  1. Choose Start Menu > Control Panel > Administrative Tools > Services.
  2. In the Services window, select the required service.
    • For Logtail V0.x.x.x, select LogtailWorker.
    • For Logtail V1.0.0.0 and later, select LogtailDaemon.
  3. You can right-click the corresponding service and select Start, Stop or Restart from the shortcut menu.

Uninstall Logtail

Run Windows PowerShell or Command Prompt as an administrator. Switch to the logtail_installer directory, and then run the following command: 
.\logtail_installer.exe uninstall

After Logtail is uninstalled, the directory where Logtail is installed is deleted. However, some residual configuration data is retained in the C:\LogtailData directory. You can manually delete the data. The residual configuration data includes the following information:

  • checkpoint: contains checkpoints of all plug-ins, such as the Windows Event Log.
  • logtail_check_point: contains checkpoints of Logtail.
  • users: contains Alibaba Cloud account IDs.