Differences between revisions 52 and 53
Revision 52 as of 2010-01-28 19:49:47
Size: 4006
Editor: ?MathisDirksen-Thedens
Comment: added description of the 'portmap trap'
Revision 53 as of 2010-12-21 05:05:51
Size: 4106
Editor: GeoffSimmons
Comment: Add translation header, drop Etch links, formatting.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#language en
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: [[pt_BR/LTSP/Howto|Português Brasileiro]]-~
----
= LTSP How To =
Line 3: Line 8:
== Installing LTSP on Lenny ==
Line 4: Line 10:
= Installing LTSP on Lenny =

1. if you want a complete LTSP server with all the bells and whistles:

{{{
 1. If you want a complete LTSP server with all the bells and whistles: {{{
Line 12: Line 14:
if you want more fine-grained control, splitting some services off to separate servers, you can install "ltsp-server" instead, and manually install each of the other services.  If you want more fine-grained control, splitting some services off to separate servers, you can install DebianPkg:ltsp-server instead, and manually install each of the other services.
Line 14: Line 16:
(you can also get backported packages for lenny: [[LTSP/Howto/Lenny-With-Backports]] )  (you can also get backported packages for lenny: [[LTSP/Howto/Lenny-With-Backports]])
Line 16: Line 18:
2. Build the LTSP client environment:

{{{
 1. Build the LTSP client environment: {{{
Line 22: Line 22:
If you're installing a different debian distribution than what's on the server, you will need to specify the --dist xxx commandline option. where xxx is your Debian distribution (e.g. lenny, etch). See /usr/share/debootstrap/scripts/.  If you're installing a different Debian distribution than what's on the server, you will need to specify the `--dist xxx` commandline option. where xxx is your Debian distribution (e.g. lenny, squeeze). See /usr/share/debootstrap/scripts/ and the [[Debootstrap]] page.<<BR>>
 ltsp-build-client will download a complete Debian filesystem into /opt/ltsp/i386 (or specify an alternate location with `--base`) and install the DebianPkg:ltsp-client and DebianPkg:ldm packages (the LTSP Display Manager). Typically, you will need a desktop environment like [[Gnome]] or [[Xfce]], or a window manager such as icewm installed on the server (NOT in the chroot).
Line 24: Line 25:
ltsp-build-client will download a complete Debian filesystem into /opt/ltsp/i386 (or specify an alternate location with '--base') and install the ltsp-client and ldm packages (the LTSP Display Manager). Typically, you will need a desktop environment like gnome or xfce, or a window manager such as icewm installed on the server (NOT in the chroot).  If you change the IP data after you have done the initial setup, run `ltsp-update-sshkeys` on the server.
Line 26: Line 27:
 The files the client will boot are installed on the server into /var/lib/tftpboot.
Line 27: Line 29:
If you change the IP data after you have done the initial setup and run `ltsp-update-sshkeys` on the server.  1. Configure /etc/dhcp3/dhcpd.conf and /etc/ltsp/dhcpd.conf:
Line 29: Line 31:
The files the client will boot are installed on the server into /var/lib/tftpboot.  Edit /etc/ltsp/dhcpd.conf to adapt to your network. See examples in /usr/share/doc/ltsp-server/examples/dhcpd.conf as a reference.
Line 31: Line 33:
3. Configure /etc/dhcp3/dhcpd.conf and /etc/ltsp/dhcpd.conf:

Edit /etc/ltsp/dhcpd.conf to adapt to your network. See examples in /usr/share/doc/ltsp-server/examples/dhcpd.conf as a reference.

Include the LTSP dhcpd.conf at the bottom of /etc/dhcp3/dhcpd.conf

{{{
 Include the LTSP dhcpd.conf at the bottom of /etc/dhcp3/dhcpd.conf: {{{
Line 41: Line 37:
Restart dhcp3-server:

{{{
 Restart dhcp3-server: {{{
Line 47: Line 41:
Alternately, configure /etc/dnsmasq.conf:

See example in /usr/share/doc/ltsp-server/examples/dhcpd-dnsmasq and adapt to your network.
 Alternately, configure /etc/dnsmasq.conf. See the example in /usr/share/doc/ltsp-server/examples/dhcpd-dnsmasq and adapt to your network.
Line 51: Line 43:
Restart dnsmasq:

{{{
 Restart dnsmasq: {{{
Line 57: Line 47:
4. Configure /etc/exports:

{{{
 1. Configure /etc/exports: {{{
Line 63: Line 51:
Restart nfs-kernel-server:

{{{
 Restart nfs-kernel-server: {{{
Line 69: Line 55:
Now make sure that portmap is '''not''' started on the loopback interface only. Look into /etc/default/portmap and verify that there is '''no''' line saying
{{{#!wiki red/solid
 Now make sure that portmap is '''not''' started on the loopback interface only. Look into /etc/default/portmap and verify that there is '''no''' line saying {{{#!wiki red/solid
Line 74: Line 59:
If there is such a line, comment it out by prepending a # character and restart portmap by
{{{
 If there is such a line, comment it out by prepending a # character and restart portmap by: {{{
Line 79: Line 63:
5. Start tftpd. By default, tftpd-hpa is started from inetd. you may need to restart inetd after installing tftpd-hpa.

{{{
 1. Start tftpd. By default, tftpd-hpa is started from inetd. you may need to restart inetd after installing tftpd-hpa: {{{
Line 85: Line 67:
Alternately, edit /etc/default/tftpd-hpa to have tftpd-hpa start on it's own.

{{{
 Alternately, edit /etc/default/tftpd-hpa to have tftpd-hpa start on its own: {{{
Line 91: Line 71:
Then, comment the tftpd entry in /etc/inetd.conf.

{{{
 Then, comment the tftpd entry in /etc/inetd.conf: {{{
Line 97: Line 75:
restart inetd.

{{{
 Restart inetd: {{{
Line 103: Line 79:
and restart tftpd-hpa

{{{
 and restart tftpd-hpa: {{{
Line 109: Line 83:
6. Boot a PXE or Etherboot capable machine and enjoy. note that some older versions of etherboot do not support ELF images, and may not work without additional configuration.

= Installing LTSP on Etch =

[[LTSP/Howto/Etch]]

using newer LTSP packages with Etch:

[[LTSP/Howto/Etch-With-Backports]]
 1. Boot a PXE or Etherboot capable machine and enjoy.  Note that some older versions of etherboot do not support ELF images, and may not work without additional configuration.
Line 121: Line 87:
Two important configuration files inside the client are /var/lib/tftpboot/ltsp/i386/lts.conf (or /opt/ltsp/i386/etc/lts.conf for NFS) and /opt/ltsp/i386/etc/default/ltsp-client-setup. See the examples in /opt/ltsp/i386/usr/share/doc/ltsp-client*.   Also see the Edubuntu wiki http://doc.ubuntu.com/edubuntu/edubuntu/handbook/C/customizing-thin-client.html (note: Debian LTSP still uses NFS by default). Two important configuration files inside the client are /var/lib/tftpboot/ltsp/i386/lts.conf (or /opt/ltsp/i386/etc/lts.conf for NFS) and /opt/ltsp/i386/etc/default/ltsp-client-setup. See the examples in /opt/ltsp/i386/usr/share/doc/ltsp-client*.
Line 123: Line 89:
== Translations == See also see the Edubuntu wiki http://doc.ubuntu.com/edubuntu/edubuntu/handbook/C/customizing-thin-client.html (note: Debian LTSP still uses NFS by default).
Line 125: Line 91:
Portuguese Brazil [[http://wiki.debian.org/pt_BR/LTSP/Howto]] ----
## If this page belongs to an existing Category, add it below.
## CategorySomething | CategoryAnother

Translation(s): Português Brasileiro


LTSP How To

Upstream documentation with official, detailed information about installing LTSP is at http://sourceforge.net/apps/mediawiki/ltsp/index.php?title=Ltsp_LtspDocumentationUpstream.

Installing LTSP on Lenny

  1. If you want a complete LTSP server with all the bells and whistles:

    apt-get install ltsp-server-standalone

    If you want more fine-grained control, splitting some services off to separate servers, you can install ltsp-server instead, and manually install each of the other services.

    (you can also get backported packages for lenny: LTSP/Howto/Lenny-With-Backports)

  2. Build the LTSP client environment:

    ltsp-build-client

    If you're installing a different Debian distribution than what's on the server, you will need to specify the --dist xxx commandline option. where xxx is your Debian distribution (e.g. lenny, squeeze). See /usr/share/debootstrap/scripts/ and the Debootstrap page.
    ltsp-build-client will download a complete Debian filesystem into /opt/ltsp/i386 (or specify an alternate location with --base) and install the ltsp-client and ldm packages (the LTSP Display Manager). Typically, you will need a desktop environment like Gnome or Xfce, or a window manager such as icewm installed on the server (NOT in the chroot).

    If you change the IP data after you have done the initial setup, run ltsp-update-sshkeys on the server. The files the client will boot are installed on the server into /var/lib/tftpboot.

  3. Configure /etc/dhcp3/dhcpd.conf and /etc/ltsp/dhcpd.conf: Edit /etc/ltsp/dhcpd.conf to adapt to your network. See examples in /usr/share/doc/ltsp-server/examples/dhcpd.conf as a reference.

    Include the LTSP dhcpd.conf at the bottom of /etc/dhcp3/dhcpd.conf:

    include "/etc/ltsp/dhcpd.conf";

    Restart dhcp3-server:

    invoke-rc.d dhcp3-server restart
    Alternately, configure /etc/dnsmasq.conf. See the example in /usr/share/doc/ltsp-server/examples/dhcpd-dnsmasq and adapt to your network.

    Restart dnsmasq:

    invoke-rc.d dnsmasq restart
  4. Configure /etc/exports:

    /opt/ltsp *(ro,no_root_squash,async,no_subtree_check)

    Restart nfs-kernel-server:

    invoke-rc.d nfs-kernel-server restart

    Now make sure that portmap is not started on the loopback interface only. Look into /etc/default/portmap and verify that there is no line saying

    OPTIONS="-i 127.0.0.1"

    If there is such a line, comment it out by prepending a # character and restart portmap by:

    invoke-rc.d portmap restart
  5. Start tftpd. By default, tftpd-hpa is started from inetd. you may need to restart inetd after installing tftpd-hpa:

    invoke-rc.d openbsd-inetd restart

    Alternately, edit /etc/default/tftpd-hpa to have tftpd-hpa start on its own:

    RUN_DAEMON="yes"

    Then, comment the tftpd entry in /etc/inetd.conf:

    #tftp           dgram   udp     wait    root  /usr/sbin/in.tftpd /usr/sbin/in.tftpd -s /var/lib/tftpboot

    Restart inetd:

    invoke-rc.d openbsd-inetd restart

    and restart tftpd-hpa:

    invoke-rc.d tftpd-hpa restart
  6. Boot a PXE or Etherboot capable machine and enjoy. Note that some older versions of etherboot do not support ELF images, and may not work without additional configuration.

Customizations in the chroot

Two important configuration files inside the client are /var/lib/tftpboot/ltsp/i386/lts.conf (or /opt/ltsp/i386/etc/lts.conf for NFS) and /opt/ltsp/i386/etc/default/ltsp-client-setup. See the examples in /opt/ltsp/i386/usr/share/doc/ltsp-client*.

See also see the Edubuntu wiki http://doc.ubuntu.com/edubuntu/edubuntu/handbook/C/customizing-thin-client.html (note: Debian LTSP still uses NFS by default).