Update Node version

The procedure to update a Node depends on the installation environment, follow the steps in the appropriate section below.

Docker

Prerequisites

You have a Node running as a Docker container
There is a new version of the Node software available that you want to update to
You have remote access to the Node you want to upgrade

1. Login to docker.crosser.io

On the host where you want to run the Node type

[sudo] docker login https://registry.crosser.cloud

When prompted, enter the username and password which you find in Crosser Control Center.

2. Change node version

2.1 Use latest version

To update to the latest released version.

Edit your docker-compose.yml to use tag latest.

image: registry.crosser.cloud/node/edgenode:latest

Open a terminal and enter
```
[sudo] docker-compose pull
```
In the terminal, enter
```
[sudo] docker-compose up -d
```

2.2 Use specific version

To update to a specific version.

Edit your docker-compose.yml to use the version you want, e.g.
```
image: registry.crosser.cloud/node/edgenode:5.0.0
```
In the terminal, enter
```
[sudo] docker-compose up -d
```

Windows Service

Prerequisites

You have a Node running as a Windows service
You have a PowerShell running as Administrator

Note: 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:

Get-ExecutionPolicy

Make sure it’s one of 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 Node 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.2 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 Crosser-EdgeNode.Service

PowerShell version 5 and previous

Stop the edge node service with:
```
sc.exe stop Crosser.EdgeNode.Service
```
Uninstall the previous version with:
```
sc.exe delete Crosser.EdgeNode.Service
```

2.1 If current version is <2.5.0

Go to the directory where you have the Crosser.EdgeNode.Service.Windows executable.
Stop the edge node service using:
```
Crosser.EdgeNode.Service.Windows stop
```

Uninstall the old version with:

Crosser.EdgeNode.Service.Windows uninstall

3. Download the installer for the new version

Login to Crosser Control Center
Download the Windows installer for the version you want to install from Manage -> Nodes -> Register Nodes -> Advanced Settings and unzip it into an empty directory on your local host. E.g. C:\Crosser

4. Install Node as Windows Service

Restore your backed up data folder into the new setup path for e.g. C:\Crosser\WinService\Host
Open Powershell with administrative permission and navigate to the WinService folder, C:\Crosser\WinService\
Run the installation script with
```
.\InstallWindowsService.ps1
```
When you are asked for the NodeId and AccessKey, just press Enter. The installer will recognize the credentials from the restored backup.
At the prompt, type run to start the new node version and any deployed Flows.

New version installed!

The new version should now be up and running and you should see the correct version number on the Nodes page in Crosser Control Center.

Search Documentation

Page Sections