Knowledge Base
Searching in : Article
ID: AR03U01194
Applies to: NoMachine Server
Added on: 2023-03-21
Last Update: 2023-03-24

How to upgrade from Cloud Server v7 with failover cluster to Enterprise Cloud Server Cluster v8

A new license v8 is needed to upgrade from Cloud Server v7 with failover cluster enabled to Enterprise Cloud Server Cluster v8. Contact Sales to switch your license v7 to v8 or acquire a license v8.

1. Plan a Server Downtime Period Before Upgrading
We suggest to do the following before proceeding with the upgrade.
Step 1 (optional)- Send a broadcast message to all connected users to inform about ongoing operations.
Step 2 (optional)- Stop the main server
This will prevent new connections to the main server but will not terminate running sessions.

2. Upgrade the NoMachine server v7 installed on each node to v8
Proceed to upgrade the installation on each of the remote nodes. See the following article to see if the server v8 requires a new license v8 or can work with license v7: https://kb.nomachine.com/AR12S01147.

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 v8 (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 v7 working with cloud server v8.. This setup is however not recommended and should be considered as a temporary condition necessary to complete the upgrade to v8 of the whole multinode system.

3. Upgrade the Cloud Server v7 to Enterprise Cloud Server Cluster v8
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.

You will then need to apply the license (server.lic) for Enterprise Cloud Server Cluster v8. Contact Sales if you don't have it yet and before proceeding with the upgrade.

Shut down the server:
$ sudo /etc/NX/nxserver --shutdown

Put in place the license v8:
$ sudo cp  ECSC_server.lic /usr/NX/etc/server.lic

and set proper ownership and permissions:
$ sudo chown nx:root /usr/NX/etc/server.lic
$ sudo chmod 0400 /usr/NX/etc/server.lic

 

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