libreschool-pxeserver/README.md

54 lines
1.6 KiB
Markdown

# libreschool-pxeserver #
[![Build Status](https://drone.libreschool.org/api/badges/LibreSchool/libreschool-pxeserver/status.svg)](https://drone.libreschool.org/LibreSchool/libreschool-pxeserver)
This package is the common base for PXE/TFTP in the LibreSchool project.
## Requirements ##
A working [LibreSchool][] installation is required.
## Usage ##
Each host has a property called **PXEImage**, which defines the default PXE image to use for system boot. If this property is not set, the **localhd** image is assumed. You can set this image via db:
```bash
db hosts setprop lab01 \
PXEImage memtest
```
By running the above command, every time the host is booted, the **memtest** image will be used.
You can also use the **PXEImageOneTime** property, which will use the specified image on the next PXE boot. The property will be resetted after the boot.
```bash
db hosts setprop lab01 \
PXEImage localhd \
PXEImageOneTime memtest
```
By running the above command, the **memtest** image will be used for one boot only.
## default image ##
When there's no specific setting for the host, the host is not in the hosts db, or the image specified for the host is not available, the *default image* is used.
To set the default image, you can use this command:
```bash
db configuration setprop pxeserver-httpd \
defaultimage memtest
```
## TODO / ideas ##
* Create a menu, for interactive selection
* FIX createlinks
## License ##
As the rest of the LibreSchool project, libreschool-pxeserver is licensed under [GPLv3][] license.
[LibreSchool]: https://libreschool.org "LibreSchool Project Homepage"
[GPLv3]: https://www.gnu.org/licenses/gpl-3.0.html