Skip to content

Commit 11a464f

Browse files
antonymantonym
committed
Update some pxe docs
1 parent 19f4795 commit 11a464f

File tree

4 files changed

+165
-26
lines changed

4 files changed

+165
-26
lines changed

‎docs/kb/pxe/almalinux.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
id: almalinux
3+
title: PXE Booting the AlmaLinux Installer
4+
sidebar_label: AlmaLinux
5+
description: PXE Booting the AlmaLinux Installer using Kickstart
6+
hide_table_of_contents: true
7+
---
8+
9+
## Installer Kernels
10+
11+
AlmaLinux maintains installer kernels that are a lightweight way to load the installer and then stream packages over the network as needed. The installer kernels are located at:
12+
13+
| URL | Description |
14+
| --- | ----------- |
15+
| `http://repo.almalinux.org`| Base URL for AlmaLinux mirrors |
16+
| `almalinux/${version}/BaseOS/${arch}/os/images/pxeboot/` | Directory containing the installer kernels |
17+
| `${version}` | Version (e.g., 8, 9, etc) |
18+
| `${arch}` | Architecture (e.g., x86_64, aarch64) |
19+
| `vmlinuz` | Kernel filename |
20+
| `initrd.img` | Initrd filename |
21+
22+
In order to load them, you'll need to use a boot snippet in iPXE similar to:
23+
24+
```bash
25+
set install_params inst.ks=http://my.kickstart.com/ks.cfg inst.repo=http://repo.almalinux.org/almalinux/$version/BaseOS/$arch/os/
26+
set mirror http://repo.almalinux.org
27+
set base_dir almalinux
28+
set version 8
29+
set arch x86_64
30+
set dir ${mirror}/${base_dir}/${version}/BaseOS/${arch}/os/images/pxeboot
31+
32+
kernel ${dir}/vmlinuz ${install_params} -- quiet
33+
initrd ${dir}/initrd.img
34+
boot
35+
```
36+
37+
If you want to use a [Kickstart](https://wiki.almalinux.org/documentation/kickstart.html) URL for automation, you can add this to the kernel line:
38+
39+
```bash
40+
set ksurl http://my.kickstart.com/ks.cfg
41+
inst.ks=${ksurl}
42+
```
43+
44+
For more examples, you can view the netboot.xyz configuration for AlmaLinux [here](https://github.com/netbootxyz/netboot.xyz/blob/master/roles/netbootxyz/templates/menu/almalinux.ipxe.j2).

‎docs/kb/pxe/debian.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
id: debian
3+
title: PXE Booting the Debian Installer
4+
sidebar_label: Debian
5+
description: PXE Booting the Debian Installer
6+
hide_table_of_contents: true
7+
---
8+
9+
## Installer Kernels
10+
11+
Debian maintains installer kernels that are a lightweight way to load the Debian installer and then stream packages over the network as needed. The installer kernels are located at:
12+
13+
| URL | Description |
14+
| --- | ----------- |
15+
| `http://deb.debian.org` | Base URL for Debian mirrors |
16+
| `debian/dists/${version}/main/installer-${arch}/current/images/netboot/` | Directory containing the installer kernels |
17+
| `${version}` | Version (e.g., bullseye, bookworm, etc) |
18+
| `${arch}` | Architecture (e.g., amd64, arm64) |
19+
| `linux` | Kernel filename |
20+
| `initrd.gz` | Initrd filename |
21+
22+
In order to load them, you'll need to use a boot snippet in iPXE similar to:
23+
24+
```bash
25+
set install_params auto=true priority=critical
26+
set mirror http://deb.debian.org
27+
set base_dir debian
28+
set debian_version bookworm
29+
set arch amd64
30+
set mirrorcfg mirror/suite=${debian_version}
31+
set dir ${mirror}/${base_dir}/dists/${version}/main/installer-${arch}/current/images/netboot/debian-installer/amd64/
32+
33+
kernel ${dir}/linux ${install_params} ${mirrorcfg} -- quiet initrd=initrd.gz
34+
initrd ${dir}/initrd.gz
35+
boot
36+
```
37+
38+
If you want to use a [preseed](https://www.debian.org/releases/stable/amd64/apb.en.html) URL for automation, you can add this to the kernel line:
39+
40+
```bash
41+
set preseedurl http://my.preseed.com/preseed.cfg
42+
preseed/url=${preseedurl}
43+
```
44+
45+
For more examples, you can view the netboot.xyz configuration for Debian [here](https://github.com/netbootxyz/netboot.xyz/blob/master/roles/netbootxyz/templates/menu/debian.ipxe.j2).
46+
47+
## Live Boot
48+
49+
Debian also provides a number of Live Boot ISOs that will boot an OS directly into memory and can be used immediately without doing an install or modifying the hard drive. The Live OS will also include the installer as well. These are great for evaluating other desktops that you might want to try out without doing a full install.
50+
51+
| Distribution | Website |
52+
| :--- | :--- |
53+
| Debian Live | [https://www.debian.org/CD/live/](https://www.debian.org/CD/live/) |

‎docs/kb/pxe/rockylinux.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
id: rockylinux
3+
title: PXE Booting the Rocky Linux Installer
4+
sidebar_label: Rocky Linux
5+
description: PXE Booting the Rocky Linux Installer using Kickstart
6+
hide_table_of_contents: true
7+
---
8+
9+
## Installer Kernels
10+
11+
Rocky Linux maintains installer kernels that are a lightweight way to load the installer and stream packages over the network as needed. Rocky Linux is a binary compatible clone of RHEL (Red Hat Enterprise Linux) and is already supported by numerous large, financially strong sponsors.
12+
13+
The installer kernels are located at:
14+
15+
| URL | Description |
16+
| --- | ----------- |
17+
| `http://dl.rockylinux.org` | Base URL for Rocky Linux mirrors |
18+
| `pub/rocky/${version}/BaseOS/${arch}/os/images/pxeboot/` | Directory containing the installer kernels |
19+
| `${version}` | Version (e.g., 8, 9, etc) |
20+
| `${arch}` | Architecture (e.g., x86_64, aarch64) |
21+
| `vmlinuz` | Kernel filename |
22+
| `initrd.img` | Initrd filename |
23+
24+
In order to load them, you'll need to use a boot snippet in iPXE similar to:
25+
26+
```bash
27+
set install_params inst.ks=http://my.kickstart.com/ks.cfg inst.repo=http://dl.rockylinux.org/pub/rocky/${version}/BaseOS/${arch}/os
28+
set mirror http://dl.rockylinux.org
29+
set base_dir pub/rocky
30+
set version 9
31+
set arch x86_64
32+
set dir ${mirror}/${base_dir}/${version}/BaseOS/${arch}/os/images/pxeboot
33+
34+
kernel ${dir}/vmlinuz ${install_params} -- quiet
35+
initrd ${dir}/initrd.img
36+
boot
37+
```
38+
39+
If you want to use a [Kickstart](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/automatically_installing_rhel/automated-installation-workflow_rhel-installer) URL for automation, you can add this to the kernel line:
40+
41+
```bash
42+
set ksurl http://my.kickstart.com/ks.cfg
43+
inst.ks=${ksurl}
44+
```
45+
46+
For more examples, you can view the netboot.xyz configuration for Rocky Linux [here](https://github.com/netbootxyz/netboot.xyz/blob/master/roles/netbootxyz/templates/menu/rockylinux.ipxe.j2).

‎docs/kb/pxe/ubuntu.md

Lines changed: 22 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -8,52 +8,48 @@ hide_table_of_contents: true
88

99
## Installer Kernels
1010

11-
Ubuntu maintains installer kernels that are lightweight way to load the Ubuntu installer and then stream packages over the network as needed. The installer kernels are located at:
11+
Ubuntu maintains installer kernels that are a lightweight way to load the Ubuntu installer and then stream packages over the network as needed. The installer kernels are located at:
1212

13-
```bash
14-
# http://archive.ubuntu.com or other ubuntu mirrors
15-
#
16-
# (${version} == xenial, bionic, etc)
17-
# (${arch} == amd64, i386)
18-
19-
# original release directory:
20-
# ubuntu/dists/${version}/main/installer-${arch}/current/images/netboot/
21-
#
22-
# updated release directory which contain newer kernels and updates:
23-
# ubuntu/dists/${version}-updates/main/installer-${arch}/current/images/netboot/
24-
#
25-
# kernel filename: linux
26-
# initrd filename: initrd.gz
27-
```
13+
| URL | Description |
14+
| --- | ----------- |
15+
| `http://archive.ubuntu.com` | Base URL for Ubuntu mirrors |
16+
| `${version}` | Version (e.g., focal, jammy, etc) |
17+
| `${arch}` | Architecture (e.g., amd64, arm64) |
18+
| `ubuntu/dists/${version}/main/installer-${arch}/current/images/netboot/` | Directory containing the installer kernels |
19+
| `linux` | Kernel filename |
20+
| `initrd.gz` | Initrd filename |
2821

29-
In order to load them, you'll need use a boot snippet in iPXE similar to:
22+
In order to load them, you'll need to use a boot snippet in iPXE similar to:
3023

3124
```bash
32-
set install_params auto=true priority=critical
33-
set mirror http://archive.ubuntu.com
25+
26+
set mirror http://releases.ubuntu.com
3427
set base_dir ubuntu
35-
set ubuntu_version bionic
36-
set arch amd64
28+
set codename jammy
29+
set version_number 22.04
30+
set os_arch amd64
3731
set mirrorcfg mirror/suite=${ubuntu_version}
3832
set dir ${mirror}/${base_dir}/dists/${version}/main/installer-${arch}/current/images/netboot
33+
set ubuntu_iso_url http://releases.ubuntu.com/${codename}/ubuntu-${version_number}-live-server-${os_arch}.iso
34+
set install_params autoinstall ip=dhcp ds=nocloud-net;s=http://my.autoinstall.com/ url=${ubuntu_iso_url}
3935

4036
kernel ${dir}/linux ${install_params} ${mirrorcfg} -- quiet initrd=initrd.gz
4137
initrd ${dir}/initrd.gz
4238
boot
4339
```
4440

45-
If you want to use a [preseed](https://help.ubuntu.com/lts/installation-guide/example-preseed.txt) url for automation, you can add this to the kernel line:
41+
If you want to use an [autoinstall](https://canonical-subiquity.readthedocs-hosted.com/en/latest/howto/autoinstall-quickstart.html) URL for automation, you can add this to the kernel line:
4642

4743
```bash
48-
set preseedurl http://my.preseed.com/preseed.cfg
49-
preseed/url=${preseedurl}
44+
set autoinstall_url http://my.autoinstall.com/
45+
autoinstall ds=nocloud-net;s=${autoinstall_url}
5046
```
5147

52-
For more examples you can view the netboot.xyz configuration for Ubuntu [here](https://github.com/netbootxyz/netboot.xyz/blob/master/roles/netbootxyz/templates/menu/ubuntu.ipxe.j2).
48+
For more examples, you can view the netboot.xyz configuration for Ubuntu [here](https://github.com/netbootxyz/netboot.xyz/blob/master/roles/netbootxyz/templates/menu/ubuntu.ipxe.j2).
5349

5450
## Live Boot
5551

56-
Ubuntu also provides a number of Live Boot ISOs that will boot an OS directly into memory and can be used immediately without doing an install or modifying the hard drive. The Live OS will also include the installer as well. These are great for evaluating other desktops that you might want to try out without doing a full install.
52+
Ubuntu also provides a number of Live Boot ISOs that will boot an OS directly into memory and can be used immediately without doing an install or modifying the hard drive. The Live OS will also include the installer as well. These are great for evaluating other desktops that you might want to try out without doing a full install.
5753

5854
| Distribution | Website |
5955
| :--- | :--- |

0 commit comments

Comments
 (0)