NoMachine Terminal Server Node v. 4 - Installation Guide

Added on: 2013-09-24 Last Modified: 2015-07-07

 

Table of Contents

1. NoMachine Terminal Server Node Installation Guide

1.2. Prerequisites
2. Installing on Linux

2.1. Manage the RPM Package

2.2. Manage the DEB Package

2.3. Manage the TAR.GZ Package

 

 

1. NoMachine Terminal Server Node Installation Guide

Welcome to the NoMachine Terminal Server Node Installation Guide version 4. This document is intended to provide you with step-by-step instructions on how to install the Terminal Server Node package.

In order to add a remote node to the Enterprise Server (or to the Cloud Server), set-up a multi-node environment and load-balancing virtual desktops, please refer to the NoMachine Server Administrator's Guide for the Enterprise - Advanced: https://www.nomachine.com/DT09K00058

 

1.1. Resources on the Web

The NoMachine Web site, www.nomachine.com, provides you with a variety of online resources in conjunction with the software and its usage:


The NoMachine Packages
The latest version of NoMachine is available at: www.nomachine.com/download


The Knowledge Base
The Knowledge Base, https://www.nomachine.com/support, makes available both technical documents especially for administrators and end-user oriented guides, as well as articles on specific topics and How-Tos.


Leave Feedback About This Guide
Our goal is provide comprehensive and clear documentation for all the NoMachine products. If you would like to send us your comments and suggestions, you can use the Web contact tool available at https://www.nomachine.com/contact-request, by selecting the Web Quality Feedback as your option.

 

1.2. Prerequisites

Operating System

Linux 32-bit and 64-bit

Red Hat Enterprise 4/5/6/7
SLES 10/11
SLED 10.x/11.x
Open SUSE 10.x/11.x/12.x/13.x
Mandriva 2009/2010/2011
Fedora 10/11/12/13/14/15/16/17/18/19/20/21
Debian GNU Linux 4.0 Etch/5.0 Lenny/6.0 Squeeze/7.0 Wheezy/8.0 Jessie
Ubuntu 8.04 Hardy Heron/8.10 Intrepid Ibex/Ubuntu 9.04 Jaunty Jackalope/
9.10 Karmic Koala/10.4 Lucid Lynx/10.10 Maverick/11.04 Natty/11.10 Oneiric/
12.04 Precise Pangolin/12.10 Quantal Quetzal/13.04 Raring Ringtail/
13.10 Saucy Salamander/14.04 Trusty Tahr/14.10 Utopic Unicorn/15.04 Vivid Vervet

Hardware requirements

The software is designed to work on computers with minimal HW requirements. Although the software may work with inferior CPUs or reduced RAM, for best performance NoMachine recommends you match the listed requirements.

  • Intel Core2 Duo or AMD Athlon Dual-Core or equivalent
  • 1 GB RAM
  • 74 MB free disk space on your hard drive
  • Network connection (either a LAN, or Internet link: broadband, cable, DSL, etc...)

Other requirements

  • The Terminal Server Node can work only with a NoMachine Enterprise Server or a NoMachine Cloud Server.
  • Be sure you have installed it on the host that must act as gateway for distributing sessions among the remote nodes.

 

2. Installing on Linux

Notes for the first installation

You can install, update and uninstall using the graphical package manager of your Linux distribution or from command line by running commands from a xterm or similar with the sudo utility, or as root user if you don't have sudo installed. Instructions below refers to installation by command line.

Up to version 4.4.6, all packages were qualified by the same name 'nomachine'. Next versions use different package names to distinguish among client, node and server types (FR09L02829).

IMPORTANT
If you own a customer license we recommend to download and install the package marked for PRODUCTION from your Customer Area: https://www.nomachine.com/support#login.

 

Notes for updating the installation

Starting from version 4.0.365, you can update your installation from our repositories instead of downloading and installing the new package. Just run the NoMachine GUI from your Programs Menu, access the 'Change server settings' panel and the 'Software update' GUI from there. Then click on the 'Updates' button.

Note that since version 4.6.3 NoMachine has the automatic check for updates enabled: it will periodically check our repositories (by default every two days) to verify if updates are available. In this case, the server will prompt a dialog informing that a new version is available but it will never automatically update the current installation.

Checking for updates can be disabled from that dialog by selecting the 'Don't ask again for this version' option.

Alternatively, you may download the lastest available package from the NoMachine web site and use the graphical installation program provided with your Linux distribution or update the installation by command line as explained below.

 

IMPORTANT
If you own a customer license we recommend to download and install the package marked for UPDATE from your Customer Area: https://www.nomachine.com/support#login.

 

2.1. Manage the RPM Package

If you want to install to default location, namely /usr/NX:

Installing

# rpm -ivh <pkgName>_<pkgVersion>_<arch>.rpm


Updating

# rpm -Uvh <pkgName>_<pkgVersion>_<arch>.rpm


Uninstalling

# rpm -e nomachine-terminal-server-node


For versions up to 4.4.6 use:

# rpm -e nomachine

 

Tip

To find out which NoMachine package you have installed, run the following command:

# rpm -qa | grep nomachine



To install the Terminal Server Node in a non-default location, for example /opt/NX:


Installing

# rpm -ivh <pkgName>_<pkgVersion>_<arch>.rpm --prefix /opt


Updating

# rpm -Uvh <pkgName>_<pkgVersion>_<arch>.rpm --prefix /opt


Uninstalling

# rpm -e nomachine-terminal-server-node

or for versions up to 4.4.6:

# rpm -e nomachine

 

2.2. Manage the DEB Package

If you want to install to default location, namely /usr/NX


Installing

$ sudo dpkg -i <pkgName>_<pkgVersion>_<arch>.deb


Updating

$ sudo dpkg -i <pkgName>_<pkgVersion>_<arch>.deb

Uninstalling

$ sudo dpkg -r nomachine-terminal-server-node

For versions up to 4.4.6 use:

$ sudo dpkg -r nomachine

 

Tip

To find out which NoMachine package you have installed, run the following command:

$ dpkg -l | grep nomachine

 

To install the Terminal Server Node in a non-default location, for example /opt/NX:


Installing

$ sudo NX_INSTALL_PREFIX=/opt dpkg -i <pkgName>_<pkgVersion>_<arch>.deb


Updating

$ sudo NX_INSTALL_PREFIX=/opt dpkg -i <pkgName>_<pkgVersion>_<arch>.deb


Uninstalling

$ sudo dpkg -r nomachine-terminal-server-node

or for versions up to 4.4.6:

$ sudo dpkg -r nomachine

 

2.3. Manage the TAR.GZ Package

If you want to install to the default location /usr/NX ensure that package is placed there.


Installing

$ cd /usr
$ sudo tar xvzf <pkgName>_<pkgVersion>_<arch>.tar.gz
$ sudo /usr/NX/nxnode --install


Updating

$ cd /usr
$ sudo tar xvzf <pkgName>_<pkgVersion>_<arch>.tar.gz
$ sudo /usr/NX/nxnode --update


Uninstalling

$ sudo /usr/NX/scripts/setup/nxnode --uninstall

Then remove the installation dir:

$ sudo rm -rf /usr/NX


To install the Terminal Server Node in a non-default location, for example /opt/NX:


Installing

$ sudo NX_INSTALL_PREFIX=/opt /usr/NX/nxnode --install


Updating


$ sudo NX_INSTALL_PREFIX=/opt /usr/NX/nxnode --update


Uninstalling

$ sudo /opt/NX/scripts/setup/nxnode --uninstall

Then remove the installation dir:

$ sudo rm -rf /opt/NX