NX Node Installation
Instructions

1.2 Required Libraries for Installing NX Node on Linux

The NX Node packages ship their own (updated) version of most of the required libraries, which link with GLIBC dynamically. This kind of packaging solves the problem of offering a package that works everywhere, especially on older distributions, but one that is small enough to be manageable.

These are the libraries required on the system to install the NX Node:

- libXpm.so.4
- libc.so.6(GLIBC_2.2.3)
- libnsl.so.1(GLIBC_2.0)

1.3 How to Obtain the Required Libraries for Your Linux Distribution

To find any required library missing on your O.S., please check if the installation CD from your vendor provides it, or refer to the official Web site of your distribution.

1.4 Prerequisites

Installation of the NX Client package is a prerequisite for installing NX Node. To install NX Client, please follow the instructions reported in the NX Client Installation Instructions available at:

Alternatively, you can use the graphical package manager provided by your Linux distribution.

2.3 Updating the NX Node Installation from RPM Package

It is highly recommended you disable access to new NX sessions and terminate all running sessions before proceeding with the upgrade of the node.

To disable access to new NX sessions, open an xterm or similar and run the following command. Please note that this will not affect users' ability to login to the system by other means (f.e. ssh or telnet):

# sudo /usr/NX/bin/nxserver --stop

You might want to issue a warning to all connected users to inform them of the operation. Run:

# sudo /usr/NX/bin/nxserver --broadcast "Your message here"

Then, after the warning, terminate all the running sessions:

# sudo /usr/NX/bin/nxserver --shutdown

# sudo /usr/NX/bin/nxserver --stop NODELIST

you can specify the list of nodes you want to disable, for example:

# sudo /usr/NX/bin/nxserver --stop 111.222.333.xxx:22 111.222.333.yyy:22

Then proceed with the upgrade instructions provided below and, after the operation is completed, enable access to the node(s) by running:

# sudo /usr/NX/bin/nxserver --start NODELIST

For example:

# sudo /usr/NX/bin/nxserver --start 111.222.333.xxx:22 111.222.333.yyy:22

Before upgrading the installation, make a backup of your current NX installation and protect sensitive information that may be present inside the TAR archive by making the backup readable only by the 'root' user:

# sudo tar cvzf /root/nx-BACKUP.tar.gz /usr/NX
# sudo chmod 0600 /root/nx-BACKUP.tar.gz

Next move to the directory where you have downloaded the package from the NoMachine Web site and run:

# sudo rpm -Uvh nxnode-X.Y.Z-W.i386.rpm

The rpm utility will fail if NX Server is installed. First uninstall NX Server, then proceed with the uninstall of the NX Node. To uninstall the server, please follow the instructions reported in the NX Server Installation Instructions available at:

2.5 Installing the NX Node DEB Package

Open an xterm terminal or similar, move to the directory where you have downloaded the package from the NoMachine Web site and install the package using the dpkg utility:

# sudo dpkg -i nxnode_X.Y.Z-W_i386.deb

2.6 Updating the NX Node Installation from DEB Package

It is highly recommended you disable access to new NX sessions and terminate all running sessions before proceeding with the upgrade of the node.

To disable access to new NX sessions, open an xterm or similar and run the following command. Please note that this will not affect users' ability to login to the system by other means (f.e. ssh or telnet):

# sudo /usr/NX/bin/nxserver --stop

You might want to issue a warning to all connected users to inform them of the operation. Run:

# sudo /usr/NX/bin/nxserver --broadcast "Your message here"

Then, after the warning, terminate all the running sessions:

# sudo /usr/NX/bin/nxserver --shutdown

If the load balancing feature is enabled on your NX server, you can also proceed with the upgrade of individual node(s) on remote machines and forbid starting new NX sessions on the specified nodes until the operation is completed. By running:

# sudo /usr/NX/bin/nxserver --stop NODELIST 

you can specify the list of the nodes you want to disable, for example:

# sudo /usr/NX/bin/nxserver --stop 111.222.333.xxx:22 111.222.333.yyy:22

Then proceed with the upgrade instructions provided below and, after the operation is complete, enable access to the node(s) by running:

# sudo /usr/NX/bin/nxserver --start NODELIST

For example:

# sudo /usr/NX/bin/nxserver --start 111.222.333.xxx:22 111.222.333.yyy:22

Before upgrading the installation, make a backup of your current NX installation and protect sensitive information that may be present inside the TAR archive by making the backup readable only by the 'root' user:

# sudo tar cvzf /root/nx-BACKUP.tar.gz /usr/NX
# sudo chmod 0600 /root/nx-BACKUP.tar.gz

Next move to the directory where you have downloaded the package from the NoMachine Web site and run:

# sudo dpkg -i nxnode_X.Y.Z-W_i386.deb

The dpkg utility will automatically unsinstall the old version present on the system and install the new one.

The dpkg utility will fail if NX Server is installed. First uninstall NX Server, then proceed with the uninstall of the NX Node package. To uninstall the server, please follow the instructions reported in the NX Server Installation Instructions available at:

2.8 Installing the NX Node Compressed TAR Package

Open an xterm terminal or similar. You should have downloaded the tar.gz package to the /usr directory. If not, move the package to the /usr directory. For example:

# sudo mv nxnode-X.Y.Z-W.i386.tar.gz /usr

