User Tools

Site Tools


wiki:advanced:tce:install

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:advanced:tce:install [2013/11/12 15:20]
sunweaver [Installing X2Go PXE server]
wiki:advanced:tce:install [2017/01/09 19:07] (current)
stefanbaur
Line 1: Line 1:
-====== Installation of the X2Go TCE based on Debian ​======+====== Installation of the classic, NFS-filesystem-based ​X2Go TCE ======
  
 In the following article we will explain how to set up an X2Go Thin Client environment. In the following we will use three technical terms that we want to define/​explain before we start: In the following article we will explain how to set up an X2Go Thin Client environment. In the following we will use three technical terms that we want to define/​explain before we start:
Line 8: Line 8:
  
 <​note>​The X2Go TCE has been developed on/for Debian GNU/Linux. -- You can surely use any GNU/Linux distribution as X2Go Server (providing that the ''​x2goserver''​ package is available for the server'​s distro). The boot environment for the X2Go PXE Server has been developed on Debian GNU/Linux and also been tested on Ubuntu GNU/Linux. The X2Go Thin Client chroot can be configured to use Ubuntu GNU/Linux, but it is __highly recommended__ to leave the defaults and use Debian GNU/Linux for creating the X2Go TCE chroot.</​note>​ <​note>​The X2Go TCE has been developed on/for Debian GNU/Linux. -- You can surely use any GNU/Linux distribution as X2Go Server (providing that the ''​x2goserver''​ package is available for the server'​s distro). The boot environment for the X2Go PXE Server has been developed on Debian GNU/Linux and also been tested on Ubuntu GNU/Linux. The X2Go Thin Client chroot can be configured to use Ubuntu GNU/Linux, but it is __highly recommended__ to leave the defaults and use Debian GNU/Linux for creating the X2Go TCE chroot.</​note>​
 +
 +<​note>​The Debian instructions should also hold for Raspbian, a Debian fork rebuilt on armhf.</​note>​
  
 ===== Network setup ===== ===== Network setup =====
