Home > Documents > Installation > NX Server Manager Installation Instructions
Download this same document as: PDF Format HTML Format
NX Server Manager Installation Instructions
1. NX Server Manager Installation Instructions

Welcome to the NX Server Manager installation guide. Below you will find some hints about the NX Server Manager packages and step-by-step instructions on how to install, update or remove the NX Server Manager on your Operating System. You can download the latest available version of the package suitable for your O.S. at:

http://www.nomachine.com/download

In the following document, X.Y.Z-W indicates the version of the package you are going to install, e.g. nxmanager-X.Y.Z-W.i386.rpm.

IMPORTANT
You may install, update and remove packages by using the sudo utility. If you don't have the sudo utility installed, log on as superuser ("root") and run the commands without sudo. If you don't have access to your machine as root user, please contact your Systems Administrator.
Please note that, if you want to upgrade your NX Server Manager to version 2.0.0 or superior, it is highly recommended you uninstall the manager and proceed with the installation of NX Server Manager from scratch. This will avoid any compatibility problems with previous versions, in particular with the different backend provided by NX Server Manager 1.5.0 and that of version 2.0.0.

1.1 Supported Platforms

The supported platforms are:

Linux i386

  • Red Hat Enterprise Linux 4/5
  • SuSe 10/10.1/10.2/Enterprise 10
  • Mandriva 10.1/2005/2006/2007
  • Fedora Core 3/4/5/6
  • Fedora 7
  • Debian GNU/Linux 4.0 Etch
  • Ubuntu 5.10 Breezy Badger/6.06 Dapper Drake/6.10 Edgy Eft/7.04 Feisty Fawn
  • Xandros Desktop 4.1/Xandros Server 2.0


IMPORTANT

NoMachine's policy is to provide packages for the most recent versions of Linux which you can see listed above or on the download page: http://www.nomachine.com/download

Users of older Linux versions are pointed to a specific download page for the appropriate NX packages. Please note that, at the time of an NX release, it is possible that packages for the following older Linux distributions are slightly delayed:

  • RedHat 7.2/7.3/8.0/9.0/RHEL 3.0
  • SuSE Linux 7.2/7.3/8.0/8.1/8.2/9.0
  • Mandriva Linux 9.0/9.1/9.2/10.0
  • Fedora Core 1/2
  • Debian GNU/Linux 3.0 Woody/3.1 Sarge
  • Ubuntu 5.04 Hoary
  • Xandros 3.0


Linux x86_64

  • Red Hat Enterprise Linux 4/5
  • SuSe 10/10.1/10.2/Enterprise 10
  • Mandriva 10.1/2005/2006/2007
  • Fedora Core 3/4/5/6
  • Fedora 7
  • Debian GNU/Linux 4.0 Etch
  • Ubuntu 5.10 Breezy Badger/6.06 Dapper Drake/6.10 Edgy Eft/7.04 Feisty Fawn
  • Xandros Desktop 4.1/Xandros Server 2.0


SOLARIS SPARC

  • 8/9/10

The list of the supported platforms and operating systems may be updated from time to time, so please refer to the download page to get the latest information: http://www.nomachine.com/download


1.2 Prerequisites

Before going ahead with the installation of the NX Server Manager, it is recommended you have installed:

  • NX Client Version 3.0.0 or later
  • NX Node Version 3.0.0 or later
  • NX Server Version 3.0.0 or later
  • Apache HTTP Server Version 2.0

To install NX Client, NX Node and NX Server, please follow the instructions reported in the correspondent Installation Instructions available at:

http://www.nomachine.com/documents/client/install.php

http://www.nomachine.com/documents/node/install.php

http://www.nomachine.com/documents/server/install.php



2. NX Server Manager Installation Instructions for Linux Platforms

You may install, update and remove the package by using the sudo utility. If you don't have the sudo utility installed, log on as superuser ("root") and run the commands without sudo.


2.1 List of the Available NX Server Manager Packages

The following NX Server Manager packages are available:

  • RPM, DEB and Compressed TAR for 32bit architecture
  • RPM, DEB and Compressed TAR for 64bit architecture
  • RPM, DEB and Compressed TAR for 32bit architecture for earlier Linux versions

The list of the supported platforms may be updated from time to time, please refer to the download page to get the latest information:

http://www.nomachine.com/download.php


2.2 Installing the NX Server Manager RPM Package

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

# sudo rpm -ivh nxmanager-X.Y.Z-W.i386.rpm

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


2.3 Updating the NX Server Manager Installation from RPM Package

Open an xterm terminal or similar, 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 nxmanager-X.Y.Z-W .i386.rpm

2.4 Removing the NX Server Manager Installation from RPM Package

Open an xterm terminal or similar and run:

# sudo rpm -e nxmanager

2.5 Installing the NX Server Manager 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 it using the dpkg utility:

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

2.6 Updating the NX Server Manager Installation from DEB Package

Open an xterm terminal or similar, 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 nxmanager_X.Y.Z-W_i386.deb

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


2.7 Removing the NX Server Manager Installation from DEB Package

Open an xterm or similar and uninstall the package using the dpkg utility:

# sudo dpkg -r nxmanager

2.8 Installing the NX Server Manager 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 and extract the archive:

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

2.9 Updating the NX Server Manager Installation from Compressed TAR Package

Open an xterm or similar, 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 and extract the archive:

# sudo tar xvzf nxmanager-X.Y.Z-W.i386.tar.gz

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


2.10 Removing the NX Server Manager Installation from Compressed TAR Package

