tftpboot/scripts/README.md

74 lines
3.9 KiB
Markdown
Raw Normal View History

2016-07-04 17:06:00 +02:00
# Scripts
1. [Description](#description)
2016-07-21 16:33:03 +02:00
2. [Scripts list](#scripts-list)
* [Download Debian](#download_debiansh)
* [Download Ubuntu](#dowload_ubuntush)
* [Make Debian Initrd with Firmware](#make_debian_initrd_with_firmwaresh)
* [Debian late_command](#debian-late_command)
2016-07-04 17:06:00 +02:00
## Description
Set of scripts to download and generate necessary files to allow differents GNU/Linux distributions to boot through the network.
## Scripts list
### download_debian.sh
The script will provide netboot installers for all Debian (>=Stable) for both **i386** and **amd64**:
* Store the files to **/var/lib/tftpboot** (default).
* Download Debian Linux kernel and initrd files for all Debian distributions (Stable: **Jessie**; Testing: **Stretch**; Unstable: **Sid**) and for **i386** and **amd64** architectures.
* Offer an example menu file to use with a TFTP server (default_path/installer/debian/menu.cfg.example).
2016-07-04 17:06:00 +02:00
### download_ubuntu.sh
The script will provide netboot installers for the latest LTS and latest advanced Ubuntu distribution for both **i386** and **amd64**:
* Store the files to **/var/lib/tftpboot** (default).
2016-07-20 12:02:56 +02:00
* Download Ubuntu Linux kernel and initrd files for the two lasts Ubuntu distributions (LTS-16.04: **Xenial**; 15.10: **Wily**) and for **i386** and **amd64** architectures.
* Make a symlink to access to the LTS (default_path/installer/ubuntu/lts) instead of it's codename.
2016-07-04 17:06:00 +02:00
### make_debian_initrd_with_firmware.sh
The script will provide Debian's netboot installers with **additionnals firmwares** for all Debian (>=Stable) for **amd64** only:
* Store the files to **/var/lib/tftpboot** (default).
2016-07-20 12:02:56 +02:00
* Store temp files to **/tmp/tmp.XXXXXXXXXX** (with mktemp).
* Download Debian's initrd files for all Debian distributions (Stable: **Jessie**; Testing: **Stretch**; Unstable: **Sid**) for **amd64** architecture only.
* Download additionnals firmwares:
2016-07-20 12:02:56 +02:00
* **bnx2**: For Broadcom NetXtremeII network adapters.
* **linux-nonfree**: For Tigon network adapters.
* **myricom**: For Myricom Myri-10G Ethernet adapters (IBM server).
* **qlogic**: For QLogic Infiniband, SCSI, Fibre Channel/FCoE adapters.
* Extract initrd and firmwares packages to build a new initrd.
2016-07-11 16:44:26 +02:00
2016-07-21 16:33:03 +02:00
### Debian late_command
2016-07-11 16:44:26 +02:00
#### Description
Some useful configurations after a Debian installation:
* Smarter rsyslog (more directories and less files in **/var/log**).
2016-07-11 16:50:29 +02:00
* Shorter configuration file and use more files from /etc/rsyslog.d/
* Move log files to directory:
* _kern_ logs from /var/log/kern.log to __/var/log/kernel/kernel.log__
* _user_ logs from /var/log/user.log to __/var/log/security/user.log__
* _mail_ logs from /var/log/mail.… to __/var/log/mail/mail.…__
* _daemon_ logs from /var/log/daemon.log to __/var/log/syslog/daemon.log__
* _auth_ logs from /var/log/auth.log to __/var/log/security/auth.log__
2016-07-20 12:02:56 +02:00
* _lpr_ logs from/var/log/lpr.log to __/var/log/lpr/lpr.log__
2016-07-11 16:50:29 +02:00
* _cron_ logs from /var/log/cron.log to __/var/log/cron/cron.log__
* _localX_ logs from /var/log/localX.log to __/var/log/syslog/localX.log__
* _syslog_ logs from /var/log/syslog.log to __/var/log/syslog/syslog.log__
* _authpriv_ logs from … to __/var/log/security/authpriv.log__
2016-07-11 16:44:26 +02:00
* Smarter logrotate (add timestamp, move some old log files to the same directory,…).
* Remove some useless packages.
2016-07-20 12:02:56 +02:00
* Permit root SSH login with password (no standard user…).
2016-07-11 16:44:26 +02:00
*
#### How-to use it
* First, make an archive of the script and directories:
```
tar czvf finish.tar.gz latecommand/
```
* Then, it can be use at the end of a Debian preseed file:
```
d-i preseed/late_command string in-target chsh -s /bin/zsh ; \
in-target /usr/bin/tftp ${IP.SRV.TFTP} -c get ${PATH/TO/TFTPD/ROOT}/finish.tar.gz /tmp/finish.tar.gz ; \
in-target tar xzf /tmp/finish.tar.gz -C /tmp/ ; \
in-target /bin/sh /tmp/latecommand/post.sh
```