Use Windows Service for flow runtime

Prerequisites

• You have a flow runtime running as a Windows service

• You have started a Windows PowerShell session with Administrator privileges.

If you are using the installer for version >= 2.5.0, scripting must be enabled in PowerShell for scripts downloaded from the Internet. You can check your current execution policy with the following command:

Get-ExecutionPolicy

Make sure it is one of the following: RemoteSigned, UnRestricted or Bypass. If not, use the following command to change it:

Set-ExecutionPolicy -Scope Process RemoteSigned

1. Backup the data folder

The data folder contains all relevant settings for the flow runtime such as credentials, resources, flows and more. Create a backup of the data folder from your local disk, we will need this later.

2. Uninstall the current version

2.1 If current version is >= 2.5.0

PowerShell version 6 and above

Stop the edge node service with:

Stop-Service -Name CrosserEdgeNode.Service

Uninstall the previous version with:

Remove-Service -Name Flows-EdgeNode.Service

PowerShell version 5 and previous

Stop the edge node service with:

sc.exe stop Flows.EdgeNode.Service

Uninstall the previous version with:

sc.exe delete Flows.EdgeNode.Service

2.2 If current version is <2.5.0

Go to the directory where you have the Flows.EdgeNode.Service.Windows executable.

Stop the flow runtime service using:

Flows.EdgeNode.Service.Windows stop

Uninstall the old version with:

Flows.EdgeNode.Service.Windows uninstall

3. Download the installer for the new version

1. Login to flow manager.

2. Download the Windows installer for the version you want to install from Manage -> Flow runtime-> Settings icon-> Windows Installation tab.

3. Download and unzip it into an empty directory on your local host. For example: c:\Flows

4. Install flow runtime as a Windows service

4. Restore the backed up data folder into the new setup path, for example: C:\Flows\WinService\Host

5. Open Powershell with administrative permission and navigate to the WinService folder, C:\Flows\WinService\

6. Run the installation script with

   .\InstallWindowsService.ps1

7. When you are asked for the NodeId and AccessKey, just press Enter. The installer will recognize the credentials from the restored backup.

8. At the prompt, type run to start the new flow runtime version and any deployed flows. The new version installs.

9. The new version should now be up and running and with the correct version number on the Flow runtime page in Flow manager.