Upgrade guide¶
Quickstream connection incompatibility
Quickstream connection type in Quickstream Node v4 and newer is incompatible with Quickstream Node v2 and v3!! If you are using Quickstream as a connection type in your existing environment please contact our support.
Upgrading Quickstream Node is a very straightforward process. The upgrade procedure is different on Windows and Linux-based operating systems. Before performing an upgrade do some preparations:
- Notify your clients/partners about planned maintenance. Upgrade causes a short break in Quickstream Node transmission.
- Read changelogs and release notes before upgrade
- Make sure your system is still supported. We do not delete old packages so your Node will not upgrade if it is installed on an unsupported operating system. Windows version of Quickstream Node may be installed on an unsupported operating system but may not work properly.
- Perform backup of your configuration. Please refer to Backing up Quickstream for more information.
Upgrading Quickstream Node on Linux-based operating systems¶
Superuser permissions required
All commands must be run as superuser. It is usually called root. You can skip sudo in all commands if you are logged as superuser.
Blocking packages from accidental upgrade
If you want to protect Quickstream Node from accidental upgrade you can hold all quickstream-*
packages using the following command:
To un-protect Quickstream Node use the following command:
Update your apt
cache index. Please note that this command will NOT update your system. It will only update cache index.
Upgrade Quickstream Node package. This command will ONLY upgrade Quickstream Node and its dependencies.
Check if the service is running and check if you can manage your Node using Quickstream Cloud or Quickstream Client.
Output should look like this.
● quickstream-node.service - Quickstream Node server
Loaded: loaded (/lib/systemd/system/quickstream-node.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2022-07-02 06:16:21 CEST; 2 days ago
Process: 919 ExecStart=/opt/quickstream/bin/qs-node --start-daemon (code=exited, status=0/SUCCESS)
Main PID: 959 (qs-node)
Tasks: 9 (limit: 38247)
Memory: 179.9M
CPU: 1h 2min 3.746s
CGroup: /system.slice/quickstream-node.service
├─ 959 /opt/quickstream/bin/qs-node --start-daemon
└─2225 /opt/quickstream/bin/qs-engine channelId 1
Upgrading Quickstream Node on Windows¶
Download the latest Quickstream Node installation from our download site. Then run the downloaded file.
If Defender's SmartScreen prevents you from running the installer click on More info
and then on Run anyway
.
Then simply follow the instructions.
After installation check, if Quickstream Node is running in services.msc
. Please note that Quickstream Node is a headless application.
Check if Quickstream Node Setup application is working. This application is not required for Quickstream to work. It is used for initial configuration and for status reporting.