Skip to content

Commit 7f84a1d

Browse files
author
Pat
authored
1.9: update windows packages (#746)
* windows: add 1.9 updates Signed-off-by: Patrick Stephens <[email protected]>
1 parent 31fe326 commit 7f84a1d

File tree

1 file changed

+30
-16
lines changed

1 file changed

+30
-16
lines changed

installation/windows.md

Lines changed: 30 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Windows
22

3-
Fluent Bit is distributed as **td-agent-bit** package for Windows. Fluent Bit has two flavours of Windows installers: a ZIP archive (for quick testing) and an EXE installer (for system installation).
3+
Fluent Bit is distributed as **fluent-bit** package for Windows.
4+
Fluent Bit has two flavours of Windows installers: a ZIP archive (for quick testing) and an EXE installer (for system installation).
45

56
## Configuration
67

7-
Currently the default configuration is intended for Linux only so will not function on Windows.
88
Make sure to provide a valid Windows configuration with the installation, a sample one is shown below:
99

1010
```
@@ -72,21 +72,27 @@ Make sure to provide a valid Windows configuration with the installation, a samp
7272
match *
7373
```
7474

75+
## Migration to Fluent Bit
76+
77+
From version 1.9.0, `td-agent-bit` is a deprecated package and will be removed in the future.
78+
The correct package name to use now is `fluent-bit`.
79+
Both are currently provided to allow migration.
80+
7581
## Installation Packages
7682

77-
The latest stable version is 1.8.11:
83+
The latest stable version is 1.9.0, each version is available on the Github release as well as at `https://fluentbit.io/releases/<Major Version>/Major>fluent-bit-<Full Version>-win[32|64].exe`:
7884

7985
| INSTALLERS | SHA256 CHECKSUMS |
8086
| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
81-
| [td-agent-bit-1.8.11-win32.exe](https://fluentbit.io/releases/1.8/td-agent-bit-1.8.11-win32.exe) | 3505e6086be311ab32a705d87eb4673497038e3818812d100dc26bb1d3754b46 |
82-
| [td-agent-bit-1.8.11-win32.zip](https://fluentbit.io/releases/1.8/td-agent-bit-1.8.11-win32.zip) | e20ab8be35091bfa061f126d186380670e656d8d675d3680df6fab9888788c8b |
83-
| [td-agent-bit-1.8.11-win64.exe](https://fluentbit.io/releases/1.8/td-agent-bit-1.8.11-win64.exe) | 2c0de0f776928de6a76877ef077ce2b3b5e7d0646b912266baadcfdb843be400 |
84-
| [td-agent-bit-1.8.11-win64.zip](https://fluentbit.io/releases/1.8/td-agent-bit-1.8.11-win64.zip) | 9e589d8ec7a24d8faa95d0eb6c0aac721c4b26e0a2a1c36a36f2559ebea1e404 |
87+
| [fluent-bit-1.9.0-win32.exe](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win32.exe) | [f6d690c8b123d6211398feb2acc1c9aae6d3d7539ddfeedd4460f170e5af35ab](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win32.exe.sha256) |
88+
| [fluent-bit-1.9.0-win32.zip](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win32.zip) | [8fddb14e68ada0b31214f41a21dcea2b217f00ab43eafcf10d711189278f0a8d](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win32.zip.sha256) |
89+
| [fluent-bit-1.9.0-win64.exe](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win64.exe) | [a1563bafc177bd7ea174646eb1dcd7951c681a84d63174b9b58c22b3a5ccd962](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win64.exe.sha256) |
90+
| [fluent-bit-1.9.0-win64.zip](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win64.zip) | [1ebec279178fb3d44aa067fd0dd1420833ae501849b1d77b7abe060ca18f162a](https://fluentbit.io/releases/1.9/fluent-bit-1.9.0-win64.zip.sha256) |
8591

8692
To check the integrity, use `Get-FileHash` cmdlet on PowerShell.
8793

8894
```
89-
PS> Get-FileHash td-agent-bit-1.8.11-win32.exe
95+
PS> Get-FileHash fluent-bit-1.9.0-win32.exe
9096
```
9197

9298
## Installing from ZIP archive
@@ -96,16 +102,17 @@ Download a ZIP archive from above. There are installers for 32-bit and 64-bit en
96102
Then you need to expand the ZIP archive. You can do this by clicking "Extract All" on Explorer, or if you're using PowerShell, you can use `Expand-Archive` cmdlet.
97103

98104
```
99-
PS> Expand-Archive td-agent-bit-1.8.11-win64.zip
105+
PS> Expand-Archive fluent-bit-1.9.0-win64.zip
100106
```
101107

102108
The ZIP package contains the following set of files.
103109

104110
```
105-
td-agent-bit
111+
fluent-bit
106112
├── bin
107113
│ ├── fluent-bit.dll
108114
│ └── fluent-bit.exe
115+
│ └── fluent-bit.pdb
109116
├── conf
110117
│ ├── fluent-bit.conf
111118
│ ├── parsers.conf
@@ -127,7 +134,7 @@ If you see the following output, it's working fine!
127134

128135
```
129136
PS> .\bin\fluent-bit.exe -i dummy -o stdout
130-
Fluent Bit v1.8.x
137+
Fluent Bit v1.9.x
131138
* Copyright (C) 2019-2020 The Fluent Bit Authors
132139
* Copyright (C) 2015-2018 Treasure Data
133140
* Fluent Bit is a CNCF sub-project under the umbrella of Fluentd
@@ -148,16 +155,20 @@ To halt the process, press CTRL-C in the terminal.
148155

149156
## Installing from EXE installer
150157

151-
Download an EXE installer from the [download page](https://fluentbit.io/download/). It has both 32-bit and 64-bit builds. Choose one which is suitable for you.
158+
Download an EXE installer from the [download page](https://fluentbit.io/download/).
159+
It has both 32-bit and 64-bit builds.
160+
Choose one which is suitable for you.
152161

153-
Then, double-click the EXE installer you've downloaded. Installation wizard will automatically start.
162+
Double-click the EXE installer you've downloaded.
163+
The installation wizard will automatically start.
154164

155165
![](<../.gitbook/assets/windows_installer (1) (1).png>)
156166

157-
Click Next and proceed. By default, Fluent Bit is installed into `C:\Program Files\td-agent-bit\`, so you should be able to launch fluent-bit as follow after installation.
167+
Click Next and proceed.
168+
By default, Fluent Bit is installed into `C:\Program Files\fluent-bit\`, so you should be able to launch fluent-bit as follows after installation.
158169

159170
```
160-
PS> C:\Program Files\td-agent-bit\bin\fluent-bit.exe -i dummy -o stdout
171+
PS> C:\Program Files\fluent-bit\bin\fluent-bit.exe -i dummy -o stdout
161172
```
162173

163174
### Installer options
@@ -184,9 +195,11 @@ C:\fluent-bit\
184195
├── conf
185196
│ ├── fluent-bit.conf
186197
│ └── parsers.conf
198+
│ └── plugins.conf
187199
└── bin
188200
├── fluent-bit.dll
189201
└── fluent-bit.exe
202+
└── fluent-bit.pdb
190203
```
191204

192205
To register Fluent Bit as a Windows service, you need to execute the following command on Command Prompt. Please be careful that a single space is required after `binpath=`.
@@ -220,7 +233,8 @@ To start Fluent Bit automatically on boot, execute the following:
220233

221234
### [FAQ] Fluent Bit fails to start up when installed under `C:\Program Files`
222235

223-
Quotations are required if file paths contain spaces. Here is an example:
236+
Quotations are required if file paths contain spaces.
237+
Here is an example:
224238

225239
```text
226240
% sc.exe create fluent-bit binpath= "\"C:\Program Files\fluent-bit\bin\fluent-bit.exe\" -c \"C:\Program Files\fluent-bit\conf\fluent-bit.conf\""

0 commit comments

Comments
 (0)