Updated default recommended install locations for Promtail and Loki (#163)

Updated default recommended install locations for Promtail and Loki

---------

Co-authored-by: Donna-Marie Smith <[email protected]>

Author: Cortex-DMS

content/en/docs/2024.9/Guides/upgrade-observability/cloud/grafana/upgrade-promtail.md

@@ -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
@@ -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
@@ -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

content/en/docs/2024.9/Guides/upgrade-observability/on-premise/grafana/upgrade-loki.md

@@ -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
@@ -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
@@ -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.
@@ -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

content/en/docs/2024.9/Guides/upgrade-observability/on-premise/grafana/upgrade-promtail.md

@@ -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
@@ -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
@@ -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

content/en/docs/2024.9/getting-started/cloud/add-observability-to-innovation/Grafana/install-promtail/configure-promtail.md

@@ -23,7 +23,7 @@ This guide describes how to configure Promtail on the Application Server(s).
 ### Set the positions.yaml File Path
 
 1. Open the `promtail-local-config.yaml` configuration file, which is located in the folder alongside the `promtail-windows-amd64.exe` file.
-1. Set the `filename` in the `positions` section to the location where you want the `positions.yaml` file to be created on Promtail startup.
+1. Set the `filename` in the `positions` section to the location where you want the `positions.yaml` file to be created on Promtail startup, e.g. `C:/Program Data/Cortex/Observability/Promtail/Positions.yaml`.
 1. Create all the folders of the path specified in the previous step.
 1. Save the file.
 

content/en/docs/2024.9/getting-started/cloud/add-observability-to-innovation/Grafana/install-promtail/install-promtail.md

@@ -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?

content/en/docs/2024.9/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md

@@ -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.
 

content/en/docs/2024.9/getting-started/on-premise/add-observability-to-innovation/Grafana/install-promtail/configure-promtail.md

@@ -49,7 +49,7 @@ To import the CA certificate:
 ### Set the positions.yaml File Path
 
 1. Open the `promtail-local-config.yaml` configuration file, which is located in the folder alongside the `promtail-windows-amd64.exe` file.
-1. Set the `filename` in the `positions` section to the location where you want the `positions.yaml` file to be created on Promtail startup.
+1. Set the `filename` in the `positions` section to the location where you want the `positions.yaml` file to be created on Promtail startup, e.g. `C:/Program Data/Cortex/Observability/Promtail/Positions.yaml`.
 1. Create all the folders of the path specified in the previous step.
 1. Save the file.
 

content/en/docs/2024.9/getting-started/on-premise/add-observability-to-innovation/Grafana/install-promtail/install-promtail.md

@@ -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?