General HowTo’s
Installing NX on a PocketPC Linux device
Prepared by:
Bartolo Qualano
N°:
D-309/14-NXE-DOC
Approved by:
Silvia Regis
Signature:
 
Date:
20/06/2007
Amended:
C


General HowTo’s

Installing NX
on a PocketPC
Linux device




Index

  1. Installing NX on a PocketPC Linux Device
  2. NX Client on HP/Compaq iPAQ PocketPC
  3. Connecting iPAQ PocketPC to your desktop computer using PPP
  4. Installation of NX Client on HP/Compaq iPAQ PocketPC



This document refers to NX Client Embedded Edition version 1.3 or earlier and is a brief guide to getting this version of the NX Client installed on a PocketPC Linux Device. This is available as experimental software in the download section of the website:

http://www.nomachine.com/download.php,

and is not currently among the supported OSes in the official NoMachine range.

Installing NX on a PocketPC Linux device

How to install and run NX on a iPAQ or Zaurus Linux device

An embedded version of NX Client is available for HP/Compaq iPAQ and Sharp Zaurus devices. NX Client Embedded Edition includes a version of NX Client software compiled for QT Embedded version of QT toolkit libraries, NX protocol compression software, an X server based on XFree86 kdrive server, SSH client and X utilities needed to configure and run user sessions on a remote NX Server.

All the remote access protocols supported by desktop version of NX Client are supported by the embedded counterpart. This means that NX Client Embedded Edition is able to run X, RDP and VNC sessions without the need for any additional software.

The following document explains, step by step, how to configure and run NX Client on an iPAQ device. The same procedure applies, almost unmodified, to Sharp Zaurus.





NX Client on HP/Compaq iPAQ PocketPC

To use NX Client on HP/Compaq iPAQ PocketPC you need:

  • An iPAQ PocketPC with installed Familiar Linux and OPIE Embedded Palmtop Environment.

Detailed information on how to setup Linux and OPIE on iPAQ are available on http://mstempin.free.fr/linux-ipaq and on http://opie.handhelds.org/usermanual/index.htm. Zaurus users need to install OpenZaurus packages. There are incompatibilities between the kdrive XFree86 server and kernel distributed with the present version of the device.

  • A working network connection to the NX Server.

Information on how to set up PPP serial connection and IP routing are provided below.


Up



Connecting iPAQ PocketPC to your desktop computer using PPP

With the recent releases of Familiar, almost everything has already been set up by the operating system's installation procedures. To test your device's connection to the network you'll need a computer routing the traffic between your device and the LAN or WAN where NX Server is connected. Here's what you need to do to get PPP up and running.

  • Close minicom or any other terminal program that may have a connection to your serial port.
  • If you are getting the message "Connect script failed", the PPP modules were probably not loaded at boot time. This can be fixed by adding the lines "slhc", "ppp_generic", and "ppp_async" to /etc/modules.
  • If this doesn't fix the problem, try to execute this command after login:

    echo "slhc
    ppp_generic
    ppp_async" >> /etc/modules
  • Now, run this command from your desktop computer:

    /usr/sbin/pppd /dev/ttyS0 115200 {IP of your PC}:{IP of your IPAQ}
    nodetach local noauth nocrtscts nodeflate nobsdcomp lock user ppp
    connect "/usr/sbin/chat -v -t3 ogin--ogin: ppp

Add parameter "debug" to the above command if you want to see LCP debugging information.

If connection was successful, local and remote IP addresses will be reported by the PPP daemon. Now the link between the Linux machine and your iPAQ device is running. Now you need to route the traffic coming from the device to the network where your Linux computer is connected.

  • Install the ipchains kernel module on your Linux desktop computer.

Check if ipchains kernel module has already been loaded at boot time by running.

  • Set up the routes from iPAQ to desktop computer's LAN.

NoMachine provides a ready-made IP masquerade script to do this. You will probably need to slightly adapt the script to reflect your network's IP numbers.


Up



Installation of NX Client on HP/Compaq iPAQ PocketPC

  • Download the latest version of NX Client from NoMachine’s web site.
  • Install the package.

The package should have the extension ".arm.ipk.". Open a console window and type the following command:

ipkg install nxembedded-XXX.arm.ipk

  • Restart OPIE.

You should find the NX Client icon on your desktop in the Applications group.

iPAQ is a trademark of Compaq Information Technologies Group
Zaurus is a trademark of Sharp Corporation



Up