From 946ed77e12bae2ff13e06edaa2a1a1d3e18817bf Mon Sep 17 00:00:00 2001
From: Daniel Juarez <daniel.juarez.gonzalez@cern.ch>
Date: Mon, 16 May 2022 11:40:08 +0200
Subject: [PATCH] Update docs/aims2/references.md, mkdocs.yml,
docs/aims2/resources.md
---
docs/aims2/references.md | 26 ++++++++++++++++++++++++++
docs/aims2/resources.md | 2 ++
mkdocs.yml | 1 +
3 files changed, 29 insertions(+)
create mode 100644 docs/aims2/references.md
diff --git a/docs/aims2/references.md b/docs/aims2/references.md
new file mode 100644
index 0000000..a0b9c9d
--- /dev/null
+++ b/docs/aims2/references.md
@@ -0,0 +1,26 @@
+# 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
diff --git a/docs/aims2/resources.md b/docs/aims2/resources.md
index 01da618..b30e090 100644
--- a/docs/aims2/resources.md
+++ b/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>
diff --git a/mkdocs.yml b/mkdocs.yml
index b43783d..b6e8185 100644
--- a/mkdocs.yml
+++ b/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':
--
GitLab