update documentation

This commit is contained in:
2023-02-01 13:32:58 +01:00
parent feaafb678e
commit cd03a02433
16 changed files with 71 additions and 150 deletions
@@ -4,7 +4,7 @@ actor admin
participant "BIOS Node\n(legacy boot)" as bootnode
participant "QIP DHCP" as dhcp
participant "pxeserv01.psi.ch" as pxeserver
participant "boot00.psi.ch" as sysdb
participant "sysdb.psi.ch" as sysdb
participant "repo00.psi.ch" as reposerver
admin -> bootnode : boots up
@@ -29,7 +29,7 @@ note right
to "lxprod". At some places this is done the
opposite by linking hostname to MAC to "lxprod".
Having the **link to "lxprod" loads directly**
**the iPXE kernel "boot00.lkrn"**, shortcutting
**the iPXE kernel "ipxe.lkrn"**, shortcutting
the manual selection below.
end note
bootnode -> pxeserver : load PXE config tftp:/tftpboot/pxelinux.cfg/$HEX-IP
@@ -44,7 +44,7 @@ note right
comments from 2013.
end note
admin -> bootnode : selects "Red Hat 7 Network Install"
bootnode -> pxeserver : load iPXE kernel tftp:/tftpboot/boot00.lkrn
bootnode -> pxeserver : load iPXE kernel tftp:/tftpboot/ipxe.lkrn
note right
https://git.psi.ch/linux-infra/ipxe-build
The following steps are by embed/pxe.ipxe
@@ -4,7 +4,7 @@ actor admin
participant "UEFI Node" as bootnode
participant "QIP DHCP" as dhcp
participant "pxeserv01.psi.ch" as pxeserver
participant "boot00.psi.ch" as sysdb
participant "sysdb.psi.ch" as sysdb
participant "repo01.psi.ch" as reposerver
admin -> bootnode : boots up
+1 -1
View File
@@ -17,7 +17,7 @@ other for production, with the following hostnames:
+--------------------+----------------+-----------------+
| Role | testing host | production host |
+====================+================+=================+
| sysdb server | boot00-test | boot00 |
| sysdb server | - | sysdb.psi.ch |
+--------------------+----------------+-----------------+
| puppet server | puppet00-test | puppet01 |
+--------------------+----------------+-----------------+
+5 -5
View File
@@ -12,7 +12,7 @@ Process
When a system PXE boots, the DHCP server will boot either pxelinux in legacy
mode or grub on UEFI. It is still possible to load ipxe from either of these.
With the right option, the boot process is pointed to ``boot00.psi.ch`` and one
With the right option, the boot process is pointed to ``sysdb.psi.ch`` and one
of the following boot images:
- ``ipxe.efi`` for systems using UEFI
@@ -21,12 +21,12 @@ of the following boot images:
The system downloads the image and executes it.
The image contains a small iPXE script, which makes iPXE retrieve its actual
configuration from a web service running (usually) on ``boot00.psi.ch``.
configuration from a web service running (usually) on ``sysdb.psi.ch``.
Specifically, it queries the URL
``https://boot00.psi.ch/ipxe/v1/config?mac=<MAC>``, where ``<MAC>`` is the MAC
``https://sysdb.psi.ch/ipxe/v1/config?mac=<MAC>``, where ``<MAC>`` is the MAC
address of the interface used by iPXE.
The web service on ``boot00.psi.ch`` will generate the iPXE configuration on the
The web service on ``sysdb.psi.ch`` will generate the iPXE configuration on the
fly, depending on whether the system is supposed to be reinstalled and if so,
which distribution it is supposed to use. The menu offers other options as well,
e.g. an interactive iPXE shell and a memory test.
@@ -68,4 +68,4 @@ roughly like the following::
:dhcp_succeeded
chain http://boot00.psi.ch/ipxe/v1/config?mac=${netX/mac}
chain http://sysdb.psi.ch/ipxe/v1/config?mac=${netX/mac}
+1 -1
View File
@@ -3,7 +3,7 @@ Kickstart
The auto-generated Grub or iPXE configuration will, when installing RHEL, instruct
the RHEL installer to download the Kickstart configuration from
``https://boot00.psi.ch/kickstart/v1/config?fqdn=<FQDN>&instrepo=<INSTREPO>``,
``https://sysdb.psi.ch/kickstart/v1/config?fqdn=<FQDN>&instrepo=<INSTREPO>``,
where ``<FQDN>`` is the FQDN of the host to be installed, and ``<INSTREPO>`` is
the installation repository to be used.