Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated default recommended install locations for Promtail and Loki #163

Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ These steps will need to be performed on all application servers that host a Pro

1. Log in to the application server.
1. Run Windows PowerShell as Administrator.
1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\Promtail`.
1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
1. Remove the current Promtail installation by executing the following command:

``` powershell
Expand All @@ -26,7 +26,7 @@ These steps will need to be performed on all application servers that host a Pro

1. Click *Yes* when prompted for confirmation that you wish to remove the service.
1. Click *OK* when the successful removal of the Promtail service is confirmed.
1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\Promtail`
1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`
1. Delete the following files from the directory:

* Install-Promtail.ps1
Expand All @@ -38,17 +38,17 @@ These steps will need to be performed on all application servers that host a Pro
* Stop-Promtail.ps1

1. In File Explorer, navigate to the extracted `promtail-windows-amd64.exe` folder created as part of [Make Artefacts Available][].
1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\Promtail`.
1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
1. In File Explorer, navigate to the extracted `Promtail.Install` folder created as part of [Make Artefacts Available][].
1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\Promtail`.
1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
1. Open `promtail-local-config.yaml` in a text editor:

* Update the *filename* property under *positions* to be the value found in the [backed up][] version.
* Update the *url* property under *clients* to be the value found in the [backed up][] version.
* Save the new `promtail-local-config.yaml` file.

1. Run Windows PowerShell as Administrator.
1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\Promtail`.
1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
1. Install Promtail by executing the following command:

``` powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This guide describes how to upgrade the Loki installation. Please ensure that th

1. Log in to the server hosting your Loki service.
1. Run Windows PowerShell as Administrator.
1. Change the directory to the folder where Loki is running from, e.g. `cd C:\Loki`.
1. Change the directory to the folder where Loki is running from, e.g. `cd C:\Program Data\Cortex\Observability\Loki`.
1. Remove the current Loki installation by executing the following command:

``` powershell
Expand All @@ -22,7 +22,7 @@ This guide describes how to upgrade the Loki installation. Please ensure that th

1. Click *Yes* when prompted for confirmation that you wish to remove the service.
1. Click *OK* when the successful removal of the Loki service is confirmed.
1. Open a File Explorer and navigate to the folder where Loki was running from, e.g. `C:\Loki`.
1. Open a File Explorer and navigate to the folder where Loki was running from, e.g. `C:\Program Data\Cortex\Observability\Loki`.
1. Delete the following files from the directory:

* Install-Loki.ps1
Expand All @@ -34,9 +34,9 @@ This guide describes how to upgrade the Loki installation. Please ensure that th
* Stop-Loki.ps1

1. In File Explorer, navigate to the extracted `loki-windows-amd64.exe` folder created as part of [Make Artefacts Available][].
1. Copy the `loki-windows-amd64.exe` file into the folder that Loki was previously running from, e.g. `C:\Loki`.
1. Copy the `loki-windows-amd64.exe` file into the folder that Loki was previously running from, e.g. `C:\Program Data\Cortex\Observability\Loki`.
1. In File Explorer, navigate to the extracted `Grafana.Loki.Install` folder created as part of [Make Artefacts Available][].
1. Copy the contents of this location into the folder that Loki was previously running from, e.g. `C:\Loki`.
1. Copy the contents of this location into the folder that Loki was previously running from, e.g. `C:\Program Data\Cortex\Observability\Loki`.
1. Open the new `loki-local-config.yaml` file in a text editor and compare against the [backed up][] version. If there are differences between the two files in the *schema_config* > *configs* section:

1. In the new file, change the date next to `- from` to be today's date.
Expand Down Expand Up @@ -66,7 +66,7 @@ This guide describes how to upgrade the Loki installation. Please ensure that th
1. Save the new `loki-local-config.yaml` file.

1. Run Windows PowerShell as Administrator.
1. Change the directory to the folder where the Loki files have been copied to, e.g. `cd C:\Loki`.
1. Change the directory to the folder where the Loki files have been copied to, e.g. `cd C:\Program Data\Cortex\Observability\Loki`.
1. Install Loki by executing the following command:

``` powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ These steps will need to be performed on all application servers that host a Pro

