.\" generated with Ronn-NG/v0.8.0
.\" http://github.com/apjanke/ronn-ng/tree/0.8.0
.TH "LTSP\-IPXE" "8" "October 2019" "LTSP 19.10-1" "LTSP Manual"
.SH "NAME"
\fBltsp\-ipxe\fR \- install iPXE binaries and configuration in TFTP
.SH "SYNOPSIS"
\fBltsp\fR [\fIltsp\-options\fR] \fBipxe\fR [\fB\-b\fR \fIbinaries\fR] [\fB\-u\fR \fIbinaries\-url\fR]
.SH "DESCRIPTION"
Generate the ltsp\.ipxe configuration file in /srv/tftp/ltsp and download the required iPXE binaries: memtest\.0, memtest\.efi, snponly\.efi and undionly\.kpxe\.
.P
If an Internet connection isn\'t available, you need to manually download those binaries from https://boot\.ipxe\.org or our github mirror site before running \fBltsp ipxe\fR to generate the configuration\.
.SH "OPTIONS"
See the \fBltsp(8)\fR man page for \fIltsp\-options\fR\.
.TP
\fB\-b\fR, \fB\-\-binaries=\fR\fI[0|1|""]\fR
Download the iPXE binaries again even if they already exist\. Defaults to "", which means "only download the missing ones"\. Note that the \-\-overwrite flag doesn\'t affect the binaries, they\'re only contolled by the \-\-binaries flag\.
.TP
\fB\-u\fR, \fB\-\-binaries\-url=\fR\fIURL\fR
Specify a different URL for the binaries\. Defaults to https://github\.com/ltsp/binaries/releases/latest/download\. They\'re periodically mirrored there to avoid straining ipxe\.org and so that LTSP users have similar iPXE versions\.
.SH "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,,\|\.\|\.\|\.
.P
\|\.\|\.\|\.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\.
.P
Let\'s see an advanced example: suppose that your clients came with Windows, and that you copied a live CD into C:\eltsp\eubuntu\.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:
.IP "" 4
.nf
:local_image
# The "local_image" method boots C:\eltsp\eubuntu\.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
.fi
.IP "" 0
.P
Explanation:
.IP "\[ci]" 4
The root=/dev/sda1 parameter tells the initramfs to mount /dev/sda1 into /root\.
.IP "\[ci]" 4
Then the LTSP code will look under /root/ltsp/ and mount ubuntu\.iso using the loop,ro options over /root again\.
.IP "\[ci]" 4
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\.
.IP "" 0
.P
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:
.IP "" 4
.nf
:local_image
# The "local_image" method boots C:\eltsp\e${img}\.img
set cmdline_method root=/dev/sda1 ltsp\.image=ltsp/${img}\.img loop\.max_part=9
goto ltsp
.fi
.IP "" 0
.P
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 \fBltsp \-o ipxe\fR\.
.SH "EXAMPLES"
Initial use:
.IP "" 4
.nf
ltsp ipxe
.fi
.IP "" 0
.P
Regenerate ltsp\.ipxe and redownload the binaries:
.IP "" 4
.nf
ltsp \-o ipxe \-b
.fi
.IP "" 0
.P
Force downgrading to an older version of the binaries:
.IP "" 4
.nf
ltsp \-o ipxe \-b \-u \'https://github\.com/ltsp/binaries/releases/download/v19\.07\'
.fi
.IP "" 0
.P
Copy the binaries from a USB stick before running ltsp ipxe:
.IP "" 4
.nf
mkdir \-p /srv/tftp/ltsp
cd /media/administrator/usb\-stick
cp {memtest\.0,memtest\.efi,snponly\.efi,undionly\.kpxe} /srv/tftp/ltsp
ltsp ipxe
.fi
.IP "" 0
.SH "COPYRIGHT"
Copyright 2019 the LTSP team, see AUTHORS
.SH "SEE ALSO"
\fBltsp\fR(8), \fBltsp\.conf\fR(5), \fBltsp\-dnsmasq\fR(8), \fBltsp\-image\fR(8), \fBltsp\-info\fR(8), \fBltsp\-initrd\fR(8), \fBltsp\-ipxe\fR(8), \fBltsp\-kernel\fR(8), \fBltsp\-nfs\fR(8)