cleaning up Ubuntu guide

Author: sus-admin

_posts/2024-12-11-Cobbler-v3.3.7-Ubuntu-Deployment-Guide.md

@@ -34,22 +34,22 @@ Cobbler v3.3.7 does not come with a sample template for the `cloud-init` autoins
 
 Create the `cloud-init` autoinstall template with the following contents and save it to `/var/lib/cobbler/templates/cloud-init_user-data`:
 
-> Cobbler Templates and Snippets are actually Python Cheetah templates, so be careful editing the files, especially the cheetah code preceded buy `#` 
+> Cobbler Templates and Snippets are actually Python Cheetah templates, so keep in mind that not all `#`'s in the below 3 files represent comments. 
 
 ```shell
 #cloud-config
 autoinstall:
   version: 1
   apt:
-    # even set to no/false, geoip lookup still happens
-    #geoip: no
+    ## even set to no/false, geoip lookup still happens
+    ##geoip: no
     preserve_sources_list: true
     primary:
     - arches: [amd64, i386]
       uri: http://$http_server/cblr/links/$distro
-#      uri: http://us.archive.ubuntu.com/ubuntu
+##      uri: http://us.archive.ubuntu.com/ubuntu
     - arches: [default]
-#      uri: http://$http_server/cblr/links/$distro
+##      uri: http://$http_server/cblr/links/$distro
       uri: http://ports.ubuntu.com/ubuntu-ports
     fallback: offline-install
   identity:
@@ -83,7 +83,6 @@ $SNIPPET('cloud-init_network')
 #end if
     - wget -O /target/tmp/autoinstall-user-data.yaml http://$http_server/cblr/svc/op/autoinstall/$what/$name
     - chroot /target /bin/bash -s ssh-keygen -t rsa -b 2048 -m ssh2 -N "" -f /root/.ssh/id_rsa
-#    - rm /target/etc/apt/apt.conf.d/99needrestart # This prompt will prevent the apt command from completing
 ```
 
 > the `fallback: offline` option under the apt configuration will use the live CD (.iso file) as the source to install Ubuntu from if there is an issue connecting to a remote repo mirror, and was only introduced as of [Ubuntu 22.04 release](https://discourse.ubuntu.com/t/jammy-jellyfish-release-notes/24668).
@@ -268,7 +267,7 @@ The above autoinstall template calls for 2 Cobbler snippets; create them with th
 #end if
 ```
 
-> This section should resemble the [netplan](https://netplan.readthedocs.io/en/latest/netplan-yaml/) network configuration standard to Ubuntu once generated.
+> This section should resemble the standard [netplan](https://netplan.readthedocs.io/en/latest/netplan-yaml/) YAML configuration file for Ubuntu once generated.
 
 Create 2 Cobbler sync-triggers to correct the GRUB and PXELINUX boot configurations to support Ubuntu `cloud-init` installations, which will run each time the `cobbler sync` action is performed:
 
@@ -466,6 +465,14 @@ cobbler sync
 
 1. The [Cobbler 3.3.6 Beginner's Guide](/blog/2024/Cobbler-v3.3.6-Beginners-Guide/) **Tips & Troubleshooting** section contains some basic recommendations and limitations of Cobbler which will not be repeated here.
 
+1. Troubleshooting the installation
+
+    - The Ubuntu installer will reboot the system automatically upon completing a `cloud-init` auto-install. To prevent this, append the following line to the end of the autoinstall template (`cloud-init_user-data`) as the final command int the `late-commands:` section *(be sure the spacing/indentation aligns with the rest of the `late-command` entries)*:
+
+        ```shell
+            - rm /target/etc/apt/apt.conf.d/99needrestart
+        ```
+
 1. More info on `cloud-init`
 
     - [https://cloudinit.readthedocs.io/en/22.1_a/topics/modules.html](https://cloudinit.readthedocs.io/en/22.1_a/topics/modules.html)