Update README.html. Merge Institute.
authorMatt Birkholz <matt@birchwood-abbey.net>
Mon, 1 Jan 2024 17:49:38 +0000 (10:49 -0700)
committerMatt Birkholz <matt@birchwood-abbey.net>
Mon, 1 Jan 2024 17:49:38 +0000 (10:49 -0700)
Institute
README.html

index 7b40b58d92e692973165deb798b520bc2fce84d8..fc757e938e48de0c563667a47c7a509eb31fb3ef 160000 (submodule)
--- a/Institute
+++ b/Institute
@@ -1 +1 @@
-Subproject commit 7b40b58d92e692973165deb798b520bc2fce84d8
+Subproject commit fc757e938e48de0c563667a47c7a509eb31fb3ef
index a285d2b720c241e563155b080068deae56c0f629..18d5193e9fc84b36f1a1f002d178895f3e38a58d 100644 (file)
@@ -3,7 +3,7 @@
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 <head>
-<!-- 2023-12-30 Sat 14:12 -->
+<!-- 2024-01-01 Mon 10:48 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Birchwood Abbey Networks</title>
@@ -64,7 +64,7 @@ map is very similar, with differences mainly in terminology,
 philosophy, attitude.
 </p>
 
-<pre class="example" id="org77a527b">
+<pre class="example" id="org5eb02a9">
                 |                                                   
                 =                                                   
               _|||_                                                 
@@ -109,8 +109,10 @@ philosophy, attitude.
 <p>
 The abbey's public particulars are included below.  They are the
 public particulars of a small institute, nothing more.  As for the
-abbey's private data, examples (only! ;-) are included in the
-following chapters.
+abbey's private parameters, in <q>private/vars-abbey.yml</q>, example lines
+(only! ;-) are included in the following chapters.  An example of the
+abbey's private institutional parameters, <q>private/vars.yml</q>, can be
+found in <a href="Institute/private/vars.yml"><q>Institute/private/vars.yml</q></a>.
 </p>
 
 <div class="org-src-container">
@@ -134,8 +136,8 @@ with Apache2, spooling email with Postfix and serving it with
 Dovecot-IMAPd, and hosting a VPN with OpenVPN.
 </p>
 </div>
-<div id="outline-container-org862b8d5" class="outline-3">
-<h3 id="org862b8d5"><span class="section-number-3">3.1.</span> Install Emacs</h3>
+<div id="outline-container-org4777a67" class="outline-3">
+<h3 id="org4777a67"><span class="section-number-3">3.1.</span> Install Emacs</h3>
 <div class="outline-text-3" id="text-3-1">
 <p>
 The monks of the abbey are masters of the staff (bo) and Emacs.
@@ -787,7 +789,7 @@ certificate is a terminal session affair (with prompts and lines
 entered as shown below).
 </p>
 
-<pre class="example" id="org91548ff">
+<pre class="example" id="orge6cf15b">
 $ sudo apt install python3-certbot-apache
 $ sudo certbot --apache -d birchwood-abbey.net
 ...
@@ -1310,8 +1312,8 @@ The abbey uses the Apt-Cacher:TNG package cache on Core.  The
 </div>
 </div>
 </div>
-<div id="outline-container-org92fd293" class="outline-3">
-<h3 id="org92fd293"><span class="section-number-3">4.7.</span> Use Cloister Apt Cache</h3>
+<div id="outline-container-org1626d5e" class="outline-3">
+<h3 id="org1626d5e"><span class="section-number-3">4.7.</span> Use Cloister Apt Cache</h3>
 <div class="outline-text-3" id="text-4-7">
 <p>
 Core itself will benefit from using the package cache.
@@ -1808,9 +1810,9 @@ to the Ethernet interface of a "cable modem" (a Starlink terminal).
 </p>
 
 <p>
-The MAC address of each interface is set in <q>private/vars.yml</q>, the
-values of the <code>gate_lan_mac</code>, <code>gate_wifi_mac</code> and <code>gate_isp_mac</code>
-variables.
+The MAC address of each interface is set in <q>private/vars.yml</q> (see
+<a href="Institute/private/vars.yml"><q>Institute/private/vars.yml</q></a>) as the values of the <code>gate_lan_mac</code>,
+<code>gate_wifi_mac</code> and <code>gate_isp_mac</code> variables.
 </p>
 </div>
 </div>
