• Installation FAQ
• Windows
  • Installation issues for Windows7 64bit / Windows Server 2008 r2
• Linux
  • No X11 DISPLAY ... error when installing from the linux console
    • Best Solution - Install with X-Forwarding
    • Another Workaround: Install OpenthinClient on your Linux or Windows Workstation

Installation FAQ

Windows

Installation issues for Windows7 64bit / Windows Server 2008 r2

You need to install the 32bit version of SUN Java otherwise you encounter an error during the installation and the program icons are not created within the startmenu.

1. Install Java

• Go to http://www.java.com/en/download/manual.jsp
• Download: Windows 7/XP/Vista/2000/2003/2008 Offline (32-bit) The name of the executable should contain i586. For example: jre-6u18-windows-i586-s.exe
• Install the SUN Java 32bit version

2. Install openthinclient:

• Go to the run box and type cmd

Now instead of hitting the Enter key, use Ctrl+Shift + Enter. You will be prompted with the User Account Control dialog and then the command prompt in Administrator mode will be opened.

• Execute the following command. Change USER to your actual username and the path to your Downloads directory if needed.

3. Connect to the manager locally (Not required if administration is only done remotely)
The SUN Java 6 32bit version does not register any file type associations for java. This means the "Manager" shortcut
from the start menu and the connection with the browser url http://localhost:8080/ does not work.

Available Workarounds:

• Install the SUN Java6 64bit Version
• Change the target for the "Manager" icon to

Linux

No X11 DISPLAY ... error when installing from the linux console

If you are trying to install the software and get this error message:

For now the installer needs a running X-Server (graphical user interface) to perform the installation

Best Solution - Install with X-Forwarding

• Install Sun JAVA on both your workstation and the server
• Prepare the server for ssh X-Forwarding:
  • Install xauth and other additional packages: (For Debian/Ubuntu the packages xauth and x11-common will do fine)
  • Set X11Forwarding yes in your sshd_config

On the Workstation execute:

After connecting to the server the installer should now work as usual with:

Another Workaround: Install OpenthinClient on your Linux or Windows Workstation

Install the OpenThinClient Server on your workstation and copy the contents of the installation folder (usually /opt/openthinclient) to your server. Make sure to use tar,rsync or your prefered tool to preserve the file permissions. You can then remove the installation on your workstation with the uninstaller.

Notice: Please do not start the manager until you moved it to the server because it will break the package management.

Then Recreate the startscript and add it to the default runlevel
On the server recreate the symlink to the startscript:

Then add the startscript to the default runlevel

FIXME: description how to add runlevels on current distributions.