NX Server Manager Installation Instructions
Prepared by:
Silvia Regis		 N°:
D-708_005-NXM-MII
Approved by:
Sarah Dryell		 Signature:
 		 Date:
14/08/2007		 Amended:
A


NX Server Manager
Installation Instructions




Index

  • 1 NX Server Manager Installation Instructions

    1. 1.1 Supported Platforms
    2. 1.4 Prerequisites

  • 2 NX Server Manager Installation Instructions for Linux Platforms

    1. 2.1 List of the Available NX Server Manager Packages
    2. 2.2 Installing the NX Server Manager RPM Package
    3. 2.3 Updating the NX Server Manager Installation from RPM Package
    4. 2.4 Removing the NX Server Manager Installation from RPM Package
    5. 2.5 Installing the NX Server Manager DEB Package
    6. 2.6 Updating the NX Server Manager Installation from DEB Package
    7. 2.7 Removing the NX Server Manager Installation from DEB Package
    8. 2.8 Installing the NX Server Manager Compressed TAR Package
    9. 2.9 Updating the NX Server Manager Installation from Compressed TAR Package
    10. 2.10 Removing the NX Server Manager Installation from Compressed TAR Package

  • 3 NX Server Manager Installation Instructions for Solaris Platforms

    1. 3.1 Installing the NX Server Manager
    2. 3.2 Updating the NX Server Manager
    3. 3.3 Removing the NX Server Manager

  • 4 Configuring the NX Server Manager

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

    1. 5.1 Setting the Proper Permissions for the NX Server Manager

  • 6 Adding NX Server Administrators

  • 7 Running the NX Server Manager

  • 8 Administering the NX Server Manager




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

    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


    Up

    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

    Up

    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

    Up

    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.

    Up

    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

    Up

    2.4 Removing the NX Server Manager Installation from RPM Package

    Open an xterm terminal or similar and run: 

    # sudo rpm -e nxmanager

    Up

    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

    Up

    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.

    Up

    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

    Up

    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

    Up

    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.

    Up

    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

    Up

    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

    Up

    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

    Up

    3.3 Removing the NX Server Manager

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

    # sudo pkgrm NXManager

    Up

    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"

    Up

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

    You can verify that now you are able to access the application by placing in your browser: 

    http:///nxmanager

    Up

    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

    Up

    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/

    Up

    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

    Up