|
Download this same document as:
|
|
|
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
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
|
|
 |
|