This operation will also remove the NX Client, the NX Node and the NX Server installations. Please note that it is advisable to uninstall the NX Server before removing the /usr/NX directory. This will ensure a clean installation of any successive NX Server version. Open an xterm or similar and remove the installation directory:

# sudo rm -rf /usr/NX


3. NX Server Manager Installation Instructions for Solaris Platforms

You may install, update and remove the package by using the sudo utility. If you don't have the sudo utility installed, log on as superuser ("root") and run the commands without sudo.


3.1 Installing the NX Server Manager

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 nxmanager-X.Y.Z-WW.sparc.gz
# sudo pkgadd -d nxmanager-X.Y.Z-WW.sparc

3.2 Updating the NX Server Manager

Open a terminal, 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 gtar 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 one time on the same system:

# sudo pkgrm NXmanager

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

# sudo gunzip nxmanager-X.Y.Z-WW.sparc.gz
# sudo pkgadd -d nxmanager-X.Y.Z-WW.sparc

3.3 Removing the NX Server Manager

Open a terminal and remove the NX Server Manager installation using the pkgrm utility:

# sudo pkgrm NXManager


4. Configuring the NX Server Manager

The usr/NX/etc/manager.cfg file contains the configuration variables that NX Server Manager needs in order to work properly. Please verify whether the default values provided by this file fit the settings of your NX Server Manager machine.

In particular, you should ensure that the following keys are set according to the configuration on your system:

#
# Specify user name of Apache owner.
#
ApacheUname = "nobody"

#
# Specify group name of Apache owner.
#
ApacheGname = "nogroup"

#
# Specify the Apache reload command.
#
ApacheHTTPDReloadCommand = "/etc/init.d/apache2 graceful" 



5. Configuring Apache HTTP Server Version 2.0 to Run the NX Server Manager

The NX Server Manager package provides a configuration file, namely manager.conf, to be included in the Apache configuration file in order to run the application.

The /usr/NX/etc/manager.conf file should be included in the Apache configuration file, for example httpd.conf, by adding the following directive before the "Global Environment" section:

Include /usr/NX/etc/manager.conf

Then restart your Apache Web server.

The Apache configuration file is usually: PREFIX/conf/httpd.conf. Alternative locations, depending on your installation, may be, for example, /etc/apache2/httpd.conf and /etc/httpd/httpd2.conf.

The manager.conf file provides the following directives:

Alias /nxmanager/ "/usr/NX/share/htdocs/nxmanager/" 

ScriptAlias "/nxmanager" "/usr/NX/bin/nxmanager"

<Directory "/usr/NX/">
    AllowOverride None            
    Options None                  
    Order allow,deny              
### ADDRESS RESTRICTIONS START ###
    Allow from all
### ADDRESS RESTRICTIONS STOP  ###
</Directory>


IMPORTANT

Please don't modify the comments related to the Address Restrictions. These are required to configure the restrictions via Web through the NX Server Manager application.
If your Apache configuration file provides restrictive directives, you should verify that they don't override the directives set in the manager.conf file.

5.1 Setting the Proper Permissions for the NX Server Manager

Set the proper permissions for the NX Server Manager backend and for the manager configuration file to be included in your Apache configuration by running the following command in an xterm or similar:

# sudo /usr/NX/scripts/setup/nxmanager --update



6. Adding NX Server Administrators

After you have successfully installed the NX Server Manager, at least one administrator user should be initially created on the server(s) you want to administer through the Web application. To create administrators on the server, please access the machine where NX Server is installed and run the following command in an xterm or similar:

# sudo /usr/NX/bin/nxserver --useradd USERNAME --administrator


7. Running the NX Server Manager

The NX Server Manager is a Web application based on perl CGI. You can run it pointing your browser to the proper URL according to the CGI directory you have specified in the configuration file of Apache:

e.g. http://localhost/nxmanager/



8. Administering the NX Server Manager

The NX Server Manager application is provided with a default Web administrator user. As the NX Server Manager Administrator you will be able to have control over the application itself as well as the NX Server network management. You can enter the application by using the following credentials:

Username: nxmanager 
Password:  nxmanager 

IMPORTANT

It is strongly suggested you modify the NX Server Manager administrator password once logged in.


For further information about NX Server Manager and NoMachine's range of other products, users are invited to visit our website at www.nomachine.com
Technology Brief
Data encryption and security

NX security is guaranteed at every layer involved in the communication process. NX uses SSH public-key encryption and 128 bit volatile random cookie generation.

Multimedia support

NX transparently tunnels Linux multimedia channels. Not only does NX play KDE and Gnome system sounds, but you can listen to MP3s played on the server and local workstation simultaneously.

Unified support for all major remote desktop protocols

Thanks to its outstanding compression performances, NX is able to deliver X, RDP and RFB remote sessions using the same client. This is achieved by translating "foreign" protocols into X-Window, the native protocol of NX.

NX Distributed Computing Architecture

Behind NoMachine software is the NX Distributed Computing Architecture, a suite of Open Source technologies and commercial tools, designed by NoMachine to make network computing as easy and widespread as Web browsing. NoMachine has built the foundations of its NXDCA on two well known and widely used open standards, SSH and the X-Window System, the windowing system which is behind the Graphical User Interfaces of Linux and the Unix Operating System.


Support Options
Knowledge Base

NoMachine's Knowledge Base is the best place to start looking for answers to your technical, licensing and support questions.

Features and requirements

For a more detailed description of what our subscription options offer consult the NX Subscription Overview.

Print this document
Send this page
 


Home | News | About Us | Partners | Contact Us
Products | Download | Support | Documents | Customers
Copyright 2002-2008, Medialogic - VAT 05773981005