NAME

       ltsp-ipxe - install iPXE binaries and configuration in TFTP

SYNOPSIS

       ltsp [ltsp-options] ipxe [-b binaries]

DESCRIPTION

       Generate  the  ltsp.ipxe  configuration  file  and  install  the required iPXE binaries in
       /srv/tftp/ltsp: memtest.0, memtest.efi, snponly.efi and undionly.kpxe.

       An ltsp-binaries package is available in the LTSP PPA that provides them; otherwise,  some
       of them are automatically found in the ipxe/memtest86+ packages.

OPTIONS

       See the ltsp(8) man page for ltsp-options.

       -b, --binaries=[0|1|""]
              Reinstall  the  iPXE  binaries  in TFTP even if they already exist. Defaults to "",
              which means "only install the missing ones". Note that the --overwrite flag doesn't
              affect the binaries, they're only contolled by the --binaries flag.

ADVANCED IMAGE SOURCES

       This section is for advanced LTSP sysadmins. Normally, image sources are simple names like
       "x86_64" or full paths like "../path/to/image". But the "img_src" parameters are much more
       flexible    than    that;    specifically,    they    are   series   of   mount   sources:
       img1,mount-options1,,img2,mount-options2,,...

       ...where img1 may be a simple name or full path relative to  the  current  directory,  and
       img2+ are full paths relative to the target directory.

       Let's  see  an advanced example: suppose that your clients came with Windows, and that you
       copied a live CD into C:\ltsp\ubuntu.iso, and you want your LTSP clients to use  that  for
       speed.  First,  disable  Windows fast boot and hibernation, so that Linux is able to mount
       its partition. Then create the following "method" in ltsp.ipxe:

           :local_image
           # The "local_image" method boots C:\ltsp\ubuntu.iso
           set cmdline_method root=/dev/sda1 ltsp.image=ltsp/ubuntu.iso,fstype=iso9660,loop,ro,,casper/filesystem.squashfs,squashfs,loop,ro loop.max_part=9
           goto ltsp

       Explanation:

       ○   The root=/dev/sda1 parameter tells the initramfs to mount /dev/sda1 into /root.

       ○   Then the LTSP code will look under /root/ltsp/ and mount ubuntu.iso using the  loop,ro
           options over /root again.

       ○   Then  the  LTSP  code will look under /root/casper/ and mount filesystem.squashfs over
           /root again. This casper/filesystem.squashfs path is where the live filesystem  exists
           inside the Ubuntu live CDs.

       So  while  this  long  line gives a good example on using advanced image sources, the LTSP
       code is actually smart enough to autodetect Ubuntu live CDs and filesystem types,  so  one
       could simplify it to:

           :local_image
           # The "local_image" method boots C:\ltsp\${img}.img
           set cmdline_method root=/dev/sda1 ltsp.image=ltsp/${img}.img loop.max_part=9
           goto ltsp

       The  ${img}  parameter  is  the  name  of  the  menu;  it  would be "ubuntu" if you copied
       ubuntu.iso in /srv/ltsp/images/ubuntu.img and ran ltsp ipxe.

EXAMPLES

       Initial use:

           ltsp ipxe

       Regenerate ltsp.ipxe and reinstall the binaries:

           ltsp ipxe -b

       Copy the binaries from a USB stick before running ltsp ipxe:

           mkdir -p /srv/tftp/ltsp
           cd /media/administrator/usb-stick
           cp {memtest.0,memtest.efi,snponly.efi,undionly.kpxe} /srv/tftp/ltsp
           ltsp ipxe

COPYRIGHT

       Copyright 2019 the LTSP team, see AUTHORS

SEE ALSO

       ltsp(8),  ltsp.conf(5),  ltsp-dnsmasq(8),  ltsp-image(8),  ltsp-info(8),   ltsp-initrd(8),
       ltsp-ipxe(8), ltsp-kernel(8), ltsp-nfs(8)