Update docs/aims2/references.md, mkdocs.yml, docs/aims2/resources.md

docs/aims2/references.md

+# Useful references
+
+This is a compilation of all the interesting resources that can help you better understand of justify the way this service is built. They are separated by subject.
+
+## Bootloader references
+
+* <https://fecos.docs.cern.ch/fec/bootloader/#build-a-self-contained-grub-image>: A secondary reference on how to build the GRUB2 bootloader
+* <https://www.centlinux.com/2018/10/automate-pxe-client-installations-with-kickstart.html>: Simplified similar version on how our setup works
+* <https://www.gnu.org/software/grub/manual/grub/html_node/Installing-GRUB-using-grub_002dinstall.html>: Installing GRUB2. Useful for [koji-image-build's](https://gitlab.cern.ch/linuxsupport/koji-image-build/) Kickstart files peculiarities
+
+## DHCP / `dnsmasq` references
+
+* <https://wiki.fogproject.org/wiki/index.php?title=ProxyDHCP_with_dnsmasq>: Explanation on how our `dnsmasq` component works and interacts with central DHCP server
+* <https://serverfault.com/questions/829068/trouble-with-dnsmasq-dhcp-proxy-pxe-for-uefi-clients>: DNSMASQ specific arch numbers and configuration for UEFI to work
+* <https://wiki.archlinux.org/title/dnsmasq>: `dnsmasq` matching rules docs
+
+## Useful references for AIMS Perl code
+
+* <https://www.perl.com/pub/2001/01/soap.html/>: Perl SOAP examples that you can extrapolate for AIMS code
+
+## iPXE references
+
+* <http://kimizhang.com/create-pxe-boot-image-for-openstack/>: iPXE image building reference
+* <https://doc.rogerwhittaker.org.uk/ipxe-installation-and-EFI/>: iPXE reference. It may be useful if one day you decide iPXE is the way to go
+
+## Other references

docs/aims2/resources.md

@@ -96,4 +96,6 @@ Please check [the account management for Oracle accounts](https://cern.service-n
     * **prod**: `aims01`, `aims02`, `aims03`
     * **test**: `aimstest01`, `aimstest02`, `aimstest03`
 * AIMS2 applications: <https://gitlab.cern.ch/linuxsupport/rpms/aims2>
+* AIMS2 GRUB2: <https://gitlab.cern.ch/linuxsupport/aims/grub2>
+* iPXE Openstack images to test PXE with VMs: <https://gitlab.cern.ch/linuxsupport/aims2-ipxe>
 * Other AIMS2 related components: <https://gitlab.cern.ch/linuxsupport/aims>

mkdocs.yml

@@ -75,6 +75,7 @@ nav:
         - 'Legacy workaround': aims2/aims2legacyworkaround.md
         - 'Troubleshooting': aims2/troubleshooting.md
         - 'Error compilation': aims2/errorcollection.md
+        - 'Useful references': aims2/references.md
     - 'Community':
         - 'CentOS': community/centos.md
     - 'Resources':