====== Návod na instalaci LTSP ======

Linux Terminal Server Project -- linux s tenkými klienty

Postupujeme podle návodu na [[http://ltsp.org/docs/installation]] a na [[https://wiki.debian.org/LTSP/Howto]].

Při instalaci zvolíme metodu dvou interfaceů. Druhý interface musí být nakonfigurovaný před instalací ''ltsp''. Musí se vyplnit IP adresa a maska, ale **ne GW**. Chceme-li jinou IP, než je defaultně nastavená (192.168.67.1), máme smůlu. Je to tam někde zadrátované.

Posloupnost kroků při instalaci:
  * Nejjednodušší je nechat si přidělit IP od DHCP serveru:<code>ltsp dnsmasq</code><code>Installed /usr/share/ltsp/server/dnsmasq/ltsp-dnsmasq.conf in /etc/dnsmasq.d/ltsp-dnsmasq.conf
Restarted dnsmasq</code>
  * Client image (chrootless):<code>ltsp image /</code>Tento krok se musí opakovat při každém přidání SW do image.
  * Konfigurace iPXE:<code>ltsp ipxe</code>Tento krok se musí opakovat, pokud jsme provedli ''ltsp image''.
  * NFS server:<code>ltsp nfs</code>
  * ltsp.img:<code>ltsp initrd</code>Tento krok se musí udělat po každém updatu ltsp, po přidání uživatele, nebo po úpravě ''/etc/ltsp/ltsp.conf''.

===== Updaty image =====

Při každém přidání/změně softwaru na serveru se musí vygenerovat nový image. Trvá to již docela dlouho, proto se to dělá přes noc pomocí ''crontabu''. Dalším důvodem je to, že se dělají pravidelné updaty.

Nový image se vytvoří pomocí skriptu
<file bash update-ltsp.sh>
#!/bin/bash

if [[ $EUID -ne 0 ]]; then
    echo "This script must be run as root (sudo bash -l)" 1>&2
    print_help
    exit 1
fi

echo "IMAGE"
ltsp image /
echo "IPXE"
ltsp ipxe
echo "NFS"
ltsp nfs
echo "INITRD"
ltsp initrd
</file>

==== Kde jsou všechny image (pro ipxe) ====

<code>-rw-r--r-- 1 root root 169362625 Feb 18 06:06 /srv/tftp/ltsp/x86_64/initrd.img
-rw-r--r-- 1 root root  14928264 Jan 15 17:51 /srv/tftp/ltsp/x86_64/vmlinuz
IPXE
Installed /usr/share/ltsp/server/ipxe/ltsp.ipxe in /srv/tftp/ltsp/ltsp.ipxe
Skipped existing /srv/tftp/ltsp/memtest.0
Skipped existing /srv/tftp/ltsp/memtest.efi
Skipped existing /srv/tftp/ltsp/snponly.efi
Skipped existing /srv/tftp/ltsp/undionly.kpxe
NFS
Installed /usr/share/ltsp/server/nfs/ltsp-nfs.exports in /etc/exports.d/ltsp-nfs.exports
Restarted nfs-kernel-server
INITRD
Generated ltsp.img:
-rw-r--r-- 1 root root 171520 Feb 20 18:41 /srv/tftp/ltsp/ltsp.img
</code>

{{anchor:conf}}
===== Konfigurace LTSP =====

Konfigurace se provádí v souboru ''/etc/ltsp/ltsp.conf''. Ten je rozdělen na sekce ''[server]'', ''[common]'', ''[clients]'' a případně další týkající se jednotlivých klientů nebo monitorů (viz [[http://ltsp.org/man/ltsp.conf/]]).


==== Úpravy provedené u nás ====

  - Sekce ''[server]''
    * <code>NFS_HOME=1</code>Namountuje adresář ''/home'', takže vše, co uživatelé zapíší na klientovi do svého adresáře, se zapisuje na disk na chomském.
    * <code>OMIT_FUNCTIONS="remove_printers"</code>Nutné pro to, abychom viděli tiskárny.
  - Sekce ''[clients]''
    * <code>IMAGE_TO_RAM=0</code>Image se stále čte z disku, šetří se tím paměť.
    * <code>REMOTEAPPS="users-admin mate-about-me seamonkey emacs google-chrome google-chrome-stable"</code>Tyto aplikace běží na serveru. Šetří se tím prostředky klienta.
    * <code># LOCAL_SWAP=0</code>Tímhle se taky šetří prostředky, ale když nemáme lokální disk, je to jedno.
    * <code>
FSTAB_CNK="ada:/mnt/cnk-cephfs  /cnk    nfs     auto,nofail,noatime,nolock,intr,tcp,actimeo=1800        0       0"
FSTAB_HOME="server:/home        /home   nfs     defaults,nolock 0       0"
FSTAB_STORE="server:/store      /store  nfs     defaults,nolock 0       0"
FSTAB_STORE2="server:/store2    /store2 nfs     defaults,nolock 0       0"
FSTAB_SYN2020="server:/usr/local/syn2020        /usr/local/syn2020      nfs     defaults,nolock 0       0"
</code>Tyto řádky se přidají do lokálního ''/etc/fstab'' a namountují se příslušné disky. Data zapsaná na tyto disky jsou tak zachována.
    * <code>CUPS_SERVER="ignore"</code>Ignorujeme CUPS server na LTSP serveru, ale zkopírujeme tiskárny do lokálního LTSP serveru.
    * <code>HOSTS_JAKOBSON="78.128.204.173  jakobson"
HOSTS_JAKOBSON723="192.168.128.1        jakobson.723"
HOSTS_GRIMM="78.128.204.175     grimm"
HOSTS_GRIMM723="192.168.128.4   grimm.723"
</code>Přidáme tyto adresy do lokálního souboru ''/etc/hosts''.<code>HOSTS_KORPUS="195.113.53.66     korpus.cz"
HOSTS_FF="195.113.53.2  ff.cuni.cz"
</code>Tyto dvě adresy musíme přidat proto, že DNS server přiřadí jména prohledávaných domén k adrese ''127.0.1.1''.
    * <code>
POST_INIT_SUDO="sed '/^sudo:/ s/$/,skoumal,jelinek,pavelv/' -i /etc/group"
POST_INIT_EPO="sed '/^epoptes:/ s/$/,skoumal,jelinek/' -i /etc/group"
POST_INIT_AUDIO="sed '/^audio:/ s/$/,skoumal,jelinek,petkevic,rosen,krivan,hnatkova,sindlerova/' -i /etc/group"
POST_INIT_PULSE="sed '/^pulse:/ s/$/skoumal,jelinek,petkevic,rosen,krivan,hnatkova,sindlerova/' -i /etc/group"
POST_INIT_PULSEACCESS="sed '/^pulse-access:/ s/$/skoumal,jelinek,petkevic,rosen,krivan,hnatkova,sindlerova/' -i /etc/group"
</code>Takto upravujeme lokální soubor '/etc/group'.
    * <code>LIGHTDM_CONF="greeter-setup-script=/usr/bin/numlockx on"</code>Tímhle zařídíme zapnutý Numlock při přihlašování.
    * <code>PASSWORDS_ANY="local-admin/VmVsZTQsOG4K"</code>umožní přihlásit se uživateli ''local-admin'' z klienta. Heslo se získá pomocí příkazu ''base64'':<code>base64
heslo_v_plain_textu
Ctrl-D</code>

===== Zvuk =====

Měl by fungovat "sám od sebe", jenom je třeba přidat všechny uživatele do skupiny ''audio'', ''pulse'' a ''pulse-access'' (viz [[wiki:user:skoumal:ltsp#conf|výše]]). Několik programů, které nám vypíšou zvukové karty, umožní mixáž zvuku a otestují výstup:
  * <code>aplay -l</code>Co vidí ALSA.
  * <code>pacmd list-cards</code>Co vidí pulseaudio.
  * <code>alsamixer</code>
  * <code>pulsemixer</code>
  * <code>speaker-test -t wav</code>
Pokud vše funguje, všechno nastavíme a otestujeme v Sound Settings.

Pokud zvuk nefunguje, je třeba zkontrolovat konfigurační soubory, hlavně jestli uživatelé u sebe nemají nějaké staré šunky.