Installation script
Stack
The installation script, install-service-heartbeat.ps1 is responsible
for creating the Windows Service for Heartbeat. Starting in 9.0.6, the
base folder has changed from C:\ProgramData\ to C:\Program Files\
because the latter has stricter permissions, therefore the home path
(base for state and logs) is now C:\Program Files\Heartbeat-Data.
The install script (install-service-heartbeat.ps1) will check whether
C:\ProgramData\Heartbeat exits and attempt to move it to C:\Program Files\Heartbeat-Data.
If an error occurs, the script will stop and print the error.
Then it will create the Windows Service setting:
path.homeas$env:ProgramFiles\Heartbeat-Datapath.logsas$env:ProgramFiles\Heartbeat-Data\logs
The script also supports passing the parameter -ForceLegacyPath to
use the old default C:\ProgramData\ that is set using
$env:PROGRAMDATA. However using -ForceLegacyPath is not
recommended.
In a PowerShell prompt, can use Get-Help install-service-heartbeat.ps1 -detailed to get detailed help.
If there is a permission error when the installation script is moving the folder, ensure the user running the script has enough permissions to do so. If the problem persists, the folder can be moved manually, then the installation script can be executed again.