This article applies to multinode environments made of Enterprise Terminal Servers or any of the Cloud Servers plus their nodes either version 7 and 8.

Due to changes introduced in packages v8.12 it's strictly necessary to update the nodes before and then the server, possibly all in once.

This is because NoMachine packages v8.12 provide OpenSSL libraries v3.0, which replace OpenSSL libraries version 1.1.1w previously used. Node version not aligned to server version could introduce incompatibilities since the context of the two SSL versions differs, in particular when the node of a Cloud Server has been added in inverse mode, with communication established from node to server.

Procedure for v8 is detailed here: https://kb.nomachine.com/DT07S00234.

The same applies also to branch v7 and updates to v7.15 or later.

If you plan to upgrade from v7  to v8, be sure to upgrade before to v7.15 or newer v7.

Instructions for failover cluster setup

Be sure to shutdown the secondary server and the primary server (preferably in this order) before to proceed with the upgrade.

Click on 'Shut down the server' in the Settings -> Server -> Status panel of the NoMachine User Interface or run from a terminal on Linux and macOS:
sudo /etc/NX/nxserver --shutdown

or from CMD console run as administrator on Windows (for Cloud Servers only):
%ALLUSERSPROFILE%\NoMachine\nxserver\nxserver.exe --shutdown

The upgrade will take care of starting all the needed services.

Detailed instructions to upgrade are available here:

-How to upgrade from Enterprise Terminal Server v7 with failover cluster to Enterprise Terminal Server Cluster v8
https://kb.nomachine.com/AR11T01180
- How to upgrade from Cloud Server v7 with failover cluster to Enterprise Cloud Server Cluster v8
https://kb.nomachine.com/AR03U01194

Then upgrade the last version 7 to v8.

In case of questions, please contact the Support Team.