'\" -*- coding: utf-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH x2gothinclient_preptftpboot 8 "Nov 2019" "Version 1.5.0.x" "X2Go Thin Client Environment"
.SH NAME
x2gothinclient_preptftpboot \- Prepare PXE/Syslinux Boot Environment (delivered via tftpd) on X2Go PXE Server.
.SH SYNOPSIS
'nh
.fi
.ad l
\fBx2gothinclient_preptftpboot\fR

.SH DESCRIPTION
This helper script prepares X2Go's PXE/Syslinux boot environment. As X2Go PXE
server you can either use your X2Go server itself or a dedicated machine or VM that merely serves
as PXE boot server.
.PP
Please run the \fBx2gothinclient_create\fR helper script first before you run this script.
.PP
This script can only be called if the PXE boot dir (default: /srv/tftp) does not already
contain any other PXE/Syslinux boot environment.
.SH MANUAL STEPS AFTER SCRIPT HAS RUN
At the end of \fBx2gothinclient_preptftpboot\fR 2-3 manual steps are still needed (as displayed by
the script itself when run)... The $TC_* variables mentioned in the text below have to be
obtained from \fI/etc/x2go/x2gothinclient_settings\fR.
.PP
    1. Make sure your DHCP server's configuration points to:
.PP
        next-server <IP-or-hostname-of-this-server>;
        filename '/pxelinux.0';
.PP
    2. Export the X2Go Thin Client chroot environment via NFSv3:
.PP
      * Add this line to /etc/exports... (in one line):
.PP
        $TC_CHROOT\ \\
\ \ \ \ \ \ \ \ <network>/<netmask>(ro,async,no_root_squash,no_subtree_check)
.PP
      * ... and then restart your NFS server with:
.PP
        /etc/init.d/nfs-kernel-server restart
.PP
    3. Customize PXE/Syslinux files in $TC_TFTP_BOOT/ (optional):
.PP
      * customize PXE boot menu, take a look at
.PP
        $TC_TFTP_BOOT/default.cfg
.PP
        and proceed from there on...
      * use your own boot loader background image: 640x480px,
        16bit colour depth, file: $TC_TFTP_BOOT/x2go-tce.png
.SH OPTIONS
\fBx2gothinclient_pretftpboot\fR has no known options.
.PP
.SH FILES
/etc/x2go/x2gothinclient_settings
    Configuration file for x2gothinclient_* scripts.
.PP
.SH AUTHOR
This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project
(https://www.x2go.org).