Support Center

Your questions answered

Knowledge Base

Searching in: Documents
Filter the search results
Version:
Last update:
Searching in: Documents
ID: DT01L00062
Version: NX 4
Added on: 2014-01-08
Last update: 2015-07-15
NoMachine Enterprise Products v. 4, Server Installation Guide

Table of Contents

1. NoMachine Server for the Enterprise Installation Guide

1.1. Resources on the Web

1.2. Prerequisites

1.3.Compatibility Between Client/Server versions
2. Installing on Windows

2.1.Installing

2.2. Updating

2.3. Uninstalling
3. Installing on Mac OS X

3.1. Installing

3.2. Updating

3.3. Uninstalling
4. Installing on Linux

4.1. RPM Packages

4.2. DEB Packages

4.3. TAR.GZ Packages
5. The Monitor in Your System Tray
6. Initiating a Connection to NoMachine Server

 

1. NoMachine Server for the Enterprise - Installation Guide

Welcome to the NoMachine Server Installation Guide for the Enterprise version 4. This guide applies to the following products from the NoMachine for the Enterprise range: Workstation, Small Business Server, Terminal Server, Enterprise Desktop and Enterprise Server. This document is intended to provide you with step-by-step instructions on how to install, update or remove the NoMachine software on/from your system and it's updated to fit version 4.2.27 and later.

For the sake of simplicity, the software you install will be referred to as NoMachine Server.

Once installation has been completed with success, NoMachine Server is up-and-running and ready to accept connections. You can check or change current settings and manage server side services from the Preferences ->  Server status Server preferences panel in the NoMachine GUI. From the same GUI you can also initiate a connection to another computer (i.e all NoMachine Servers provide a connection GUI).

 

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 Systems

Windows 32-bit/64-bit XP/Vista/7/8/8.1
Mac OS X Intel 64-bit 10.5/10.6/10.7/10.8/10.9/10.10
Linux 32-bit and 64-bit

  • Red Hat Enterprise 4/5/6/7
  • SLES 10/11
  • Open SUSE 10.x /11.x/12.x/13.x
  • Mandriva 2009/2010/2011
  • Fedora Core 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

- Network connection (either a LAN, or Internet link: broadband, cable, DSL, etc...)

Size required on disk:

Windows 96.5 MB
Linux 74 MB
Mac 79 MB

 

1.3. Compatibility Between Client/Server Versions

Connecting from client 3.5.0 or by using a 3.5.0 connection file to a server 4 from the Terminal Server or Enterprise family

Provided you don't have SSH support disabled on the server, you should be able to connect from client 3.5.0 with no further intervention.

Connecting from client 4 to NX server 3.5.0

Edit the connection settings in the client GUI and choose to use the protocol SSH, then select 'NoMachine login' from the Advanced panel settings.

 

2. Installing on Windows

 

2.1. Installing

 

Download the package from the NoMachine web site and install it by double-clicking on the icon of the executable: a setup wizard will take you through the installation. Accept to reboot the machine, this is mandatory for completing the installation.

Tip

To install the package in silent or very silent mode from a CMD console, run respectively :

>nomachine-packageName_packageVersion.exe /silent

or:

>nomachine-packageName_packageVersion.exe /verysilent

Then reboot the machine:

> SHUTDOWN -r -t 10 -c " your comments here"

To specify a non-default installation directory, use:

nomachine-packageName_packageVersion.exe  /SILENT /DIR="X:Target_directory"

or:

nomachine-packageName_packageVersion.exe  /VERYSILENT /DIR="X:Target_directory"

 

Note for Windows XP: the NoMachine server will not start until the machine is rebooted.

 

2.2. Updating

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 and access the Preferences -> Updates panel and click on 'Check now'.

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 latest available package from the NoMachine web site and click on the executable file to launch Setup. As for the installation, Setup will guide you through all steps necessary for updating your installation.

 

2.3. Uninstalling

You can uninstall NoMachine from the Windows Control Panel and the Add or Remove Programs in Windows XP or Program and Features in Windows Vista, 7 or 8. Find the NoMachine program in the list of installed programs and choose to uninstall it.

On Windows 8, you can use the Search box from the Charms bar on the right side of the screen: type there Control Panel to open it. Then access the Programs - 'Uninstall a program' panel.

On Windows 7, Vista and XP, click on the Start button and click to open the Control panel from the Start menu. Then access panel 'Programs and Features' or 'Add or Remove Programs', depending on your Windows version.

Reboot is requested to complete the uninstalling process.

Tip

To uninstall from a CMD console, move to C:/ProgramData/NoMachine/var/uninstall/ (if you are on Vista/7/8) or to C:/Documents and Settings/All Users/NoMachine/var/uninstall/ (if you are on XP). Then run:

> unins000.exe /silent

or:

> unins000.exe /verysilent

Uninstalling is completed when your command prompt is back. Then, your computer will restart automatically.

 

3. Installing on Mac OS X

 