Then extract the archive:

# cd /usr
# sudo tar xvzf nxnode-X.Y.Z-W.i386.tar.gz

and run the setup script for nxnode:

# sudo /usr/NX/scripts/setup/nxnode –-install

2.9 Updating the NX Node Installation from Compressed TAR Package

It is highly recommended you disable access to new NX sessions and terminate all running sessions before proceeding with the upgrade of the node.

To disable access to new NX sessions, open an xterm or similar and run the following command. Please note that this will not affect users' ability to login to the system by other means (f.e. ssh or telnet):

# sudo /usr/NX/bin/nxserver --stop

You might want to issue a warning to all users connected to inform them of the operation. Run:

# sudo /usr/NX/bin/nxserver --broadcast "Your message here"

Then, after the warning, terminate all the running sessions:

# sudo /usr/NX/bin/nxserver --shutdown

If the load balancing feature is enabled on your NX server, you can also proceed with the upgrade of individual node(s) on remote machines and forbid starting new NX sessions on the specified nodes until the operation is completed. By running:

# sudo /usr/NX/bin/nxserver --stop NODELIST

you can specify the list of the nodes you want to disable, for example:

# sudo /usr/NX/bin/nxserver --stop 111.222.333.xxx:22 111.222.333.yyy:22

Then proceed with the upgrade instructions provided below and, after the operation is complete, enable access to the node(s) by running:

# sudo /usr/NX/bin/nxserver --start NODELIST

For example:

# sudo /usr/NX/bin/nxserver --start 111.222.333.xxx:22 111.222.333.yyy:22

Before upgrading the installation, make a backup of your current NX installation and protect sensitive information that may be present inside the TAR archive by making the backup readable only by the 'root' user:

# sudo tar cvzf /root/nx-BACKUP.tar.gz /usr/NX
# sudo chmod 0600 /root/nx-BACKUP.tar.gz

Next ensure that the downloaded package is in the /usr directory, extract the archive and run the setup script for nxnode:

# sudo tar xvzf nxnode-X.Y.Z-W.i386.tar.gz
# sudo /usr/NX/scripts/setup/nxnode –-update

This operation will overwrite all the files from the previous installation.

2.10 Removing the NX Node Installation from Compressed TAR Package

This operation will remove both the NX Client and the NX Node and the NX server when installed. Open an xterm terminal or similar.

Run the setup script for uninstalling the server, if present, and/or the setup script for uninstalling the node. Finally remove the installation directory:

# sudo /usr/NX/scripts/setup/nxserver –-uninstall 
# sudo /usr/NX/scripts/setup/nxnode –-uninstall
# sudo rm -rf /usr/NX

Please note that if NX Server is installed, it is advisable to uninstall it before removing the /usr/NX directory. This will ensure a clean installation of any successive NX Server version.

Open a terminal and move to the directory where you have downloaded the package from the NoMachine Web site. Expand the package archive and install it using the pkgadd utility:

# sudo gunzip nxnode-X.Y.Z-W.sparc.gz
# sudo pkgadd -d nxnode-X.Y.Z-W.sparc

3.2. Updating the NX Node Installation

It is highly recommended you disable access to new NX sessions and terminate all running sessions before proceeding with the upgrade of the node.

To disable access to new NX sessions, open an xterm or similar and run the following command. Please note that this will not affect users' ability to login to the system by other means (f.e. ssh or telnet):

# sudo /usr/NX/bin/nxserver --stop

You might want to issue a warning to all connected users to inform them of the operation. Run:

# sudo /usr/NX/bin/nxserver --broadcast "Your message here"

Then, after the warning, terminate all running sessions:

# /usr/NX/bin/nxserver --shutdown

If the load balancing feature is enabled on your NX server, you can also proceed with the upgrade of individual node(s) on remote machines and forbid starting new NX sessions on the specified nodes until the operation is completed. By running:

# sudo /usr/NX/bin/nxserver --stop NODELIST

you can specify the list of the nodes you want to disable, for example:

# sudo /usr/NX/bin/nxserver --stop 111.222.333.xxx:22 111.222.333.yyy:22

Then proceed with the upgrade instructions provided below and, after the operation is complete, enable access to the node(s) by running:

# sudo /usr/NX/bin/nxserver --start NODELIST

For example:

# /usr/NX/bin/nxserver --start 111.222.333.xxx:22 111.222.333.yyy:22

Before upgrading the installation, make a backup of your current NX installation and protect sensitive information that may be present inside the TAR archive by making the backup readable only by the 'root' user:

# sudo tar cvzf /root/nx-BACKUP.tar.gz /usr/NX
# sudo chmod 0600 /root/nx-BACKUP.tar.gz

The next step is to remove the previous installation, otherwise the installation will fail because only a single instance of the package is supported at any one time on the same system:

# sudo pkgrm NXnode

Finally, expand the package archive and install it using the pkgadd utility:

# sudo gunzip nxnode-X.Y.Z-W.sparc.gz
# sudo pkgadd -d nxnode-X.Y.Z-W.sparc

3.3 Removing the NX Node

The pkgrm utility will fail if NX Server is installed. First, uninstall NX Server, then proceed with the uninstall of the NX Node package. To uninstall the server, please follow the instructions reported in the NX Server Installation Instructions available at: