Update README.html.
authorMatt Birkholz <matt@birchwood-abbey.net>
Wed, 30 Oct 2024 04:36:51 +0000 (21:36 -0700)
committerMatt Birkholz <matt@birchwood-abbey.net>
Wed, 30 Oct 2024 04:36:51 +0000 (21:36 -0700)
README.html

index 23df883ffbbad13577ab738058e6acf09cc2c359..cbd06877a901d2bebf365fdd8e093f7111164b55 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>
-<!-- 2024-10-22 Tue 10:04 -->
+<!-- 2024-10-29 Tue 21:35 -->
 <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="org988225d">
+<pre class="example" id="orgc2df0d2">
                 |                                                   
                 =                                                   
               _|||_                                                 
@@ -144,8 +144,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-org832124f" class="outline-3">
-<h3 id="org832124f"><span class="section-number-3">3.1.</span> Install Emacs</h3>
+<div id="outline-container-orgc296167" class="outline-3">
+<h3 id="orgc296167"><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.
@@ -660,9 +660,7 @@ needed because Postfix does not provide an emulation of <code>mail(1)</code> and
 some translation to <code>sendmail(1)</code> was required.  Since then the script
 has learned to compute the date-dependent file name, compress the log,
 convert it to base64, and encapsulate it in MIME format, before
-sending it on to <code>sendmail</code>.  Note that there is no encryption (yet).
-This is a low priority because much of the data is available to
-Droplet's ISP's Mom, the NSA/CIA/NWO.
+encrypting and sending to <code>sendmail</code>.
 </p>
 
 <div class="org-src-container">
@@ -681,22 +679,27 @@ Droplet's ISP's Mom, the NSA/CIA/NWO.
 <span class="org-keyword">fi</span>
 
 ( <span class="org-builtin">echo</span> <span class="org-string">"Subject: $2"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"Content-Type: multipart/mixed; boundary=\"boundary\""</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"MIME-Version: 1.0"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">""</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"--boundary"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"Content-Type: text/plain"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"Content-Transfer-Encoding: 8bit"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">""</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"$F"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"--boundary"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"Content-Type: application/gzip; name=\"$F\""</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"Content-Disposition: attachment; filename=\"$F\""</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"Content-Transfer-Encoding: base64"</span>
-  <span class="org-builtin">echo</span> <span class="org-string">""</span>
-  gzip | base64
   <span class="org-builtin">echo</span> <span class="org-string">""</span>
-  <span class="org-builtin">echo</span> <span class="org-string">"--boundary--"</span> ) | sendmail <span class="org-string">"$3"</span>
+  ( <span class="org-builtin">echo</span> <span class="org-string">"Content-Type: multipart/mixed; boundary=\"boundary\""</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"MIME-Version: 1.0"</span>
+    <span class="org-builtin">echo</span> <span class="org-string">""</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"--boundary"</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"Content-Type: text/plain"</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"Content-Transfer-Encoding: 8bit"</span>
+    <span class="org-builtin">echo</span> <span class="org-string">""</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"$F"</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"--boundary"</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"Content-Type: application/gzip; name=\"$F\""</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"Content-Disposition: attachment; filename=\"$F\""</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"Content-Transfer-Encoding: base64"</span>
+    <span class="org-builtin">echo</span> <span class="org-string">""</span>
+    gzip | base64
+    <span class="org-builtin">echo</span> <span class="org-string">""</span>
+    <span class="org-builtin">echo</span> <span class="org-string">"--boundary--"</span> ) <span class="org-sh-escaped-newline">\</span>
+  | gpg --encrypt --armor <span class="org-sh-escaped-newline">\</span>
+        --trust-model always --recipient root@core ) <span class="org-sh-escaped-newline">\</span>
+| sendmail root <span class="org-sh-escaped-newline">\</span>
+|| <span class="org-keyword">exit</span> $<span class="org-variable-name">?</span>
 </pre>
 </div>
 </div>
@@ -711,7 +714,7 @@ certificate is a terminal session affair (with prompts and lines
 entered as shown below).
 </p>
 
-<pre class="example" id="org39bc53f">
+<pre class="example" id="orgcccde57">
 $ sudo apt install python3-certbot-apache
 $ sudo certbot --apache -d birchwood-abbey.net
 ...
@@ -855,7 +858,7 @@ The following task arranges to rotate Certbot's logs files.
 <div class="outline-text-3" id="text-3-11">
 <p>
 A backup copy of Let's Encrypt's data (<q>/etc/letsencrypt/</q>) is sent to
