Knowledge Base
Searching in : Article
ID: AR11T01180
Applies to: NoMachine Server
Added on: 2022-11-25
Last Update: 2024-08-14

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

Upgrading from Enterprise Terminal Server v7 with failover cluster to Enterprise Terminal Server Cluster v8 requires to upgrade also the license. Please contact the Sales or the Support Team for that before proceeding with the upgrade.

Upgrading of the Terminal Server Node v7 to Enterprise Terminal Server Node v8 doesn't strictly requires to upgrade the license, but it's recommended for sake of consistency.

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 Terminal Server Node v7 to Enterprise Terminal Server Node v8
Proceed to upgrade the installation on each of the remote nodes. Then upgrade the license on each node.

Nodes can be upgraded in multiple steps.

Upgrading the node will terminate all running sessions on that node. If you're upgrading from remote, the connection to the node will be lost.

You can upgrade by installing a new package or via UI by means of the automatic updates from the NoMachine repositories.

To upgrade from command line by package, run in a terminal the appropriate command. This can be done also from remote, in a SSH terminal.

For DEB:
$ sudo dpkg -i packageName.deb
For RPM:
$ sudo rpm -Uvh packageName.rpm

You can install the Enterprise Terminal Server Node license file v8 (server.lic) via UI or from command line in a terminal:
$ 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

3. Upgrade the Enterprise Terminal Server v7 to Enterprise Terminal Server Cluster v8

A license (server.lic) for Enterprise Terminal Server Cluster v8 is necessary. Contact Sales if you don't have it yet and before proceeding with the upgrade.

All instructions from command line must be done in a terminal (also a remote SSH terminal).

Shut down the secondary server and then the primary server to avoid the failover:
$ sudo /etc/NX/nxserver --shutdown

Upload the new new license (server.lic) an install it via UI or from command line:
$ sudo cp  ETSC_server.lic  /usr/NX/etc/server.lic

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 of the primary server, you can upgrade by installing a new package or via UI by automatic updates.

To upgrade from command line by package, run the appropriate command.

For DEB:
$ sudo dpkg -i packageName.deb
For RPM:
$ sudo rpm -Uvh packageName.rpm

Finally repeat the same procedure on the secondary server of the cluster.

All NoMachine services are automatically started once the upgrade is completed and the NoMachine subsystem should be operative.