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 [href=http://www.nomachine.com Nomachine], it has an open source clone called [http://freenx.berlios.de/ 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> '''First thing''': NX works at its best with gnome installed at server side. <u>Don’t use XFCE, it won’t work with this guide</u>. <br> Prerequisites:<br> #A working IGEPv2 board with Ubuntu maverick or lucid installed. Everything will be done from the IGEP board itself, not on a supporting computer. #Network connection #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, figure out, 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 OpenOfficehermesbirkinreplica.org and Gimp)<br> <pre>sudo apt-get install gnome-desktop</pre> hermes birkin<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 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 freenxcd freenx</pre> <br> 4. Download all the source packages (packages are taken [http://prdownload.berlios.de/freenx/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.gzwget http://64.34.161.181/download/3.4.0/sources/nxproxy-3.4.0-2.tar.gzwget http://64.34.161.181/download/3.4.0/sources/nxcomp-3.4.0-7.tar.gzwget http://64.34.161.181/download/3.4.0/sources/nxcompext-3.4.0-1.tar.gzwget http://64.34.161.181/download/3.4.0/sources/nxssh-3.4.0-2.tar.gzwget http://64.34.161.181/download/3.4.0/sources/nxcompsh-3.4.0-2.tar.gzwget http://64.34.161.181/download/3.4.0/sources/nxcompshad-3.4.0-3.tar.gzwget http://64.34.161.181/download/3.4.0/sources/nx-X11-3.4.0-4.tar.gzwget http://64.34.161.181/download/3.4.0/sources/nxauth-3.4.0-3.tar.gzwget 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>./configuremake</pre> <br> 7. Then enter the X folder and make the whole server<br> <pre>cd nx-X11make 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}/libcp -a nx-X11/lib/X11/libX11.so* ${NXPREFIX}/libcp -a nx-X11/lib/Xext/libXext.so* ${NXPREFIX}/libcp -a nx-X11/lib/Xrender/libXrender.so* ${NXPREFIX}/libcp -a nxcomp/libXcomp.so* ${NXPREFIX}/libcp -a nxcompext/libXcompext.so* ${NXPREFIX}/libcp -a nx-X11/programs/Xserver/nxagent ${NXPREFIX}/bincp -a nxproxy/nxproxy ${NXPREFIX}/bincp /usr/NX/lib/libXcomp* /usr/libcp /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.3NXPREFIX=/usr/NXpatch -p0 < gentoo-nomachine.diffmakesudo 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 doneexport PATH=$PATH:/usr/NX/binsudo 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> <br> Just connect to your IGEPv2 box using one of the the NX clients found on www.nomachine.com.<br><br> [[Category:Software]]