/[gentoo]/xml/htdocs/doc/en/ltsp.xml
Gentoo

Diff of /xml/htdocs/doc/en/ltsp.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.10 Revision 1.17
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/Attic/ltsp.xml,v 1.10 2004/10/09 13:10:39 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/Attic/ltsp.xml,v 1.17 2006/11/28 20:01:21 nightmorph Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/ltsp.xml"> 5<guide link="/doc/en/ltsp.xml">
6<title>Gentoo - LTSP Guide</title> 6<title>Gentoo - LTSP Guide</title>
7<author title="Author"> 7<author title="Author">
9</author> 9</author>
10<author title="Author"> 10<author title="Author">
11 <mail link="josiah@ritchietribe.net">Josiah Ritchie</mail> 11 <mail link="josiah@ritchietribe.net">Josiah Ritchie</mail>
12</author> 12</author>
13<author title="Editor"> 13<author title="Editor">
14 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 14 <mail link="sven.vermeulen@siphos.be">Sven Vermeulen</mail>
15</author> 15</author>
16 16
17<abstract> 17<abstract>
18This guide shows you how to setup a LTSP Server with Gentoo. 18This guide shows you how to setup a LTSP Server with Gentoo.
19</abstract> 19</abstract>
20 20
21<license/> 21<license/>
22 22
23<version>1.7</version> 23<version>1.12</version>
24<date>October 09, 2004</date> 24<date>2006-11-28</date>
25
25<chapter> 26<chapter>
26<title>Introduction</title> 27<title>Introduction</title>
27<section> 28<section>
28<title>What is LTSP?</title> 29<title>What is LTSP?</title>
29<body> 30<body>
31
30<p> 32<p>
31LTSP is an abbreviation for "Linux Terminal Server Project". Installed 33LTSP is an abbreviation for "Linux Terminal Server Project". Installed
32on a server it can supply many workstations (so called thin-clients) 34on a server it can supply many workstations (so called thin-clients)
33with identical environments. All applications run on the server and 35with identical environments. All applications run on the server and
34therefore you can use old PCs and convert them into XTerminals. This 36therefore you can use old PCs and convert them into XTerminals. This
35reduces costs and maintenance especially in an environment where you 37reduces costs and maintenance especially in an environment where you
36need to have an uniform workspace on each computer you login, e.g. in 38need to have an uniform workspace on each computer you login, e.g. in
37schools or firms. 39schools or firms.
38</p> 40</p>
41
39</body> 42</body>
40</section> 43</section>
41</chapter> 44</chapter>
42<chapter> 45<chapter>
43<title>Installation</title> 46<title>Installation</title>
44<section> 47<section>
45<title>Preliminaries</title> 48<title>Preliminaries</title>
46<body> 49<body>
50
47<p> 51<p>
48All of the examples in this document presume that your server's IP is 52All of the examples in this document presume that your server's IP is
49192.168.0.254, your domain is named yourdomain.com and your network is 53192.168.0.254, your domain is named yourdomain.com and your network is
50192.168.0.0/24. 54192.168.0.0/24.
51</p> 55</p>
56
52</body> 57</body>
53</section> 58</section>
54<section> 59<section>
55<title>Installation</title> 60<title>Installation</title>
56<body> 61<body>
60Gentoo Installation Manual for your architecture on <uri 65Gentoo Installation Manual for your architecture on <uri
61link="http://www.gentoo.org/doc">Gentoo's Documentation Website</uri>. 66link="http://www.gentoo.org/doc">Gentoo's Documentation Website</uri>.
62</p> 67</p>
63 68
64<p> 69<p>
65Then lets begin with the easiest step, installing the ltsp core 70Then lets begin with the easiest step, installing the ltsp package:
66utils:
67</p> 71</p>
68 72
69<pre caption="Emerge LTSP"> 73<pre caption="Emerge LTSP">
70# <i>emerge ltsp-core</i> 74# <i>emerge ltsp</i>
71</pre> 75</pre>
72 76
73<p> 77<p>
74This will install the following packages as dependencies: 78This will install the following packages as dependencies:
75</p> 79</p>
76 80
77<ul> 81<ul>
78<li><b>XFree</b>: They are called XTerminals, guess why :)</li> 82 <li><b>XFree</b>: They are called XTerminals, guess why :)</li>
83 <li>
79<li><b>DHCP</b>: DHCP is a protocol for automating the configuration of 84 <b>DHCP</b>: DHCP is a protocol for automating the configuration of
80computers that use TCP/IP, used by ltsp to distribute IPs to the 85 computers that use TCP/IP, used by ltsp to distribute IPs to the
81workstations.</li> 86 workstations.
87 </li>
88 <li>
82<li><b>NFS</b>: NFS is a protocol to allow access to harddisks through 89 <b>NFS</b>: NFS is a protocol to allow access to harddisks through
83the network, used by ltsp to mount a base system for the 90 the network, used by ltsp to mount a base system for the
84workstations.</li> 91 workstations.
92 </li>
93 <li>
85<li><b>TFTP</b>: TFTP is a simple file transfer protocol, used by ltsp 94 <b>TFTP</b>: TFTP is a simple file transfer protocol, used by ltsp
86to transfer the kernel to the workstations.</li> 95 to transfer the kernel to the workstations.
96 </li>
97 <li>
87<li><b>XINETD</b>: Xinetd is a powerful replacement for inetd, with 98 <b>XINETD</b>: Xinetd is a powerful replacement for inetd, with
88advanced features, used by ltsp to start tftp.</li> 99 advanced features, used by ltsp to start tftp.
100 </li>
89</ul> 101</ul>
90 102
91<note> 103<note>
92If you have the kde/gnome useflag set, it will also install a complete kde/gnome system. 104If you have the kde/gnome useflag set, it will also install a complete kde/gnome system.
93</note> 105</note>
190 socket_type = dgram 202 socket_type = dgram
191 protocol = udp 203 protocol = udp
192 wait = yes 204 wait = yes
193 user = root 205 user = root
194 server = /usr/sbin/in.tftpd 206 server = /usr/sbin/in.tftpd
207 server_args = -s /tftpboot
195} 208}
196</pre> 209</pre>
197 210
198<p> 211<p>
199Now edit <path>/etc/xinetd.conf</path> and comment out the line <c>only_from = localhost</c> by prefacing it with a <c>#</c>. Finally, start xinetd. 212Now edit <path>/etc/xinetd.conf</path> and comment out the line <c>only_from = localhost</c> by prefacing it with a <c>#</c>. Finally, start xinetd.
240valid DHCP Config (<path>/etc/dhcp/dhcpd.conf</path>). Here is an 253valid DHCP Config (<path>/etc/dhcp/dhcpd.conf</path>). Here is an
241example: 254example:
242</p> 255</p>
243 256
244<pre caption = "dhcpd.conf"> 257<pre caption = "dhcpd.conf">
245<codenote>Some general options</codenote> 258<comment>(Some general options)</comment>
246default-lease-time 21600; 259default-lease-time 21600;
247max-lease-time 21600; 260max-lease-time 21600;
248use-host-decl-names on; 261use-host-decl-names on;
249ddns-update-style ad-hoc; 262ddns-update-style ad-hoc;
250 263
251<codenote>Bootp options</codenote> 264<comment>(Bootp options)</comment>
252allow booting; 265allow booting;
253allow bootp; 266allow bootp;
254 267
255<codenote>Network Options</codenote> 268<comment>(Network Options)</comment>
256option subnet-mask 255.255.255.0; 269option subnet-mask 255.255.255.0;
257option broadcast-address 192.168.0.255; 270option broadcast-address 192.168.0.255;
258option routers 192.168.0.254; 271option routers 192.168.0.254;
259option domain-name-servers 192.168.0.254; 272option domain-name-servers 192.168.0.254;
260option log-servers 192.168.0.254; 273option log-servers 192.168.0.254;
261option domain-name "yourdomain.com"; 274option domain-name "yourdomain.com";
262 275
263<codenote>LTSP Path Options</codenote> 276<comment>(LTSP Path Options)</comment>
264option root-path "192.168.0.254:/opt/ltsp-4.1/i386"; 277option root-path "192.168.0.254:/opt/ltsp-4.1/i386";
265filename "/lts/vmlinuz-2.4.26-ltsp-2"; 278filename "/lts/vmlinuz-2.4.26-ltsp-2";
279<comment>(Address of the tftp server to download the ltsp file from)</comment>
280next-server 192.168.0.254;
266 281
267<codenote>If your workstations have ISA NICs uncomment the following</codenote> 282<comment>(If your workstations have ISA NICs uncomment the following)</comment>
268<codenote>lines and alter the driver and IO</codenote> 283<comment>(lines and alter the driver and IO)</comment>
269#option option-128 code 128 = string; 284#option option-128 code 128 = string;
270#option option-129 code 129 = text; 285#option option-129 code 129 = text;
271#option option-128 e4:45:74:68:00:00; 286#option option-128 e4:45:74:68:00:00;
272#option option-129 "NIC=ne IO=0x300"; 287#option option-129 "NIC=ne IO=0x300";
273 288
274shared-network WORKSTATIONS { 289shared-network WORKSTATIONS {
275 subnet 192.168.0.0 netmask 255.255.255.0 { 290 subnet 192.168.0.0 netmask 255.255.255.0 {
276 <codenote>Distribute dynamic IPs to the workstations</codenote> 291 <comment>(Distribute dynamic IPs to the workstations)</comment>
277 range dynamic-bootp 192.168.0.1 192.168.0.16; 292 range dynamic-bootp 192.168.0.1 192.168.0.16;
278 <codenote>Workstation specific configuration for PXE booting</codenote> 293 <comment>(Workstation specific configuration for PXE booting)</comment>
279 #host ws001 { 294 #host ws001 {
280 # hardware ethernet 00:E0:06:E8:00:84; 295 # hardware ethernet 00:E0:06:E8:00:84;
281 # fixed-address 192.168.0.1; 296 # fixed-address 192.168.0.1;
282 #} 297 #}
283 } 298 }

Legend:
Removed from v.1.10  
changed lines
  Added in v.1.17

  ViewVC Help
Powered by ViewVC 1.1.20