Wordsmithing in the Cloistering chapter.
authorMatt Birkholz <matt@birchwood-abbey.net>
Thu, 18 Sep 2025 23:54:37 +0000 (17:54 -0600)
committerMatt Birkholz <matt@birchwood-abbey.net>
Fri, 19 Sep 2025 02:56:19 +0000 (20:56 -0600)
README.org

index 0e92216c218ee6c3b76a72816c3929dfdfcd711c..f0f8c3d97c1c724eaa738552550022cf6d2acd44 100644 (file)
@@ -2876,8 +2876,8 @@ last step:
 
 ** Raspberry Pis
 
-The abbey's Raspberry Pi runs the Raspberry Pi OS desktop off an
-external, USB3.0 SSD.  A fresh install should go something like this:
+The abbey's Raspberry Pi runs the Raspberry Pi OS desktop off an NVMe
+SSD.  A fresh install should go something like this:
 
 - Write the disk image, =2023-12-05-raspios-bookworm-arm64.img.xz=, to
   the SSD and plug it into the Pi.  Leave the µSD card socket empty.
@@ -2886,8 +2886,10 @@ external, USB3.0 SSD.  A fresh install should go something like this:
 - Answer first-boot installation questions:
   + Language: English (USA)
   + Keyboard: English (USA)
+  + root password: <blank>
+  + new user name: System Administrator
   + new username: sysadm
-  + new password: fubar
+  + new password: <password>
 - [[*Add to Core DHCP][Add to Core DHCP]]
 - [[*Create Wired Domain Name][Create Wired Domain Name]]
 - Log in as ~sysadm~ on the console.
@@ -2912,20 +2914,19 @@ Most of the abbey's machines, like Core and Gate, are general-purpose
 PCs running Debian.  The process of cloistering these machines
 follows.
 
-- Write the disk image, e.g. =debian-12.2.0-amd64-netinst.iso=, to a
-  USB drive and insert it in the PC.
-- Attach an HDMI monitor, a USB keyboard/mouse, and the cloister
+- Write the disk image, e.g. =debian-12.11.0-amd64-netinst.iso=, to a
+  USB drive and connect it to the PC.
+- Connect an HDMI monitor, a USB keyboard/mouse, and the cloister
   Ethernet, and power up.  Choose to boot from the USB drive.
-- Answer first-boot installation questions:
-  + Language: English (USA)
-  + Keyboard: English (USA)
-  + new username: sysadm
-  + new password: fubar
+- Answer first-boot installation questions as detailed in the
+  preparation of [[file:Institute/README.org*A Test Machine][A Test Machine]] for a Small Institute.
 - [[*Add to Core DHCP][Add to Core DHCP]]
 - [[*Create Wired Domain Name][Create Wired Domain Name]]
 - Log in as ~sysadm~ on the console.
 - [[*Update From Cloister Apt Cache][Update From Cloister Apt Cache]]
-- Install OpenSSH.  Plain Debian does not come with OpenSSH installed.
+- Install OpenSSH, unless it already was when included in the initial
+  Software selection during the Debian installation.  Run the
+  following if unsure.
   : sudo apt install openssh-server
 - [[*Authorize Remote Administration][Authorize Remote Administration]]
 - [[*Configure with Ansible][Configure with Ansible]]
@@ -3063,7 +3064,7 @@ domain name will be ~new~ (having had no ~-w~ suffix added).
 First ~new-w~ is added to Ansible's inventory in [[*=hosts=][=hosts=]].  A ~new-w~
 section is added to the list of all hosts, and an empty section of the
 same name is added to the list of ~campus~ hosts.  If the machine uses
-the usual privileged account name, ~sysadm~, the ~ansible_user~ key in
+the usual privileged account name, ~sysadm~, the ~ansible_user~ key is
 not needed.
 
 #+BEGIN_SRC conf
@@ -3320,7 +3321,6 @@ and do not appear in the host inventory.
     depending on whether the Android is connecting to the campus or
     public VPN.
 
-
 ** Create Wireless Domain Name
 
 A wireless machine is assigned a Wi-Fi address when it connects to the