Line 88: Line 90:
  
 With this last step your X2Go Thin Client'​s chroot environment is basically ready for being booted. The last step, however, is to configure the PXE boot manager itself (PXE, TFTP). With this last step your X2Go Thin Client'​s chroot environment is basically ready for being booted. The last step, however, is to configure the PXE boot manager itself (PXE, TFTP).
 +
 +=== Provide firmware for certain hardware devices ===
 +
 +Debian does not ship so-called non-free firmware in its main package archive area. However, several network cards (and other TCE relevant devices) require the installation of a firmware package from Debian non-free.
 +
 +Run the command ''​x2gothinclient_shell''​ and edit ''/​etc/​apt/​sources.list''​ in your TCE chroot (nano, vim and mcedit should be installed in your TCE chroot):
 +<​file>​
 +deb http://​ftp.debian.org/​debian <​distro-codename>​ main contrib non-free
 +</​file>​
 +
 +Then run (in your X2Go TCE chroot):<​code>​
 +$ apt-get update
 +$ apt-get install firmware-linux-nonfree firmware-bnx2 firmware-bnx2x firmware-myricom firmware-netxen ​ firmware-qlogic ​ firmware-ralink firmware-realtek intel-microcode amd64-microcode
 +</​code>​
 +
 +If this command fails, please check if packages have been removed from your Debian version or if they are not yet available for your version. Also scan for other firmware packages:<​code>​
 +$ apt-cache search firmware
 +</​code>​
 +
 +Also, there is a fine tool that you can run on normal Linux systems that helps with the package installation for several special hardware devices: [[http://​packages.debian.org/​unstable/​main/​isenkram|Isenkram by Petter Reinholdtsen]] from the Debian Edu team.
 +
  
 === Boot environment for your X2Go Thin Client system (PXE, TFTP) === === Boot environment for your X2Go Thin Client system (PXE, TFTP) ===
Line 164: Line 187:
 ==== Configuration of x2goclient (display manager mode) ==== ==== Configuration of x2goclient (display manager mode) ====
  
-=== x2goclient ​in LDAP-mode ===+=== X2Go Client ​in LDAP-mode ===
  
 Please feel free to customize the command line options used by the ''​x2goclient'' ​ running in display manager mode. For example you can enable LDAP mode: Please feel free to customize the command line options used by the ''​x2goclient'' ​ running in display manager mode. For example you can enable LDAP mode:
Line 177: Line 200:
 x2goclient --pgp-card \ x2goclient --pgp-card \
            ​--ldap="​192.168.1.1:​389:​dc=<​domain>,​dc=<​tld>"​ \            ​--ldap="​192.168.1.1:​389:​dc=<​domain>,​dc=<​tld>"​ \
-           ​--external-login=/ramdrive/logins \+           ​--external-login=~x2gothinclient/logins \
            ​--no-menu \            ​--no-menu \
            ​--maximize \            ​--maximize \
Line 183: Line 206:
            ​--haltbt \            ​--haltbt \
            ​--link=lan \            ​--link=lan \
-           ​--kbd-layout=de +           ​--kbd-layout=us 
-           ​--kbd-type=pc105/​de \+           ​--kbd-type=pc105/​us \
            ​--set-kbd=1 \            ​--set-kbd=1 \
            ​--geometry=fullscreen \            ​--geometry=fullscreen \
-           --add-to-known-hosts \ +           ​--read-exports-from=~x2gothinclient/export \
-           --read-exports-from=/ramdrive/export \+
            ​--add-to-known-hosts &            ​--add-to-known-hosts &
 </​file>​ </​file>​
Line 198: Line 220:
 </​code>​ </​code>​
  
-=== x2goclient in non-LDAP mode ===+=== X2Go Client in broker mode === 
 + 
 +Please feel free to customize the command line options used by the ''​x2goclient'' ​ running ​in display manager mode. For example you can enable ​LDAP mode: 
 + 
 +<​code>​ 
 +$ editor /​opt/​x2gothinclient/​etc/​x2gothinclient_start 
 +</​code>​ 
 + 
 +The below example uses LDAP-mode for ''​x2goclient'':​ 
 + 
 +<​file>​ 
 +x2goclient --pgp-card \ 
 +           ​--broker-url=https://<​broker-server>:<​port>/​plain/<​backend>​ \ 
 +           ​--broker-cacertfile=<​path-to-your-self-signed-rootca-file>​ 
 +           ​--external-login=~x2gothinclient/​logins \ 
 +           ​--no-menu \ 
 +           ​--maximize \ 
 +           ​--thinclient \ 
 +           ​--haltbt \ 
 +           ​--link=lan \ 
 +           ​--kbd-layout=us \ 
 +           ​--kbd-type=pc105/​us \ 
 +           ​--set-kbd=1 \ 
 +           ​--geometry=fullscreen \ 
 +           ​--read-exports-from=~x2gothinclient/​export \ 
 +           ​--add-to-known-hosts & 
 +</​file>​ 
 + 
 +After modifying the ''​x2gothinclient_start''​ file, update the X2Go Thin Client configuration:​ 
 + 
 +<​code>​ 
 +$ x2gothinclient_update 
 +</​code>​ 
 + 
 + 
 +=== X2Go Client in sessions file mode ===
  
 The Debian GNU/Linux X2Go TCE uses non-LDAP mode as default. Edit the default sessions file in ''/​opt/​x2gothinclient/​etc/​x2gothinclient_sessions''​. The Debian GNU/Linux X2Go TCE uses non-LDAP mode as default. Edit the default sessions file in ''/​opt/​x2gothinclient/​etc/​x2gothinclient_sessions''​.
Line 211: Line 268:
            ​--session="​X2Go.EXAMPLE"​ \            ​--session="​X2Go.EXAMPLE"​ \
            ​--pgp-card \            ​--pgp-card \
-           ​--external-login=/ramdrive/logins \+           ​--external-login=~x2gothinclient/logins \
            ​--no-menu \            ​--no-menu \
            ​--maximize \            ​--maximize \
Line 217: Line 274:
            ​--haltbt \            ​--haltbt \
            ​--link=lan \            ​--link=lan \
-           ​--kbd-layout=de +           ​--kbd-layout=us 
-           ​--kbd-type=pc105/​de \+           ​--kbd-type=pc105/​us \
            ​--set-kbd=1 \            ​--set-kbd=1 \
            ​--geometry=fullscreen \            ​--geometry=fullscreen \
-           --add-to-known-hosts \ +           ​--read-exports-from=~x2gothinclient/export \
-           --read-exports-from=/ramdrive/export \+
            ​--add-to-known-hosts &            ​--add-to-known-hosts &
 </​file>​ </​file>​
wiki/advanced/tce/install.1384269603.txt.gz · Last modified: 2013/11/12 15:20 by sunweaver