lab:stack_of_nucs:nuc_1
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
| lab:stack_of_nucs:nuc_1 [2023/05/01 19:00] – created user | lab:stack_of_nucs:nuc_1 [2024/05/06 02:12] (current) – removed user | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== NUC 1 ====== | ||
| - | This is the first NUC in the [[: | ||
| - | References: | ||
| - | * [[https:// | ||
| - | |||
| - | Hardware: | ||
| - | * [[https:// | ||
| - | * 16GB RAM (8GB is my recommendation) | ||
| - | * 32GB storage | ||
| - | * Wireless | ||
| - | |||
| - | Software: | ||
| - | * Ubuntu 22.04 LTS desktop | ||
| - | |||
| - | Purpose: | ||
| - | * Linux desktop machine to facilitate the following: | ||
| - | * create modified ISO for the boot USB stick | ||
| - | * create boot USB stick from the new ISO | ||
| - | * create CIDATA USB stick | ||
| - | * create firmware upgrade USB stick | ||
| - | * create SSH management keys | ||
| - | * connect to the other NUCs you build | ||
| - | |||
| - | ====== Step 1 - Install Ubuntu Desktop ====== | ||
| - | Install Ubuntu Desktop - [[https:// | ||
| - | * This process will step you through downloading the latest file and creating a bootable USB stick | ||
| - | * To boot from the bootable USB stick | ||
| - | * Insert the USB stick | ||
| - | * Reboot the NUC | ||
| - | * Press F10 at the boot prompt | ||
| - | * Select the USB stick (USB EUFI) | ||
| - | |||
| - | ====== Step 2 - Update Packages and Generate SSH Key ====== | ||
| - | * Log in to the NUC ([[NUC 1]]) and perform the usual software updates and install software packages | ||
| - | * <file bash> | ||
| - | sudo apt update && sudo apt upgrade -y | ||
| - | sudo apt install xorriso squashfs-tools python3-debian gpg liblz4-tool arp-scan notepadqq python3-pip -y | ||
| - | </ | ||
| - | * Generate key for ssh | ||
| - | * '' | ||
| - | * accept default settings and don't enter a passphrase | ||
| - | |||
| - | ====== Step 3 - Create Modified Bootable Ubuntu Server USB Stick ====== | ||
| - | These steps are performed while logged in on [[NUC 1]]. | ||
| - | - Download the latest __live-server__ ISO from [[https:// | ||
| - | * move this file to your home directory | ||
| - | - Open the terminal (you should be in your home directory be default) | ||
| - | - Install livefs-editor, | ||
| - | * <file bash> | ||
| - | git clone https:// | ||
| - | cd livefs-editor | ||
| - | sudo python3 -m pip install . | ||
| - | </ | ||
| - | * Return to your home directory (i.e., '' | ||
| - | - Create modified live-server ISO | ||
| - | - Copy the grub.cfg file from the ISO file | ||
| - | * Set the ORIG_ISO filename to the actual file you downloaded. In this example I will use '' | ||
| - | * <file bash> | ||
| - | export ORIG_ISO=" | ||
| - | mkdir mnt | ||
| - | mount -o loop $(ORIG_ISO) mnt | ||
| - | cp --no-preserve=all mnt/ | ||
| - | umount nnt | ||
| - | sed -i ' | ||
| - | sed -i ' | ||
| - | export MODDED_ISO=" | ||
| - | livefs-edit ../ | ||
| - | </ | ||
| - | - Create bootable USB from the modified ISO | ||
| - | * Use [[https:// | ||
| - | |||
| - | ====== Step 4 - Create CIDATA USB Stick ====== | ||
| - | Create a USB stick named CIDATA as a cloud-init datasource | ||
| - | - Unplug the bootable USB stick you just created | ||
| - | - Plug in the USB that will be erased and used as the cloud-init datasource | ||
| - | - Identify the USB stick device name | ||
| - | * '' | ||
| - | * be SURE you pick the right one! | ||
| - | - Format the USB disk (assuming it's sdb in this example) | ||
| - | - Unmount it: '' | ||
| - | - Format it: '' | ||
| - | - Confirm: '' | ||
| - | - Create meta-data file on CIDATA (assuming it's sdb in this example) | ||
| - | * <file bash> | ||
| - | mkdir /tmp/cidata | ||
| - | sudo mount /dev/sdb /tmp/cidata | ||
| - | cd /tmp/cidata | ||
| - | touch meta-data | ||
| - | touch user-data | ||
| - | </ | ||
| - | - Modify the user-data file on CIDATA | ||
| - | * You can create the use using a text editor (notepadqq was installed earlier) or use the command line | ||
| - | * :!: Replace the key(s) in the example with the output from your computer for: | ||
| - | * '' | ||
| - | * :!: Replace the WiFi SSID name and PASSWORD with your WiFi SSID and passphrase | ||
| - | * <file yaml user-data> | ||
| - | # | ||
| - | autoinstall: | ||
| - | version: 1 | ||
| - | ssh: | ||
| - | install-server: | ||
| - | # option " | ||
| - | allow-pw: false | ||
| - | |||
| - | # " | ||
| - | late-commands: | ||
| - | # randomly generate the hostname & show the IP at boot | ||
| - | - echo nuc-host-$(openssl rand -hex 3) > / | ||
| - | # dump the IP out at login screen | ||
| - | - echo " | ||
| - | # merge storage to use 100% use of the file system | ||
| - | - curtin in-target --target=/ | ||
| - | - curtin in-target --target=/ | ||
| - | # shut-down the host to avoid an infinite installer loop | ||
| - | - shutdown -h now | ||
| - | |||
| - | user-data: | ||
| - | disable_root: | ||
| - | timezone: America/ | ||
| - | package_upgrade: | ||
| - | packages: | ||
| - | - network-manager | ||
| - | runcmd: | ||
| - | - nmcli d wifi connect SSID password PASSWORD | ||
| - | users: | ||
| - | - name: tux | ||
| - | primary_group: | ||
| - | groups: sudo | ||
| - | lock_passwd: | ||
| - | # don't need PW since using SSH, leaving this in though... | ||
| - | # password is " | ||
| - | # passwd: " | ||
| - | shell: /bin/bash | ||
| - | # use cat ~/ | ||
| - | ssh_authorized_keys: | ||
| - | - " | ||
| - | sudo: ALL=(ALL) NOPASSWD: | ||
| - | - name: ansible | ||
| - | gecos: Ansible User | ||
| - | primary_group: | ||
| - | groups: sudo | ||
| - | sudo: ALL=(ALL) NOPASSWD: | ||
| - | shell: /bin/bash | ||
| - | lock_passwd: | ||
| - | ssh_authorized_keys: | ||
| - | - " | ||
| - | # shutdown after first host initial provisioning | ||
| - | power_state: | ||
| - | mode: poweroff | ||
| - | </ | ||
| - | - Unmount the USB stick | ||
| - | - '' | ||
| - | - Remove the USB stick | ||
| - | - Test boot setup on a different NUC | ||
| - | - Insert both USBs into the (powered off) test NUC | ||
| - | - Connect the test NUC to your wired Lab network (which has Internet access) | ||
| - | - Power on the NUC | ||
| - | - Press F10 when prompted and select the USB bootable USB stick ("USB UEFI") | ||
| - | - Be patient | ||
| - | * if the user-data file is configured to update packages, be aware this requires additional time | ||
| - | * if the ISO is older, it may take a while to download and install all the security updates | ||
| - | - When the NUC powers down the first time, remove the USB sticks, then power it back on | ||
| - | - When the NUC powers down the second time, it is ready to deploy | ||
| - | * the WiFi connection should work at this point, so you don't need the wired Internet connection at this point | ||
| - | * power back on when you are ready | ||
| - | - Test ssh from NUC 1 to the test NUC | ||
| - | * identify the IP address on the NUC | ||
| - | * '' | ||
| - | |||
| - | ====== Next Step ====== | ||
| - | You now have a working auto installation process! You can now proceed to building [[Stack - NUC 2|NUC 2]]. | ||
| - | |||
| - | ====== Optional ====== | ||
| - | The following method is one way to set up all host keys so you aren't prompted to accept then when opening a SSH connection. | ||
| - | |||
| - | Set up SSH management keys | ||
| - | * once all your NUCs are up, you can use this script to add all of them to your ssh known_hosts file | ||
| - | * <code bash> | ||
| - | IPs=$(sudo arp-scan --localnet --numeric --quiet --ignoredups | grep -E ' | ||
| - | for i in $(IPs" | ||
| - | </ | ||
| - | |||
| - | ====== Lab Notes ====== | ||
| - | Ubuntu will automatically download and install all security updates over the Internet as part of the automatic installation. As your ISO image gets older (and more security updates need to be installed), the build process will take longer and longer. Update your ISO boot USB stick to keep installation as fast as possible. | ||
lab/stack_of_nucs/nuc_1.1682967612.txt.gz · Last modified: 2023/05/01 19:00 by user