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.