@@ -1913,8 +1915,8 @@ clients: Android, Debian and Campus.  The last type never roams, and
 is not associated with a member of the small institute.
 </p>
 </div>
-<div id="outline-container-org1626d5e" class="outline-3">
-<h3 id="org1626d5e"><span class="section-number-3">6.1.</span> Use Cloister Apt Cache</h3>
+<div id="outline-container-orgf272ac0" class="outline-3">
+<h3 id="orgf272ac0"><span class="section-number-3">6.1.</span> Use Cloister Apt Cache</h3>
 <div class="outline-text-3" id="text-6-1">
 <p>
 The Apt-Cacher:TNG program does not work well on the frontier, so is
@@ -1984,8 +1986,8 @@ Raspberry Pis (architecture <code>aarch64</code>) only.
 </div>
 </div>
 </div>
-<div id="outline-container-org4777a67" class="outline-3">
-<h3 id="org4777a67"><span class="section-number-3">6.3.</span> Install Emacs</h3>
+<div id="outline-container-orgce301be" class="outline-3">
+<h3 id="orgce301be"><span class="section-number-3">6.3.</span> Install Emacs</h3>
 <div class="outline-text-3" id="text-6-3">
 <p>
 The monks of the abbey are masters of the staff and Emacs.
@@ -2052,7 +2054,7 @@ Listing them (e.g. running <code>owdir /26.nnnnnnnn</code> or <code>owdir
 below.  A test session is shown below.
 </p>
 
-<pre class="example" id="orgf4351fa">
+<pre class="example" id="orgd78ab99">
 monkey@new$ owdir
 ...
     /26.2153B6000000/
@@ -2488,8 +2490,8 @@ described in the final section, <a href="#org1115114">Configure Cameras</a>, bel
 </p>
 </div>
 </div>
-<div id="outline-container-org47847fe" class="outline-3">
-<h3 id="org47847fe"><span class="section-number-3">8.4.</span> Include Abbey Variables</h3>
+<div id="outline-container-org2965e55" class="outline-3">
+<h3 id="org2965e55"><span class="section-number-3">8.4.</span> Include Abbey Variables</h3>
 <div class="outline-text-3" id="text-8-4">
 <p>
 In this abbey specific document, most abbey particulars are not
@@ -2658,8 +2660,7 @@ the <code>apg -n 1 -x 12 -m 12</code> command.
 </p>
 
 <div class="org-src-container">
-<q>private/vars-abbey.yml</q><pre class="src src-conf">---
-zoneminder_dbpass:           gakJopbikJadsEdd
+<q>private/vars-abbey.yml</q><pre class="src src-conf">zoneminder_dbpass:           gakJopbikJadsEdd
 </pre>
 </div>
 
@@ -2923,8 +2924,8 @@ machine simply by adding it to the <code>tvrs</code> group.
 </p>
 </div>
 </div>
-<div id="outline-container-org2965e55" class="outline-3">
-<h3 id="org2965e55"><span class="section-number-3">9.3.</span> Include Abbey Variables</h3>
+<div id="outline-container-org569a9d4" class="outline-3">
+<h3 id="org569a9d4"><span class="section-number-3">9.3.</span> Include Abbey Variables</h3>
 <div class="outline-text-3" id="text-9-3">
 <p>
 In this abbey specific document, most abbey particulars are not
@@ -3476,7 +3477,7 @@ the list of "inputs" available in a postal code typically ends with
 the OTA (over the air) broadcasts.
 </p>
 
-<pre class="example" id="orgcb51fd6">
+<pre class="example" id="org6b26992">
 $ tv_grab_zz_sdjson --configure --config-file .mythtv/Mr.Antenna.xmltv
 Cache file for lineups, schedules and programs.
 Cache file: [/home/mythtv/.xmltv/tv_grab_zz_sdjson.cache]
@@ -4474,10 +4475,10 @@ A wired device is assigned an IP address when it is added to Core's
 DHCP configuration (as in <a href="#org9f0e885">Add to Core DHCP</a>).  A private domain name is
 then associated with this address.  If the device is intended to
 operate wirelessly, the name for its address is modified with a <code>-w</code>
-suffix.  Thus <code>new-w.birchwood.private</code> would be the name of the new
+suffix.  Thus <code>new-w.small.private</code> would be the name of the new
 device while it is temporarily connected to the cloister Ethernet, and
-<code>new.birchwood.private</code> would be its "normal" name used when it is on
-the cloister Wi-Fi.
+<code>new.small.private</code> would be its "normal" name used when it is on the
+cloister Wi-Fi.
 </p>
 
 <p>
@@ -4498,7 +4499,7 @@ at the top of that file.
 </p>
 
 <div class="org-src-container">
-<pre class="src src-conf">4       IN      PTR     new-w.birchwood.private.
+<pre class="src src-conf">4       IN      PTR     new-w.small.private.
 </pre>
 </div>
 
@@ -4508,7 +4509,7 @@ name can be tested.
 </p>
 
 <div class="org-src-container">
-<pre class="src src-sh">resolvectl query new-w.birchwood.private.
+<pre class="src src-sh">resolvectl query new-w.small.private.
 resolvectl query 192.168.56.4
 </pre>
 </div>
@@ -4523,7 +4524,7 @@ resolvectl query 192.168.56.4
 Create <q>/etc/apt/apt.conf.d/01proxy</q>.
 </p>
 <pre class="example">
-D=apt-cacher.birchwood.private.
+D=apt-cacher.small.private.
 echo "Acquire::http::Proxy \"http://$D:3142\";" \
 &gt; | sudo tee /etc/apt/apt.conf.d/01proxy
 </pre></li>
@@ -4777,7 +4778,7 @@ rm campus.ovpn public.ovpn
 ssh sysadm@dicks-notebook.lan
 sudo apt install openvpn openvpn-systemd-resolved <span class="org-sh-escaped-newline">\</span>
                  network-manager-openvpn-gnome
-ping -c1 core.birchwood.private.
+ping -c1 core.small.private.
 </pre>
 </div>
 
@@ -4843,10 +4844,10 @@ cloister Wi-Fi, and a "VPN address" when it connects to Gate's OpenVPN
 server.  The VPN address can be discovered by running <code>ip addr show
 dev ovpn</code> on the machine, or inspecting <q>/etc/openvpn/ipp.txt</q> on
 Gate.  Once discovered, a private domain name,
-e.g. <code>new.birchwood.private</code>, can be associated with the VPN address,
-e.g <code>10.84.138.7</code>.  The administrator adds a line like the following
-to <q>private/db.domain</q> and increments the serial number at the top of
-the file.
+e.g. <code>new.small.private</code>, can be associated with the VPN address, e.g
+<code>10.84.138.7</code>.  The administrator adds a line like the following to
+<q>private/db.domain</q> and increments the serial number at the top of the
+file.
 </p>
 
 <div class="org-src-container">
@@ -4861,7 +4862,7 @@ serial number at the top of that file.
 </p>
 
 <div class="org-src-container">
-<pre class="src src-conf">7       IN      PTR     new.birchwood.private.
+<pre class="src src-conf">7       IN      PTR     new.small.private.
 </pre>
 </div>
 
@@ -4871,7 +4872,7 @@ resolution of the new name.
 </p>
 
 <div class="org-src-container">
-<pre class="src src-sh">resolvectl query new.birchwood.private.
+<pre class="src src-sh">resolvectl query new.small.private.
 resolvectl query 10.84.138.7
 </pre>
 </div>
@@ -4879,7 +4880,7 @@ resolvectl query 10.84.138.7
 <p>
 A wireless device with no Ethernet interface and unable to run OpenVPN
 gets just a Wi-Fi address.  It can be given a private domain name
-(e.g. <code>new.birchwood.private</code>) associated with the Wi-Fi address
+(e.g. <code>new.small.private</code>) associated with the Wi-Fi address
 (e.g. <code>192.168.10.225</code>), but a reverse lookup on a machine connected
 to the Wi-Fi may yield a name like <code>new.lan</code> (provided by the access
 point) while elsewhere (e.g. on the cloister Ethernet) the IP address
@@ -4892,7 +4893,7 @@ to <q>private/db.campus_vpn</q>.)
 </div>
 <div id="postamble" class="status">
 <p class="author">Author: Matt Birkholz</p>
-<p class="date">Created: 2023-12-30 Sat 14:12</p>
+<p class="date">Created: 2024-01-01 Mon 10:48</p>
 <p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
 </div>
 </body>