From 726c932bf485f5bc1a50be76a768ef4580f46fcf Mon Sep 17 00:00:00 2001
From: Daniel Juarez <daniel.juarez.gonzalez@cern.ch>
Date: Tue, 17 May 2022 11:11:16 +0200
Subject: [PATCH] Compiling missing refs for both Koji + AIMS2
---
docs/aims2/references.md | 21 +++++++++++++++++++++
docs/koji/references.md | 21 +++++++++++++++++++++
mkdocs.yml | 1 +
3 files changed, 43 insertions(+)
create mode 100644 docs/koji/references.md
diff --git a/docs/aims2/references.md b/docs/aims2/references.md
index a0b9c9d..d24b10c 100644
--- a/docs/aims2/references.md
+++ b/docs/aims2/references.md
@@ -4,23 +4,44 @@ This is a compilation of all the interesting resources that can help you better
## Bootloader references
+Maybe relevant for the bootloader mentions in <https://linuxops.web.cern.ch/aims2/aims2diagrams/>
+
* <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
+* <https://netboot.xyz/>: External service we use for installing unsupported (by CERN) distributions through PXE. Currently suffering from [LOS-820](https://its.cern.ch/jira/browse/LOS-820)
+ * Watch out, back in the days security blocked all `*.xyz` domains making this unusable. We hope this does not happen again.
+* <https://gist.github.com/vkanevska/fd624f708cde7d7c172a576b10bc6966>: Custom CentOS 7 bootable ISO / Support UEFI & Secure boot
+* <https://superuser.com/questions/1165557/how-grub2-works-on-a-mbr-partitioned-disk-and-gpt-partitioned-disk: How grub2 works on a MBR partitioned disk and GPT partitioned disk?
## DHCP / `dnsmasq` references
+Useful for <https://linuxops.web.cern.ch/aims2/aims2workflows/> and <https://gitlab.cern.ch/ai/it-puppet-hostgroup-aims/-/blob/qa/code/templates/dnsmasq_old_patched.conf.epp>
+
* <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
+* <https://toreanderson.github.io/2015/11/16/ipv6-network-boot-with-uefi-and-ipxe.html>: references for the future if you need to investigate DHCP + IPv6 + PXE
## Useful references for AIMS Perl code
+Relevant for <https://linuxops.web.cern.ch/aims2/aims2server/> and <https://gitlab.cern.ch/linuxsupport/rpms/aims2>
+
* <https://www.perl.com/pub/2001/01/soap.html/>: Perl SOAP examples that you can extrapolate for AIMS code
## iPXE references
+Useful for <https://gitlab.cern.ch/linuxsupport/aims2-ipxe>
+
* <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
+* <https://gist.github.com/AdrianKoshka/5b6f8b6803092d8b108cda2f8034539a>: creating a bootable iPXE image
## Other references
+
+* <https://vessokolev.blogspot.com/2015/03/how-to-install-centos-7-on-hp-proliant.html?m=1>: Driver Disk info. Relevant for <https://pagure.io/koji/pull-request/3217>
+* <https://www.golinuxcloud.com/kickstart-clearpart-not-working-rhel-8/>: Solved: Kickstart clearpart not working in RHEL CentOS 7 8
+* <https://forums.centos.org/viewtopic.php?f=13&t=69141&start=10>: ISO Missing e1000e Driver to Support Intel 8086:15bb, relevant for [Add LOS-659 image workaround for HP 800 G6 and G8 models comit](https://gitlab.cern.ch/ai/it-puppet-hostgroup-aims/-/commit/3457833712a95f76073bdceb92bcba7f7f438e39)
+* <https://community.theforeman.org/t/update-driver-included-in-discovery-image/21330/7>: Update driver included in discovery image. Relevant for [LOS-659](https://its.cern.ch/jira/browse/LOS-659), when desktops do not work with our images due to missing driver compatibility.
+* <https://blog.devopstom.com/hacking-initrdgz-ubuntu-netboot-installer/>: Also refs for altering image content to work un unsupported hardware. Same as previous links.
+* <https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1924889>: i915 graphics driver not loading for Rocket Lake i7-11700K [8086:4c8a]. Same as other links.
\ No newline at end of file
diff --git a/docs/koji/references.md b/docs/koji/references.md
new file mode 100644
index 0000000..a7d455f
--- /dev/null
+++ b/docs/koji/references.md
@@ -0,0 +1,21 @@
+# Useful references
+
+This is a list of useful links that were used at some point for the Koji service. Specially for <https://gitlab.cern.ch/linuxsupport/koji-image-build/>, <https://gitlab.cern.ch/linuxsupport/rpms/koji/>, <https://gitlab.cern.ch/linuxsupport/rpms/oz/>, <https://gitlab.cern.ch/ai/it-puppet-module-koji> and <https://gitlab.cern.ch/ai/it-puppet-hostgroup-lsb>. Kickstart references are specially relevant here for our current image building mechanism.
+
+* <https://lukas.zapletalovi.com/2017/10/efi-with-libvirt-in-rhel7.html>: Libvirt + OVMF configuration. Not using Kraxel's RPM anymore [in favour of CS8 RPM instead](https://its.cern.ch/jira/browse/LOS-921)
+* <https://andreaskaris.github.io/blog/linux/libvirt-uefi-without-secureboot/>: RHEL: Booting a virtual machine with UEFI but without secure boot. Relevant for [LOS-921](https://its.cern.ch/jira/browse/LOS-921)
+* <https://forums.centos.org/viewtopic.php?t=71030>: background for how we do dual-boot cloud images.
+* <https://techblog.web.cern.ch/techblog/post/bios_uefi_cloud_image/>: more background on how we built our dual-boot cloud images
+* <https://github.com/openlogic/AzureBuildCentOS/blob/8f46a34e6fceed41030ef4611ca85a272f0abbe4/ks/azure/centos77.ks>: Where our inspiration for dual-boot cloud images come from
+* <https://github.com/CentOS/sig-cloud-instance-build/blob/98aa8c6f0290feeb94d86b52c561d70eabc7d942/cloudimg/CentOS-8-x86_64-Azure.ks>: Where our inspiration for dual-boot cloud images come from
+* <https://askubuntu.com/questions/500359/efi-boot-partition-and-biosgrub-partition>: more refs used for the dual-boot images
+* <https://gist.github.com/vkanevska/fd624f708cde7d7c172a576b10bc6966>: Custom CentOS 7 bootable ISO / Support UEFI & Secure boot
+* <https://blog.heckel.io/2017/05/28/creating-a-bios-gpt-and-uefi-gpt-grub-bootable-linux-system/>: Creating a BIOS/GPT and UEFI/GPT Grub-bootable Linux system
+* <https://docs.openvz.org/openvz_installation_using_pxe_guide.webhelp/_kickstart_file_example.html>: OpenVZ Installation Using PXE Chapter 4. Creating a Kickstart File
+* <https://docs.openvz.org/openvz_installation_using_pxe_guide.webhelp/_kickstart_file_example_for_installing_on_efi_based_systems.html>: OpenVZ Installation Using PXE 4.3. Kickstart File Example
+* <https://listman.redhat.com/archives/kickstart-list/2012-August/msg00005.html>: how to tell when biosboot partition is needed? Relevant for the dual-boot story
+* <https://outflux.net/blog/archives/2018/04/19/uefi-booting-and-raid1/>: relevant for the background info about these dual-boot images, UEFI and RAID. Ref. [RQF1571304](https://cern.service-now.com/service-portal?id=ticket&table=u_request_fulfillment&n=RQF1571304)
+* <https://www.thomas-krenn.com/en/wiki/%EF%BB%BFInstalling_Operating_Systems_on_UEFI_Systems>: `efibootmgr` refs. Relevant for [KB0006881](https://cern.service-now.com/service-portal?id=kb_article&n=KB0006881).
+* <https://community.theforeman.org/t/efi-boot-order-with-centos-7-network-boot-vs-local-boot/10529/6>: `efibootmgr`, UEFI boot order changes. Same as the previous link.
+* <https://vessokolev.blogspot.com/2015/03/how-to-install-centos-7-on-hp-proliant.html?m=1>: Driver Disk info. Relevant for <https://pagure.io/koji/pull-request/3217>
+* <https://groupbcl.ca/blog/posts/2018/creating-a-device-driver-disc-for-red-hatcentos-installs/>: Driver Disk info. Relevant for <https://pagure.io/koji/pull-request/3217>
diff --git a/mkdocs.yml b/mkdocs.yml
index b6e8185..505245e 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -55,6 +55,7 @@ nav:
- 'Upgrading koji': koji/upgrading.md
- 'Bootstrapping a new distro': koji/bootstrapping.md
- 'Troubleshooting': koji/troubleshooting.md
+ - 'References': koji/references.md
- 'Nomad':
- 'Access': nomad/access.md
- 'Mirroring new repos': nomad/mirroring.md
--
GitLab