How to upgrade Enterprise Cloud Server Cluster v8 to Enterprise Cloud Server Cluster v9
NoMachine v9 introduces a new type of online license, but licenses on premises are still valid and there is no need to update or change the current license v8, if not expired.
Check the article for more information: How do NoMachine server licenses work in v9.
1. Plan a Server Downtime Period Before Upgrading
We suggest to send a broadcast message to all connected users to inform about ongoing operations as all sessions will be terminated.
For Linux and macOS:
$ sudo /etc/NX/nxserver --broadcast <message>
For Windows:
> %ALLUSERSPROFILE%\NoMachine\nxserver\nxserver.exe --broadcast <message>
2. Upgrade the NoMachine server v8 installed on each node to v9
Proceed to upgrade the installation on each of the remote nodes. Server v9 can work also with a license v8.
You can upgrade by installing a new package or via UI by means of the automatic updates from the NoMachine repositories.
Otherwise, upgrade from command line by running in a terminal the appropriate command.
For DEB:
$ sudo dpkg -i packageName.deb
For RPM:
$ sudo rpm -Uvh packageName.rpm
To put in place license v9 (server.lic) from command line:
$ sudo /etc/NX/nxserver --subscriptionset path_to_server.lic
To verify the installation:
$ /etc/NX/nxserver --version
$ sudo /etc/NX/nxserver --status
$ sudo /etc/NX/nxserver --subscriptioninfo
NOTE: It's possible to keep nodes v8 working with Cloud Server v9. This setup is however not recommended and should be considered as a temporary condition necessary to complete the upgrade to v9 of the whole multinode system.
3. Upgrade the cluster configuration v8 to v9
Proceed to upgrade the installation on the server hosts. We suggest to start from the primary server and then upgrade the secondary server to avoid the failover.
If you don’t plan to use the new NoMachine Network service there is no need to change the license.
Execute the command on both peers, remember to run it first on the primary server to avoid the failover
$ sudo /etc/NX/nxserver --shutdown
then proceed with the upgrade.You can upgrade by installing a new package or via UI by means of the automatic updates from the NoMachine repositories.
Otherwise, upgrade from command line by running in a terminal the appropriate command.
For DEB:
$ sudo dpkg -i packageName.deb
For RPM:
$ sudo rpm -Uvh packageName.rpm
To verify the installation:
$ /etc/NX/nxserver --version
$ sudo /etc/NX/nxserver --status
$ sudo /etc/NX/nxserver --subscriptioninfo
On the primary server run --clusteredit and set second shared IP for the secondary server:
/etc/NX/nxserver --clusteredit --slave second_shared_ip --load-balancing yes
Restart both servers on the cluster with:
nxserver --restart
Verify the status of NoMachine cluster with:
nxserver --clusterstatus
