Ubuntu guide edit

Author: sus-admin

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

@@ -41,8 +41,6 @@ Create the new Cobbler template and snippets necessary to generate the `cloud-in
 {% for line in lines %}{{ line | prepend: "      " }}
 {% endfor %}
 
-> 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 imposes higher system RAM requirements for the PXE client, since the entire CD is loaded into memory before performing installs.
-
 - `/var/lib/cobbler/snippets/cloud-init_hostname`
 
 {% capture file %}{% include cloud-init_hostname.txt path="_includes/cloud-init_hostname.txt" %}{% endcapture %}
@@ -106,12 +104,10 @@ mkdir -p /var/www/cobbler/pub/cloud-init/Ubuntu20
 cp ~/Downloads/ubuntu-20.04.6-live-server-amd64.iso /var/www/cobbler/pub/cloud-init/Ubuntu20/.
 ```
 
-> the PXE Client will not install Ubuntu from the local mirror @ `/var/www/cobbler/distro_mirror`, and since the `fallback: ofline-install` option was not available for Ubuntu 20.04 `cloud-init`, this distro **requires an internet connection** to install, as detailed in this guide.
-
 Edit the kernel options for the new Cobbler Distro to install Ubuntu automatically by default:
 
 ```shell
-cobbler distro edit --name Ubuntu20-casper-x86_64 --kernel-options 'root=/dev/ram0 ramdisk_size=1500000 ip=dhcp url=http://10.0.0.10/cblr/pub/cloud-init/Ubuntu20/ubuntu-20.04.6-live-server-amd64.iso autoinstall cloud-config-url=http://10.0.0.10/cblr/svc/op/autoinstall/profile/Ubuntu20-casper-x86_64'
+NAME="Ubuntu20-casper-x86_64" && cobbler distro edit --name $NAME --kernel-options "root=/dev/ram0 ramdisk_size=1500000 ip=dhcp url=http://10.0.0.10/cblr/pub/cloud-init/Ubuntu20/ubuntu-20.04.6-live-server-amd64.iso autoinstall cloud-config-url=http://10.0.0.10/cblr/svc/op/autoinstall/profile/$NAME" && unset NAME
 ```
 
 > alternatively, use the following kernel-options to **install Ubuntu manually** via PXE network boot
@@ -122,17 +118,22 @@ cobbler distro edit --name Ubuntu20-casper-x86_64 --kernel-options 'root=/dev/ra
 > 
 > More info on these configs in the **Tips & Troubleshooting** section below.
 
-create a new autoinstall (`cloud-init`) template from the `cloud-init_user_data` file created above, and configure it as the autoinstallation template for the Ubuntu 20.04 Cobbler PROFILE
+Since the PXE client will install the OS from the internet, create a new autoinstall (`cloud-init`) template from the file created above, changing the `apt` uri.
 
 ```shell
 sed -z 's,      uri: http://$http_server/cblr/links/$distro\n#      uri: http://us.archive.ubuntu.com/ubuntu,#      uri: http://$http_server/cblr/links/$distro\n      uri: http://us.archive.ubuntu.com/ubuntu,' /var/lib/cobbler/templates/cloud-init_user-data | tee /var/lib/cobbler/templates/Ubuntu20_cloud-init_user-data
+```
+
+Then configure it as the autoinstallation template for the Ubuntu 20.04 Cobbler Profile
+
+```shell
 cobbler profile edit --name Ubuntu20-casper-x86_64 --autoinstall Ubuntu20_cloud-init_user-data
 ```
 
-Create a new Cobbler System to install Ubuntu 20.04 automatically based on the system's (PXE client's) MAC address, replacing the *"aa:bb:cc:dd:ee:ff"* with the MAC address of your PXE client, and being sure not to use a duplicate MAC or IP addresse of any other Cobbler System as well as setting the kernel-options to match the Cobbler System's name:
+Create a new Cobbler System to install Ubuntu 20.04 automatically based on the system's (PXE client's) MAC address, replacing the *"aa:bb:cc:dd:ee:ff"* with the MAC address of your PXE client, and being sure not to use a duplicate MAC or IP addresse of any other Cobbler System:
 
 ```shell
-NAME="Ubuntu20-auto" && cobbler system add --name $NAME --profile Ubuntu20-casper-x86_64 --kernel-options "root=/dev/ram0 ramdisk_size=1500000 ip=dhcp url=http://10.0.0.10/cblr/pub/cloud-init/Ubuntu20/ubuntu-20.04.6-live-server-amd64.iso autoinstall cloud-config-url=http://10.0.0.10/cblr/svc/op/autoinstall/system/$NAME" --mac-address "aa:bb:cc:dd:ee:ff" --static true --ip-address "10.0.0.20" --netmask "255.255.255.0" --gateway "10.0.0.1" --name-servers "10.0.0.1 1.1.1.1 10.0.0.10" --hostname "Ubuntu20" --netboot-enabled true && NAME=""
+NAME="Ubuntu20-auto" && cobbler system add --name $NAME --profile Ubuntu20-casper-x86_64 --kernel-options "root=/dev/ram0 ramdisk_size=1500000 ip=dhcp url=http://10.0.0.10/cblr/pub/cloud-init/Ubuntu20/ubuntu-20.04.6-live-server-amd64.iso autoinstall cloud-config-url=http://10.0.0.10/cblr/svc/op/autoinstall/system/$NAME" --mac-address "aa:bb:cc:dd:ee:ff" --static true --ip-address "10.0.0.20" --netmask "255.255.255.0" --gateway "10.0.0.1" --name-servers "10.0.0.1 1.1.1.1 10.0.0.10" --hostname "Ubuntu20" --netboot-enabled true && unset NAME
 ```
 
 > Alternatively, configure the Cobbler System kernel-options to run as a **manual** installation:
@@ -149,6 +150,8 @@ Finally, sync up Cobbler, then the **PXE Client** VM can be powered on and shoul
 cobbler sync
 ```
 
+> the PXE Client will not install Ubuntu from the local mirror @ `/var/www/cobbler/distro_mirror`, and since the `fallback: ofline-install` option was not available for Ubuntu 20.04 `cloud-init`, this distro **requires an internet connection** to install, as detailed in this guide.
+
 ## Ubuntu 22.04 PXE Deployment
 
 Take similar steps as above to import and automatically deploy Ubuntu 22.04 LTS Server over PXE, using the original `cloud-init_user-data` autoinstall template created above.
@@ -170,7 +173,7 @@ NAME="Ubuntu22-auto" && cobbler system add --name $NAME --profile Ubuntu22-caspe
 cobbler sync
 ```
 
-> Again, the PXE Client is not installing via the local repo @ `/var/www/cobbler/distro_mirror`, but now that the `fallback: offline-install` option is available with Ubuntu 22.04 `cloud-init`, the installer will NOT require and internet connection to install, instead installing using the live server installer (.iso file) available on Cobbler's public HTTP share.
+> Again, the PXE Client is not installing via the local repo @ `/var/www/cobbler/distro_mirror`, but now that the `fallback: offline-install` option is available with Ubuntu 22.04 `cloud-init`, the installer will NOT require and internet connection to install, instead installing using the live server installer (.iso file) available on Cobbler's public HTTP share and specified in the kernel options.
 
 ## Ubuntu 24.04 PXE Deployment