Simple Log Service:Install Logtail on a Windows server

Install Logtail

1. Log on to your server.

2. Download an installation package based on your business requirements.

   • Regions in China

     • 32-bit Windows: Logtail installation package

     • 64-bit Windows: Logtail installation package

   • Regions outside China

     • 32-bit Windows: Logtail installation package

     • 64-bit Windows: Logtail installation package

3. Decompress the logtail_installer.zip package to the current directory.

4. Select an installation command based on the network type and the region where your Simple Log Service project resides, and run the installation command.

   Network type	Scenario
   Alibaba Cloud internal network	The Elastic Compute Service (ECS) instance that is used and your Simple Log Service project reside in the same region.
   Internet	The ECS instance that is used and your Simple Log Service project reside in different regions. The server that is used is provided by a third-party cloud service provider or deployed in a self-managed data center.
   Global acceleration	The server that is used is provided by a third-party cloud service provider outside China or deployed in a self-managed data center outside China. Data transfer over the Internet may cause high network latency and unstable connections. In this case, we recommend that you use global acceleration to transfer data.

   Alibaba Cloud internal network (the classic network or a VPC)

   1. Run Windows PowerShell or Command Prompt as an administrator. Go to the logtail_installer directory, which contains the files extracted from the installation package.

   2. Obtain the value of the ${your_region_name} variable for the region where your Simple Log Service project resides.

      For more information about the value of the ${your_region_name} variable for each region, see Appendix: Region names for Logtail installation. For example, the value of the ${your_region_name} variable for the China (Hangzhou) region is cn-hangzhou.

   3. Replace the ${your_region_name} variable in the installation command with the value for the region where your project resides, and then run the installation command.

      .\logtail_installer.exe install ${your_region_name}

   Internet

   1. Run Windows PowerShell or Command Prompt as an administrator. Go to the logtail_installer directory, which contains the files extracted from the installation package.

   2. Obtain the value of the ${your_region_name} variable for the region where your Simple Log Service project resides.

      For more information about the value of the ${your_region_name} variable for each region, see Appendix: Region names for Logtail installation. For example, the value of the ${your_region_name} variable for the China (Hangzhou) region is cn-hangzhou.

   3. Replace the ${your_region_name} variable in the installation command with the value for the region where your project resides, and then run the installation command.

      .\logtail_installer.exe install ${your_region_name}-internet

   Global acceleration

   1. Run Windows PowerShell or Command Prompt as an administrator. Go to the logtail_installer directory, which contains the files extracted from the installation package.

   2. Obtain the value of the ${your_region_name} variable for the region where your Simple Log Service project resides.

      For more information about the value of the ${your_region_name} variable for each region, see Appendix: Region names for Logtail installation. For example, the value of the ${your_region_name} variable for the China (Hangzhou) region is cn-hangzhou.

   3. Replace the ${your_region_name} variable in the installation command with the value for the region where your project resides, and then run the installation command.

      .\logtail_installer.exe install ${your_region_name}-acceleration

      Important

      If your project resides in a region of Alibaba Finance Cloud, you cannot install Logtail by running an installation command that is suitable for global acceleration.

5. View the installation path.

   Important

   After you run the installation command, Logtail is automatically installed. The installation path varies based on the operating system. You cannot change the installation path.

   • Logtail for 32-bit Windows

     • In 32-bit Windows, Logtail is installed in the C:\Program Files\Alibaba\Logtail directory.

     • In 64-bit Windows, Logtail is installed in the C:\Program Files (x86)\Alibaba\Logtail directory.

       Note

       You can run 32-bit and 64-bit applications in 64-bit Windows. To ensure compatibility, the operating system stores 32-bit applications in a separate x86 directory.

   • Logtail for 64-bit Windows

     You can install Logtail for 64-bit Windows only in 64-bit Windows. The installation path is C:\Program Files\Alibaba\Logtail.

View the status and version of Logtail

After Logtail is installed on your server, you can view the status and version of Logtail.

{
    "logtail_version" : "1.0.0.0"
}

Update Logtail

Start and stop Logtail

1. Log on to your server.

2. Choose Start Menu > Control Panel > Administrative Tools > Services.

3. In the Services dialog box, select the service that you want to manage.

   • For Logtail V0.x.x.x, select LogtailWorker.

   • For Logtail V1.0.0.0 or later, select LogtailDaemon.

4. Right-click the service and select Start, Stop, or Restart.

Uninstall Logtail

.\logtail_installer.exe uninstall

After Logtail is uninstalled, the Logtail installation directory is deleted. However, some configuration files are retained in the C:\LogtailData directory. You can manually delete the files based on your business requirements. The following configuration files are retained:

• checkpoint: contains information about the checkpoints that are generated by Logtail plug-ins. This file is generated only if Logtail plug-ins are used.

• user_config.d: contains local collection configurations.

  JSON files are considered collection configurations. For example, /usr/local/ilogtail/user_log_config.json is considered a collection configuration.

• logtail_check_point: contains information about the checkpoints that are generated by Logtail.

• users: contains the user identifier files that are configured.