Overhaul 1-prep/README.rst etc

roles/1-prep/README.rst

@@ -2,21 +2,24 @@
 1-prep README
 =============
 
-This 1st `stage <https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible>`_ (1-prep) is primarily hardware-focused, prior to OS
-additions/mods — but also includes critical pieces sometimes needed for
-remote support:
+This 1st `stage <https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible>`_ (1-prep) arranges low-level things like hardware, DNS, basic security -- and critical pieces sometimes needed for remote support:
 
-- dnsmasq
-- /etc/iiab/uuid
-- Customizing /var/log/* for Ubermix on each boot, using /etc/tmpfiles.d
-- SSH
-- `iiab-admin <https://github.com/iiab/iiab/tree/master/roles/iiab-admin>`_ username and group to log into Admin Console
-- OpenVPN software if/as needed later for remote support
-- `raspberry_pi.yml <tasks/raspberry_pi.yml>`_ including RTC, essential packages, and networking basics
+- SSHD
+- OpenVPN if/as needed later for remote support
+- `iiab-admin <https://github.com/iiab/iiab/tree/master/roles/iiab-admin#iiab-admin-readme>`_ username and group, to log into Admin Console
+- dnsmasq (install now, configure later!)
+- Universally unique identifier: /etc/iiab/uuid
+- Ubermix (distro) needs /etc/tmpfiles.d/iiab.conf to create essential /var/log subdirs on each boot
+- Hardware actions:
+   - `raspberry_pi.yml <tasks/raspberry_pi.yml>`_:
+      - RTC (real-time clock): install udev rule, configure, enable
+      - Install packages related to:
+         - growpart
+         - swapfile
+         - fake-hwclock (as RTC is often missing or dead!)
+         - Wi-Fi
+      - Increase swap file size
+      - rootfs auto-resizing
+   - NUC 6 Wi-Fi firmware
 
-Traditionally 1-prep also included preliminaries like hostname and
-hardware-oriented things specific to a particular platform (such as
-One Laptop Per Child's XO laptop) i.e. critical setup prior to the
-bulk of IIAB's software install.
-
-Recap: Similar to 0-init, 2-common, 3-base-server, 4 server-options and 5-xo-services ⁠— this 1st stage installs core server infra (that is not user-facing).
+Recap: Similar to 0-init, 2-common, 3-base-server, 4 server-options and 5-xo-services  — this 1st stage installs core server infra (that is not user-facing).

roles/1-prep/tasks/main.yml

@@ -24,7 +24,7 @@
 
 - include_tasks: uuid.yml
 - include_tasks: ubermix.yml
-- include_tasks: hw_platforms.yml
+- include_tasks: hardware.yml
 
 
 # Debian 10 "Buster" is apparently enabling AppArmor in 2019:

roles/1-prep/tasks/raspberry_pi.yml

@@ -31,6 +31,7 @@
 #    line: 'include btcfg.txt'
 #  when: is_ubuntu
 
+
 - name: '2021-07-27: SEE ALSO ~4 networking packages LATER installed by https://github.com/iiab/iiab/blob/master/roles/2-common/tasks/packages.yml'
   meta: noop
 
@@ -55,6 +56,7 @@
       - wireless-tools    # 2021-07-27: RaspiOS installs this regardless -- manipulate Linux Wireless Extensions
     state: present
 
+
 - name: Increase swap file size (to CONF_SWAPSIZE={{ pi_swap_file_size }} in /etc/dphys-swapfile) as kalite pip download fails
   lineinfile:
     path: /etc/dphys-swapfile
@@ -67,6 +69,7 @@
     name: dphys-swapfile
     state: restarted
 
+
 - name: Install RPi rootfs resizing (/usr/sbin/iiab-rpi-max-rootfs.sh) and its systemd service (/etc/systemd/system/iiab-rpi-root-resize.service), from templates (root:root by default)
   template:
     src: "{{ item.src }}"

roles/2-common/tasks/main.yml

@@ -13,6 +13,7 @@
 
 - include_tasks: iiab-startup.yml
 
+
 # UNMAINTAINED
 #- include_tasks: centos.yml
 #  when: ansible_distribution == "CentOS"
@@ -39,6 +40,7 @@
 #    dest: /etc/profile.d/zzz_iiab.sh
 #    src: zzz_iiab.sh
 
+
 - name: Recording STAGE 2 HAS COMPLETED ==========================
   lineinfile:
     path: "{{ iiab_env_file }}"

roles/4-server-options/tasks/main.yml

@@ -23,6 +23,7 @@
     name: sshd
   when: sshd_install
 
+
 # UNMAINTAINED
 - name: Install named / BIND
   include_tasks: roles/network/tasks/named.yml
@@ -38,6 +39,7 @@
   include_tasks: roles/network/tasks/squid.yml
   when: squid_install is defined and squid_install
 
+
 - name: Install Bluetooth - only on Raspberry Pi
   include_role:
     name: bluetooth
@@ -69,6 +71,7 @@
     name: www_options
   #when: www_options_install    # Flag might be created in future?
 
+
 - name: Recording STAGE 4 HAS COMPLETED ==================
   lineinfile:
     path: "{{ iiab_env_file }}"