3.1. Installing

Download the DMG package from the NoMachine web site. Double-click on the disk Image to open it and see the package icon. Then double-click on the package icon to install the program: the installer will take you through the installation.

Tip

To install from the command line, run:

$ NXMOUNTDIR=$(echo `hdiutil mount nomachine-packagename_version.dmg | tail -1 | awk '{$1=$2=""; print $0}'` | xargs -0 echo)

$ sudo installer -pkg "${NXMOUNTDIR}/NoMachine.pkg" -target /

 

3.2. Updating

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 and access the Preferences -> Updates panel and click on 'Check now'.

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 latest available package from the NoMachine web site and click on the dmg file to mount the disk image. Then click on the package icon to initiate the update. As for the installation, Installer will guide you through all steps necessary for updating NoMachine.

 

3.3. Uninstalling

To uninstall, just drag and drop NoMachine from Applications to trash or select 'Move to trash' from the mouse button menu. Administrative credentials are requested.

Tip

To uninstall from command line, it's enough you remove the NoMachine application directory:

$  sudo rm -rf /Applications/NoMachine.app

 

4. NoMachine Server on Linux

You can either choose to install NoMachine by using the graphical installation program provided with your Linux distribution, or do it from the command line. If you choose to use the graphical installation, depending on which Linux distribution you are using, download the DEB or the RPM package from the NoMachine web site and double click on the package icon to install it via your installation program.

Otherwise, please refer to instructions below intended to be run from command line. They must be run as root user or by using the sudo utility.

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 and access the Preferences -> Updates panel and click on 'Check now'.

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.

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).

 

4.1. RPM Packages

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


If you want to install to 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 <pkgName>

where <pkgName> is any of the available NoMachine server package types:

nomachine-cloud-server
nomachine-enterprise-desktop
nomachine-enterprise-server
nomachine-small-business-server
nomachine-terminal-server
nomachine-workstation

or even:

nomachine-enterprise-client
nomachine-terminal-server-node


For versions up to 4.4.6, use:

# rpm -e nomachine

for all package types.

Tip

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

# rpm -qa | grep nomachine

You will get the full name of the NoMachine package already installed, for example: nomachine-enterprise-server-4.4.10-1.x86_64.

 

If you want to install to 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 <pkgName>

 

4.2. DEB Packages

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 <pkgName>

where <pkgName> is any of the available NoMachine server package types:

nomachine-cloud-server
nomachine-enterprise-desktop
nomachine-enterprise-server
nomachine-small-business-server
nomachine-terminal-server
nomachine-workstation

or even:

nomachine-enterprise-client
nomachine-terminal-server-node


For versions up to 4.4.6, use:

$ sudo dpkg -r nomachine

for all package types.


Tip

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

$ dpkg -l | grep nomachine

You will get the full name of the NoMachine package already installed, for example: nomachine-enterprise-server 4.4.10-1.


If you want to install to 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 <pkgName>

 

4.3. TAR.GZ Packages

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/nxserver --install


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


Uninstalling
$ sudo /usr/NX/scripts/setup/nxserver --uninstall
then, remove the installation dir:
$ sudo rm -rf /usr/NX


If you want to install to a non-default location, for example /opt/NX, extract the archive in /usr/NX and then use the following commands:


Installing
$ sudo NX_INSTALL_PREFIX=/opt /usr/NX/nxserver --install


Updating
$ sudo NX_INSTALL_PREFIX=/opt dpkg -i /usr/NX/nxserver --update


Uninstalling
$ sudo /opt/NX/scripts/setup/nxserver --uninstall
then remove the installation dir:
$ sudo rm -rf /opt/NX

 

5. The Monitor in Your System Tray

Once you have terminated the installation or the update, including reboot when requested, a NoMachine icon (!M) will appear in your system tray. This is the Monitor, a small application which gives you fast access to server management tools and advises you when someone is requesting to connect to your desktop. If a user is connected, you can disconnect them from the Monitor.

 

6. Initiating a Connection to NoMachine Server

From a client PC, where you have already installed a NoMachine package type or the Enterprise Client, run the NoMachine GUI from the programs or applications menu.  A wizard will take you through the steps necessary to set-up your first connection, just click on 'Create a new connection'. If you prefer to skip the wizard, click on 'Continue'.

The fastest way to create a new connection is to write the name or IP of the NoMachine host you want to connect to in the text field and click on the 'Press enter to create a new connection' link. This method will use the default NX protocol on port 4000.


Alternatively, you can click on the 'New' icon next to the white text field to configure the session in more detail.

Note that IPv6 is supported since version 4.1. Specify the IP address of the server host in IPv6 format (e.g. 2001:0:5ef5:79fb:30c6:1516:3ca1:5695) if you want to use it instead of IPv4.

For more details on how to connect to a NoMachine host and configure the NoMachine Server for your environment, please consult the appropriate guide from the documents section: https://www.nomachine.com/support and https://www.nomachine.com/documents.