= Freenx Installation =
== Client nxclient installation ==
=== Supported Platforms ===
 1. Windows
  * Windows 2000/XP/2003/Vista

 1. Linux i386
  a. Red Hat Enterprise Linux 4/5
  a. SuSe 10/10.1/10.2/Enterprise 10
  a. Mandriva 10.1/2005/2006/2007
  a. Fedora Core 3/4/5/6
  a. Fedora 7
  a. Debian GNU/Linux 4.0 Etch
  a. Ubuntu 5.10 Breezy Badger/6.05 Dapper Drake/6.10 Edgy Eft/7.04 Feisty Fawn
  a. Xandros 4.1
=== NX Client Installation on Windows Platforms ===
 1. Installing NX Client:
  * Double-click on the icon of the NX Client executable file you have downloaded from the NoMachine Web site http://www.nomachine.com/download:
  * the NX Setup Wizard will take you through the installation.
  I. Select where to install NX Client and confirm by clicking on the Next button.

  I. The Setup Wizard will allow you to create the program shortcut in the Start Menu by default or in any folder of your choice. To proceed, click on the Next button as usual.

  I. A further dialog will enable you to create an additional shortcut to the application on your desktop. Confirm according to your personal preference.

  I. The final dialog will ask you to confirm the installation of NX Client on your machine.

  I. Exit the installation
   * If you want to exit the installation, please click on the Cancel button and click on Yes.

 1. NX Client Configuration:
  I. After the Installation, it will open an prompt window for nxclient configuration, if not, try find shortcut for access '''NX Client for Windows'''

  I. In '''NX Connection Wizard''' window, click on ''next'' then lead to "Session" window

  I. In '''Session''' box, type in the unique name of the server going to access to plus the terminal name of users,(e.g. Damro-lanka2, this is for user lanka2 to Damro server)

  I. in '''Host''' box, type in the server domain name or ip address which ever is accessible, in the '''Port''' box, leave '''22''' as a default value

  I. nothing very interesting on '''Selection of internet connection''', so leave it for default selection, then click on ''next''

  I. In '''Desktop''' window, keep the '''Unix''' drop-down list choose '''Unix''' as default, and in '''KDE''' drop-down list choose '''Custom''', then click on '''Settings...''', then open a new '''Custom - Settings''' pop-up window

  I. In '''Application''' section, choose either

  I. '''"Run the default X client..."''' or '''"Run the following command"''', in the filed below type in the command to be run on remote server, e.g. very possibly '''fvwm''' for our scenario

  I. In '''Options''' section, choose '''new virtual desktop''' for the reason of display requirement.

  I. After check the configuration of above, click on ''ok'' then go back to main window, and then click on ''next''

  I. In '''Configuration completed''' window, check the two check-boxes, and click on ''Finish'', then another main configuration window will pop-up.

  I. In the top of the window, there are tabs named as '''General, Advanced, Services, Environment, About''', focus on '''General''' tab only at this stage.

  I. In the '''Server''' section, check '''Remember my password''', then check the '''Key...''' button, in the pop-up window '''Key Management''', the DSA key is the private key of the server key pair on the remote server, need to be copied from remote server, click on '''Import''' and locate the key then click '''Save'''

  I. Note: For step XIII you might need to copy the '''client.id_dsa.key''' file from '''server''' to '''client''' computer. To do that you need to login to '''abe''' and be''' root''' user. Then go into client's '''home directory''' where there will be '''hidden files ( ls -al).''' Then run this comannd to copy the file (''' # cp /etc/X11/xinit/Xclients .Xclients'''). Then to change access run this command ( '''# chown client:control .Xclients)
'''

  I. Back to the '''General''' tab, in '''Display''' section in the drop-down list select whatever display mode fit to client side, then simple click on ''Save'' and ''Ok''

  I. In small Login window
   .
||'''Login''' || ||
   ||'''Password''' || ||
   ||'''Session''' || ||

  I. make sure they are correct corresponding to each other, then click on '''Ok''', the session will start connecting.
== Server FreeNX Installation ==
 * Prerequisite: sshd must be running as a daemon on port 22 (This can be modified later.)
=== Setup FreeNX on Fedora Core 5 or later ===
----
 a. Make sure you are up-to-date
  . #yum update

 a. Install FreeNX and all dependencies
  . #yum install freenx
----

=== Setup FreeNX on FC4 or earlier ===
----
 a. Make sure you are up-to-date
  . #yum update

 a. Install NX rpm dependencies
  . #yum install expect nc

 a. Grab a Freenx package
  i. Use this package for FC2, FC3, FC4, and xorg based distributions
   . #wget http://fedoranews.org/contributors/rick_stout/freenx/freenx-0.4.4-2.fdr.0.noarch.rpm

  i. Use this package for FC1, RH9, RHEL3 or XFree86 based distributions
   . #wget http://fedoranews.org/contributors/rick_stout/freenx/freenx-0.4.4-2.rh.0.noarch.rpm

 a. Next, grab an nx package
  i. This package was built on FC4
   . #wget http://fedoranews.org/contributors/rick_stout/freenx/nx-1.5.0-4.FC4.1.i386.rpm

  i. This package was built on FC3
   . #wget http://fedoranews.org/contributors/rick_stout/freenx/nx-1.5.0-4.FC3.1.i386.rpm

  i. This package was built on FC2
   . #wget http://fedoranews.org/contributors/rick_stout/freenx/nx-1.5.0-4.FC2.1.i386.rpm

  i. Use this package if you are using FC1, RH9, RHEL3 or a Redhat compatible distribution using XFree86
   . #wget http://fedoranews.org/contributors/rick_stout/freenx/nx-1.5.0-4.FC1.1.i386.rpm

 a. Install the RPM's
  I. #rpm -Uvh nx-1.5.0-4.FC4.1.i386.rpm

  I. #rpm -Uvh freenx-0.4.4-2.fdr.0.src.rpm
----

=== Configuration after Installation ===
----
 a. Since package installation successful, need to setup nx for FreeNX running
  * set PATH including /usr/libexec/nx, in order that file '''''nxloadconfig''''' is searchable during setup
  * locate '''nxsetup''' file, and run it as root
   . #/PATH/TO/nxsetup

 a. Configuration files location:
  .
||'''''/etc/nxserver/''''' ||
  ||node.conf.sample ||
  ||passwords.orig ||
  ||passwords ||
  ||server.id_dsa.pub.key ||
  ||client.id_dsa.key ||
  ||users.id_dsa.pub ||
  ||users.id_dsa ||

  * For FreeNX versions >=0.5.0 you might need to edit the file '''''/etc/nxserver/node.conf'''''
  * copy '''''node.conf''''' configuration file from sample
   . #cp -p node.conf.sample node.conf
  * Then edit file '''''node.conf''''' correspondingly, comment out the following lines, and edit similar as shown:
   1. DISPLAY_BASE=4000
   1. SESSION_LIMIT=200
   1. SESSION_USER_LIMIT=200
   1. DISPLAY_LIMIT=200
   1. NX_LOG_LEVEL=6
   1. NX_LOGFILE=/var/log/nx/nxserver.log
   1. SESSION_LOG_CLEAN=1
   1. USER_X_STARTUP_SCRIPT=.Xclients

 a. '''Every time''' after edit configuration file '''''node.conf''', restart '''nxserver''': ''
  . #nxserver --restart

 a. '''Before''' nxclient is able to connect with nxserver, need to copy the '''PRIVATE KEY''' to client side for ssh authentication purpose.
  * The file is located at '''''/etc/nxserver/client.id_dsa.key'''''
----
===== Further details of freenx instructions will be updated shortly. =====