Knowledge Base
Searching in : Article
ID: AR11V01257
Applies to: NoMachine Server
Added on: 2024-11-12
Last Update: 2025-05-28

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