0
edits
Changes
no edit summary
This guide covers the installation of freeNX and the supporting NX environment from the source code. NX is a remote desktop application for linux machines. It is extremely bandwidth optimized and has clients for every platform.Look [http://en.wikipedia.org/wiki/NX_technology here ]for details.<br>
Originally created by [http://www.nomachine.com Nomachine], it has an open source clone called [httphttps://freenxhelp.berliosubuntu.decom/ community/FreeNX FreeNX].<br>
This app is very useful if you plan to access your IGEP board from remote and don't want to get only a simple shell prompt.These instructions have been proven to work on a standard Ubuntu 10.10 system. Instructions MAY work in other Ubuntu versions or Debian. They will probably not work for other non-Debian distros. If you use Gentoo, the whole NX system is available as a package in emerge.<br>
<br>
#A working SSH server (I assume you are trying to build a headless computer, buti f you got mouse/keyboard/monitor and work locally, these instructions are still valid)
#A basic knowledge of the linux shell
#Good will, coffee, patience, and all the other stuff normally needed when you go for source code compiling.
<br>
'''IMPORTANT''': if you find errors and the software does not compile, don't start immediately to ask for help, every system installation is different. There is surely a library header, a development utility or something else you did not install or that was not present on your system: read carefully the last lines of the error log and , figure out and , google a bit and don't worry, it’s not at all difficult.
<br>
Let's start:
1. If you don’t have a desktop manager installed, install gnome-desktop (don’t install the full ubuntu-desktop unless you really need it, it will install production packages like OpenOffice.org and Gimp)<br><pre>sudo apt-get install gnome-desktop</pre><br>2. Install the build environment and some supporting libraries and tools (NOTE: if you need a complete build environment, look at other infos [http://labs.igep.es/index.php/How_to_setup_a_development_environment [How to setup a development environment|here]])
<pre>sudo apt-get install build-essential libjpeg62-dev libpng12-dev xutils-dev cups expect netcat
</pre>
Before you start asking: Yes, you need cups even if you’ll never use a printer. NX won’t build without it installed<br>
<br>
3. Create a work directory in your home and enter it<br>
<pre>mkdir freenx
cd freenx
</pre><br>
4. Download all the source packages (packages are taken [http://prdownloadpkgs.berliosfedoraproject.deorg/repo/pkgs/freenx-server/freenx-server-0.7.3.tar.gz / here ]and [http://www.nomachine.com/sources.php here ])<br>
<pre>wget http://download.berlios.de/freenx/freenx-server-0.7.3.tar.gz
wget http://64.34.161.181/download/3.4.0/sources/nxproxy-3.4.0-2.tar.gz
wget http://64.34.161.181/download/3.4.0/sources/nxauth-3.4.0-3.tar.gz
wget http://64.34.161.181/download/3.4.0/sources/nxagent-3.4.0-11.tar.gz
</pre><br>
5. Unpack everything<br>
<pre>tar zxvf *.tar.gz
</pre>
There will not be a single directory for each one of the unpacked archives as some of these will unpack under the nx-X11 folder. If you have trouble unpacking everything at once, do it file by file.<br>
<br>
6. Now enter the nx folders and build everything (leave only the nx-X11 apart)<br>
<pre>cd <every single folder>
./configure
make
</pre><br>
7. Then enter the X folder and make the whole server<br>
<pre>cd nx-X11
make World
</pre>
'''NOTE''': This operation will take a LONG time. Explanation: this step actually builds the complete Xfree86 with custom modifications from NX. <br>
<br>
8. Copy some the compiled libraries in the NX folder (all the following commands have to be done as superuser with sudo)<br>mkdir /usr/NX<br>
<pre>cp -a nx-X11/lib/X11/libX11.so* ${NXPREFIX}/lib
cp -a nx-X11/lib/X11/libX11.so* ${NXPREFIX}/lib
cp /usr/NX/lib/libXcomp* /usr/lib
cp /usr/NX/bin/nxagent /usr/bin/
</pre><br>
9. There is an error in the freenx installer, you need to manually create a link to a library<br>
<pre>sudo ln -s /usr/NX/lib/libXrender.so.1.2.2 /usr/NX/lib/libXrender.so.1.2
</pre><br>
10. Now enter the freenx folder and build the server<br>
<pre>cd freenx-server-0.7.3
NXPREFIX=/usr/NX
make
sudo make install
</pre><br>
11. Now configure your NX server (follow the insttructions and ignore warnings about the nxagent without version string, it is a known and uncorrected bug) <br>
<pre>and you are done
export PATH=$PATH:/usr/NX/bin
sudo nxsetup --install
</pre><br> Now you '''should '''have a working NX server. If not, check the error logs in the NX client and ad try to get a clue. The installation has been tried with XFCE and it did NOT work at all, so don't even try to understand why (unless you have a lot of spare time to do it): use Gnome.<br>
Now you '''should '''have a working NX server. If not, check the error logs in the NX client and ad try to get a clue. The installation has been tried with XFCE and it did NOT work at all, so don't even try to understand why (unless you have a lot of spare time to do it): use Gnome.<br>
<br>
Just connect to your IGEPv2 box using one of the the NX clients found on www.nomachine.com.<br><br>