-<code>root@core</code> in S/MIME encrypted email every time it changes.  Changes
+<code>root@core</code> in OpenPGP encrypted email every time it changes.  Changes
 are detected by keeping a copy in <q>/etc/letsencrypt~/</q> for comparison.
 </p>
 
@@ -930,8 +933,8 @@ with Postfix and Dovecot, and providing essential localnet services:
 NTP, DNS and DHCP.
 </p>
 </div>
-<div id="outline-container-org3e1f87c" class="outline-3">
-<h3 id="org3e1f87c"><span class="section-number-3">4.1.</span> Include Abbey Variables</h3>
+<div id="outline-container-orgb645c48" class="outline-3">
+<h3 id="orgb645c48"><span class="section-number-3">4.1.</span> Include Abbey Variables</h3>
 <div class="outline-text-3" id="text-4-1">
 <p>
 In this abbey specific document, most abbey particulars are not
@@ -1127,8 +1130,8 @@ The abbey uses the Apt-Cacher:TNG package cache on Core.  The
 </div>
 </div>
 </div>
-<div id="outline-container-orgedd1215" class="outline-3">
-<h3 id="orgedd1215"><span class="section-number-3">4.8.</span> Use Cloister Apt Cache</h3>
+<div id="outline-container-org28d77ae" class="outline-3">
+<h3 id="org28d77ae"><span class="section-number-3">4.8.</span> Use Cloister Apt Cache</h3>
 <div class="outline-text-3" id="text-4-8">
 <p>
 Core itself will benefit from using the package cache, but should
@@ -1938,8 +1941,8 @@ hosts never roam, are not associated with a member, and so are
 ./abbey client campus new-host-name
 </pre>
 </div>
-<div id="outline-container-org28d77ae" class="outline-3">
-<h3 id="org28d77ae"><span class="section-number-3">6.1.</span> Use Cloister Apt Cache</h3>
+<div id="outline-container-orga2718da" class="outline-3">
+<h3 id="orga2718da"><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
@@ -2061,8 +2064,8 @@ them.
 </div>
 </div>
 </div>
-<div id="outline-container-orgc296167" class="outline-3">
-<h3 id="orgc296167"><span class="section-number-3">6.4.</span> Install Emacs</h3>
+<div id="outline-container-org2981d17" class="outline-3">
+<h3 id="org2981d17"><span class="section-number-3">6.4.</span> Install Emacs</h3>
 <div class="outline-text-3" id="text-6-4">
 <p>
 The monks of the abbey are masters of the staff and Emacs.
@@ -2536,8 +2539,8 @@ machine simply by adding it to the <code>tvrs</code> group.
 </p>
 </div>
 </div>
-<div id="outline-container-orgb645c48" class="outline-3">
-<h3 id="orgb645c48"><span class="section-number-3">9.3.</span> Include Abbey Variables</h3>
+<div id="outline-container-orgd0b322a" class="outline-3">
+<h3 id="orgd0b322a"><span class="section-number-3">9.3.</span> Include Abbey Variables</h3>
 <div class="outline-text-3" id="text-9-3">
 <p>
 Private variables in <q>private/vars-abbey.yml</q> are needed, as in the
@@ -3083,7 +3086,7 @@ the list of "inputs" available in a postal code typically ends with
 the OTA (over the air) broadcasts.
 </p>
 
-<pre class="example" id="org7599441">
+<pre class="example" id="orgdf36587">
 $ tv_grab_zz_sdjson --configure --config-file .mythtv/Mr.Antenna.xml
 Cache file for lineups, schedules and programs.
 Cache file: [/home/mythtv/.xmltv/tv_grab_zz_sdjson.cache]
@@ -3372,6 +3375,24 @@ program as user <code>mythtv</code>.
 The program will prompt for the zip code and offer a list of "inputs"
 available in that area, as described in <a href="#org720bce1">Configure XMLTV</a>.
 </p>
+
+<p>
+Then the administrator can re-start the backend.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-sh">sudo systemctl start mythtv-backend
+</pre>
+</div>
+
+<p>
+And the <code>mythtv</code> account can run <code>mythfilldatabase</code>.
+</p>
+
+<div class="org-src-container">
+<pre class="src src-sh">mythfilldatabase
+</pre>
+</div>
 </div>
 </div>
 </div>
@@ -4584,7 +4605,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: 2024-10-22 Tue 10:04</p>
+<p class="date">Created: 2024-10-29 Tue 21:35</p>
 <p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
 </div>
 </body>