1. Log in to the application server.
1. Run Windows PowerShell as Administrator.
1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\Promtail`.
1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
1. Remove the current Promtail installation by executing the following command:

``` powershell
Expand All @@ -26,7 +26,7 @@ These steps will need to be performed on all application servers that host a Pro

1. Click *Yes* when prompted for confirmation that you wish to remove the service.
1. Click *OK* when the successful removal of the Promtail service is confirmed.
1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\Promtail`
1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`
1. Delete the following files from the directory:

* Install-Promtail.ps1
Expand All @@ -38,17 +38,17 @@ These steps will need to be performed on all application servers that host a Pro
* Stop-Promtail.ps1

1. In File Explorer, navigate to the extracted `promtail-windows-amd64.exe` folder created as part of [Make Artefacts Available][].
1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\Promtail`.
1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
1. In File Explorer, navigate to the extracted `Promtail.Install` folder created as part of [Make Artefacts Available][].
1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\Promtail`.
1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
1. Open the new `promtail-local-config.yaml` in a text editor:

* Update the *filename* property under *positions* to be the value found in the [backed up][] version.
* Update the *url* property under *clients* to be the value found in the [backed up][] version.
* Save the new `promtail-local-config.yaml` file.

1. Run Windows PowerShell as Administrator.
1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\Promtail`.
1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
1. Install Promtail by executing the following command:

``` powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ This guide describes how to install Promtail on the Application Server(s). Pleas
## Install Promtail

1. Download [Promtail 3.0.0][] archive.
1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Promtail`.
1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
1. Download the [Promtail Install.zip][] archive and extract its contents alongside the previously extracted Promtail `promtail-windows-amd64.exe`.
This archive contains the `promtail-local-config.yaml` configuration file, [NSSM][] (the Non-Sucking Service Manager program) and PowerShell scripts to help manage Promtail as a Windows service.
1. Run Windows PowerShell as Administrator
1. Change the location to where all the files were extracted to.
1. Change the location to where all the files were extracted to in step 2, e.g. `cd "C:\Program Data\Cortex\Observability\Promtail"`.
1. Execute the `.\Install-Promtail.ps1` command to install the downloaded `promtail-windows-amd64.exe` as a service.

## Next Steps?
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ This guide describes how to install Grafana Loki on the Web Application Server.
## Install Grafana Loki

1. Download [Grafana Loki 3.0.0][] archive.
1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Loki`.
1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Program Data\Cortex\Observability\Loki`.
1. Download the [Grafana Loki Install.zip][] archive and extract its contents alongside the previously extracted Grafana Loki `loki-windows-amd64.exe`.
This archive contains the `loki-local-config.yaml` configuration file, [NSSM][] (the Non-Sucking Service Manager program) and PowerShell scripts to help manage Grafana Loki as a Windows service.
1. Run Windows PowerShell as Administrator.
1. Change the location to where all the files were extracted to.
1. Change the location to where all the files were extracted to in step 2, e.g. `cd "C:\Program Data\Cortex\Observability\Loki"`.
1. Execute the `.\Install-Loki.ps1` command to install the downloaded Grafana Loki `loki-windows-amd64.exe` as a service.
1. Execute the `.\Start-Loki.ps1` command to start the Grafana Loki service.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ This guide describes how to install Promtail on the Application Server(s). Pleas
## Install Promtail

1. Download [Promtail 3.0.0][] archive.
1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Promtail`.
1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
1. Download the [Promtail Install.zip][] archive and extract its contents alongside the previously extracted Promtail `promtail-windows-amd64.exe`.
This archive contains the `promtail-local-config.yaml` configuration file, [NSSM][] (the Non-Sucking Service Manager program) and PowerShell scripts to help manage Promtail as a Windows service.
1. Run Windows PowerShell as Administrator
1. Change the location to where all the files were extracted to.
1. Change the location to where all the files were extracted to in step 2, e.g. `cd "C:\Program Data\Cortex\Observability\Promtail"`.
1. Execute the `.\Install-Promtail.ps1` command to install the downloaded `promtail-windows-amd64.exe` as a service.

## Next Steps?
Expand Down
Loading