projects / Institute / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 17db132)
Update README.html.
authorMatt Birkholz <matt@birchwood-abbey.net>
Tue, 3 Sep 2024 14:44:12 +0000 (08:44 -0600)
committerMatt Birkholz <matt@birchwood-abbey.net>
Tue, 3 Sep 2024 14:44:12 +0000 (08:44 -0600)
README.html patch | blob | history

diff --git a/README.html b/README.html
index 342fbbd18051784824501c1e5f66fb7d7f3f2f18..720bf1b8cfa01303be473d166e2f764d53fd41c0 100644 (file)
--- a/README.html
+++ b/README.html
@@ -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-05-08 Wed 14:42 -->
+<!-- 2024-09-03 Tue 08:43 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>A Small Institute</title>
@@ -48,7 +48,7 @@ connects to Front making the institute email, cloud, etc. available to
 members off campus.
 </p>
 
-<pre class="example" id="org45c8e96">
+<pre class="example" id="orgc59e2f6">
                 =                                                   
               _|||_                                                 
         =-The-Institute-=                                           
@@ -1022,7 +1022,7 @@ example result follows the code.
 </pre>
 </div>
 
-<div class="TEXT" id="org42b732b">
+<div class="TEXT" id="orga0874e6">
 <p>
 =&gt; 10.62.17.0/24
 </p>
@@ -1475,7 +1475,7 @@ USB-Ethernet adapter, or a wireless adapter connected to a
 campground Wi-Fi access point, etc.</li>
 </ol>
 
-<pre class="example" id="org42f1391">
+<pre class="example" id="org393f96f">
 =============== | ==================================================
                 |                                           Premises
           (Campus ISP)                                              
@@ -1498,7 +1498,7 @@ This avoids the need for a second Wi-Fi access point and leads to the
 following topology.
 </p>
 
-<pre class="example" id="org3745e1f">
+<pre class="example" id="orgbaffd1d">
 =============== | ==================================================
                 |                                           Premises
            (House ISP)                                              
@@ -1651,8 +1651,8 @@ The <code>all</code> role contains tasks that are executed on all of the
 institute's servers.  At the moment there is just the one.
 </p>
 </div>
-<div id="outline-container-orgf4bacc5" class="outline-3">
-<h3 id="orgf4bacc5"><span class="section-number-3">6.1.</span> Include Particulars</h3>
+<div id="outline-container-org76ba4d0" class="outline-3">
+<h3 id="org76ba4d0"><span class="section-number-3">6.1.</span> Include Particulars</h3>
 <div class="outline-text-3" id="text-6-1">
 <p>
 The <code>all</code> role's task contains a reference to a common institute
@@ -1793,8 +1793,8 @@ uses the institute's CA and server certificates, and expects client
 certificates signed by the institute CA.
 </p>
 </div>
-<div id="outline-container-org3abef52" class="outline-3">
-<h3 id="org3abef52"><span class="section-number-3">7.1.</span> Include Particulars</h3>
+<div id="outline-container-org530ccf9" class="outline-3">
+<h3 id="org530ccf9"><span class="section-number-3">7.1.</span> Include Particulars</h3>
 <div class="outline-text-3" id="text-7-1">
 <p>
 The first task, as in <a href="#orgd60dcd1">The All Role</a>, is to include the institute
@@ -1819,8 +1819,8 @@ membership roll, so these are included was well.
 </div>
 </div>
 </div>
-<div id="outline-container-org5206757" class="outline-3">
-<h3 id="org5206757"><span class="section-number-3">7.2.</span> Configure Hostname</h3>
+<div id="outline-container-orgaab41cc" class="outline-3">
+<h3 id="orgaab41cc"><span class="section-number-3">7.2.</span> Configure Hostname</h3>
 <div class="outline-text-3" id="text-7-2">
 <p>
 This task ensures that Front's <q>/etc/hostname</q> and <q>/etc/mailname</q> are
@@ -1850,8 +1850,8 @@ delivery.
 </div>
 </div>
 </div>
-<div id="outline-container-org6909535" class="outline-3">
-<h3 id="org6909535"><span class="section-number-3">7.3.</span> Add Administrator to System Groups</h3>
+<div id="outline-container-org1c6c567" class="outline-3">
+<h3 id="org1c6c567"><span class="section-number-3">7.3.</span> Add Administrator to System Groups</h3>
 <div class="outline-text-3" id="text-7-3">
 <p>
 The administrator often needs to read (directories of) log files owned
@@ -1910,8 +1910,8 @@ those stored in <a href="Secret/ssh_front/etc/ssh/"><q>Secret/ssh_front/etc/ssh/
 </div>
 </div>
 </div>
-<div id="outline-container-org4e16e32" class="outline-3">
-<h3 id="org4e16e32"><span class="section-number-3">7.5.</span> Configure Monkey</h3>
+<div id="outline-container-org3c1e478" class="outline-3">
+<h3 id="org3c1e478"><span class="section-number-3">7.5.</span> Configure Monkey</h3>
 <div class="outline-text-3" id="text-7-5">
 <p>
 The small institute runs cron jobs and web scripts that generate
@@ -1967,8 +1967,8 @@ Monkey uses Rsync to keep the institute's public web site up-to-date.
 </div>
 </div>
 </div>
-<div id="outline-container-orgeed5ae9" class="outline-3">
-<h3 id="orgeed5ae9"><span class="section-number-3">7.7.</span> Install Unattended Upgrades</h3>
+<div id="outline-container-orgc0c5126" class="outline-3">
+<h3 id="orgc0c5126"><span class="section-number-3">7.7.</span> Install Unattended Upgrades</h3>
 <div class="outline-text-3" id="text-7-7">
 <p>
 The institute prefers to install security updates as soon as possible.
@@ -1983,8 +1983,8 @@ The institute prefers to install security updates as soon as possible.
 </div>
 </div>
 </div>
-<div id="outline-container-orgc8ba404" class="outline-3">
-<h3 id="orgc8ba404"><span class="section-number-3">7.8.</span> Configure User Accounts</h3>
+<div id="outline-container-orgd6eddb7" class="outline-3">
+<h3 id="orgd6eddb7"><span class="section-number-3">7.8.</span> Configure User Accounts</h3>
 <div class="outline-text-3" id="text-7-8">
 <p>
 User accounts are created immediately so that Postfix and Dovecot can
@@ -2027,8 +2027,8 @@ recipient" replies.  The <a href="#orge7fe793">Account Management</a> chapter de
 </div>
 </div>
 </div>
-<div id="outline-container-org19b4e27" class="outline-3">
-<h3 id="org19b4e27"><span class="section-number-3">7.9.</span> Install Server Certificate</h3>
+<div id="outline-container-orgcf49e25" class="outline-3">
+<h3 id="orgcf49e25"><span class="section-number-3">7.9.</span> Install Server Certificate</h3>
 <div class="outline-text-3" id="text-7-9">
 <p>
 The servers on Front use the same certificate (and key) to
@@ -2255,8 +2255,8 @@ created by a more specialized role.
 </div>
 </div>
 </div>
-<div id="outline-container-orgbb94cf7" class="outline-3">
-<h3 id="orgbb94cf7"><span class="section-number-3">7.12.</span> Configure Dovecot IMAPd</h3>
+<div id="outline-container-org08dd9e3" class="outline-3">
+<h3 id="org08dd9e3"><span class="section-number-3">7.12.</span> Configure Dovecot IMAPd</h3>
 <div class="outline-text-3" id="text-7-12">
 <p>
 Front uses Dovecot's IMAPd to allow user Fetchmail jobs on Core to
@@ -2612,8 +2612,8 @@ the users' <q>~/Public/HTML/</q> directories.
 </div>
 </div>
 </div>
-<div id="outline-container-org7469fd3" class="outline-3">
-<h3 id="org7469fd3"><span class="section-number-3">7.14.</span> Configure OpenVPN</h3>
+<div id="outline-container-orgaf75396" class="outline-3">
+<h3 id="orgaf75396"><span class="section-number-3">7.14.</span> Configure OpenVPN</h3>
 <div class="outline-text-3" id="text-7-14">
 <p>
 Front uses OpenVPN to provide the institute's public VPN service.  The
@@ -2846,7 +2846,8 @@ be started before the <code>tun</code> device has appeared.
 <a href="roles_t/front/handlers/main.yml"><q>roles_t/front/handlers/main.yml</q></a><pre class="src src-conf">
 - name: Reload Systemd.
   become: yes
-  command: systemctl daemon-reload
+  systemd:
+    daemon-reload: yes
 </pre>
 </div>
 
@@ -2896,8 +2897,8 @@ Debian install and remote access to a privileged, administrator's
 account.  (For details, see <a href="#org8d60b7b">The Core Machine</a>.)
 </p>
 </div>
-<div id="outline-container-org168f170" class="outline-3">
-<h3 id="org168f170"><span class="section-number-3">8.1.</span> Include Particulars</h3>
+<div id="outline-container-org215b0ac" class="outline-3">
+<h3 id="org215b0ac"><span class="section-number-3">8.1.</span> Include Particulars</h3>
 <div class="outline-text-3" id="text-8-1">
 <p>
 The first task, as in <a href="#org9240129">The Front Role</a>, is to include the institute
@@ -2919,8 +2920,8 @@ particulars and membership roll.
 </div>
 </div>
 </div>
-<div id="outline-container-org12b7127" class="outline-3">
-<h3 id="org12b7127"><span class="section-number-3">8.2.</span> Configure Hostname</h3>
+<div id="outline-container-org8638d54" class="outline-3">
+<h3 id="org8638d54"><span class="section-number-3">8.2.</span> Configure Hostname</h3>
 <div class="outline-text-3" id="text-8-2">
 <p>
 This task ensures that Core's <q>/etc/hostname</q> and <q>/etc/mailname</q> are
@@ -2953,8 +2954,8 @@ proper email delivery.
 </div>
 </div>
 </div>
-<div id="outline-container-org965db3d" class="outline-3">
-<h3 id="org965db3d"><span class="section-number-3">8.3.</span> Configure Systemd Resolved</h3>
+<div id="outline-container-orgf60b98e" class="outline-3">
+<h3 id="orgf60b98e"><span class="section-number-3">8.3.</span> Configure Systemd Resolved</h3>
 <div class="outline-text-3" id="text-8-3">
 <p>
 Core runs the campus name server, so Resolved is configured to use it
@@ -2986,7 +2987,8 @@ list, and to disable its cache and stub listener.
 <a href="roles_t/core/handlers/main.yml"><q>roles_t/core/handlers/main.yml</q></a><pre class="src src-conf">
 - name: Reload Systemd.
   become: yes
-  command: systemctl daemon-reload
+  systemd:
+    daemon-reload: yes
 
 - name: Restart Systemd resolved.
   become: yes
@@ -3159,10 +3161,9 @@ with the real <a href="private/core-dhcpd.conf"><q>private/core-dhcpd.conf</q></
 <h3 id="org2134214"><span class="section-number-3">8.6.</span> Configure BIND9</h3>
 <div class="outline-text-3" id="text-8-6">
 <p>
-Core uses BIND9 to provide a private-view name service for the
-institute as described in <a href="#org12ea1d0">The Name Service</a>.  The configuration
-supports reverse name lookups, resolving many private network
-addresses to private domain names.
+Core uses BIND9 to provide name service for the institute as described
+in <a href="#org12ea1d0">The Name Service</a>.  The configuration supports reverse name lookups,
+resolving many private network addresses to private domain names.
 </p>
 
 <p>
@@ -3367,8 +3368,8 @@ probably be used as forwarders rather than Google.
 </div>
 </div>
 </div>
-<div id="outline-container-orgd1f4c06" class="outline-3">
-<h3 id="orgd1f4c06"><span class="section-number-3">8.7.</span> Add Administrator to System Groups</h3>
+<div id="outline-container-org13a7457" class="outline-3">
+<h3 id="org13a7457"><span class="section-number-3">8.7.</span> Add Administrator to System Groups</h3>
 <div class="outline-text-3" id="text-8-7">
 <p>
 The administrator often needs to read (directories of) log files owned
@@ -3388,8 +3389,8 @@ these groups speeds up debugging.
 </div>
 </div>
 </div>
-<div id="outline-container-org91d0903" class="outline-3">
-<h3 id="org91d0903"><span class="section-number-3">8.8.</span> Configure Monkey</h3>
+<div id="outline-container-org920462d" class="outline-3">
+<h3 id="org920462d"><span class="section-number-3">8.8.</span> Configure Monkey</h3>
 <div class="outline-text-3" id="text-8-8">
 <p>
 The small institute runs cron jobs and web scripts that generate
@@ -3456,8 +3457,8 @@ described in <a href="#org1ac6235">*Configure Apache2</a>).
 </div>
 </div>
 </div>
-<div id="outline-container-org10376d0" class="outline-3">
-<h3 id="org10376d0"><span class="section-number-3">8.9.</span> Install Unattended Upgrades</h3>
+<div id="outline-container-orgc30ba4d" class="outline-3">
+<h3 id="orgc30ba4d"><span class="section-number-3">8.9.</span> Install Unattended Upgrades</h3>
 <div class="outline-text-3" id="text-8-9">
 <p>
 The institute prefers to install security updates as soon as possible.
@@ -3489,8 +3490,8 @@ with Nextcloud on the command line.
 </div>
 </div>
 </div>
-<div id="outline-container-org8597071" class="outline-3">
-<h3 id="org8597071"><span class="section-number-3">8.11.</span> Configure User Accounts</h3>
+<div id="outline-container-org873ab4b" class="outline-3">
+<h3 id="org873ab4b"><span class="section-number-3">8.11.</span> Configure User Accounts</h3>
 <div class="outline-text-3" id="text-8-11">
 <p>
 User accounts are created immediately so that backups can begin
@@ -3532,8 +3533,8 @@ describes the <code>members</code> and <code>usernames</code> variables.
 </div>
 </div>
 </div>
-<div id="outline-container-org2e22fe0" class="outline-3">
-<h3 id="org2e22fe0"><span class="section-number-3">8.12.</span> Install Server Certificate</h3>
+<div id="outline-container-org0b2d499" class="outline-3">
+<h3 id="org0b2d499"><span class="section-number-3">8.12.</span> Install Server Certificate</h3>
 <div class="outline-text-3" id="text-8-12">
 <p>
 The servers on Core use the same certificate (and key) to authenticate
@@ -3757,8 +3758,8 @@ installed by more specialized roles.
 </div>
 </div>
 </div>
-<div id="outline-container-org9e726e1" class="outline-3">
-<h3 id="org9e726e1"><span class="section-number-3">8.16.</span> Configure Dovecot IMAPd</h3>
+<div id="outline-container-orge854133" class="outline-3">
+<h3 id="orge854133"><span class="section-number-3">8.16.</span> Configure Dovecot IMAPd</h3>
 <div class="outline-text-3" id="text-8-16">
 <p>
 Core uses Dovecot's IMAPd to store and serve member emails.  As on
@@ -5508,8 +5509,8 @@ applied first, by which Gate gets a campus machine's DNS and Postfix
 configurations, etc.
 </p>
 </div>
-<div id="outline-container-org97c93fd" class="outline-3">
-<h3 id="org97c93fd"><span class="section-number-3">9.1.</span> Include Particulars</h3>
+<div id="outline-container-orgd5b1e01" class="outline-3">
+<h3 id="orgd5b1e01"><span class="section-number-3">9.1.</span> Include Particulars</h3>
 <div class="outline-text-3" id="text-9-1">
 <p>
 The following should be familiar boilerplate by now.
@@ -5819,7 +5820,10 @@ command would not be necessary.
 
 <p>
 Installation and configuration of the DHCP daemon follows.  Note that
-the daemon listens <i>only</i> on the Gate-WiFi network interface.
+the daemon listens <i>only</i> on the Gate-WiFi network interface.  Also
+note the drop-in <code>Requires</code> dependency, without which the DHCP server
+intermittently fails, finding the <code>wifi</code> interface has no IPv4
+addresses (or perhaps finding no <code>wifi</code> interface at all?).
 </p>
 
 <div class="org-src-container">
@@ -5836,6 +5840,15 @@ the daemon listens <i>only</i> on the Gate-WiFi network interface.
     <span class="org-variable-name">regexp: ^INTERFACESv4</span>=
   notify: Restart DHCP server.
 
+- name: Configure DHCP server dependence on interface.
+  become: yes
+  copy:
+    content: |
+      [<span class="org-type">Unit</span>]
+      <span class="org-variable-name">Requires</span>=network-online.target
+    dest: /etc/systemd/system/isc-dhcp-server.service.d/depend.conf
+  notify: Reload Systemd.
+
 - name: Configure DHCP for WiFiAP service.
   become: yes
   copy:
@@ -5874,12 +5887,17 @@ the daemon listens <i>only</i> on the Gate-WiFi network interface.
   systemd:
     service: isc-dhcp-server
     state: restarted
+
+- name: Reload Systemd.
+  become: yes
+  systemd:
+    daemon-reload: yes
 </pre>
 </div>
 </div>
 </div>
-<div id="outline-container-org013399e" class="outline-3">
-<h3 id="org013399e"><span class="section-number-3">9.6.</span> Install Server Certificate</h3>
+<div id="outline-container-orge4e2eb5" class="outline-3">
+<h3 id="orge4e2eb5"><span class="section-number-3">9.6.</span> Install Server Certificate</h3>
 <div class="outline-text-3" id="text-9-6">
 <p>
 The (OpenVPN) server on Gate uses an institute certificate (and key)
@@ -5906,8 +5924,8 @@ and Front) do.
 </div>
 </div>
 </div>
-<div id="outline-container-org9453d8e" class="outline-3">
-<h3 id="org9453d8e"><span class="section-number-3">9.7.</span> Configure OpenVPN</h3>
+<div id="outline-container-orgd47bbbe" class="outline-3">
+<h3 id="orgd47bbbe"><span class="section-number-3">9.7.</span> Configure OpenVPN</h3>
 <div class="outline-text-3" id="text-9-7">
 <p>
 Gate uses OpenVPN to provide the institute's campus VPN service.  Its
@@ -6034,8 +6052,8 @@ Wireless campus devices can get a key to the campus VPN from the
 configured manually.
 </p>
 </div>
-<div id="outline-container-org72203b0" class="outline-3">
-<h3 id="org72203b0"><span class="section-number-3">10.1.</span> Include Particulars</h3>
+<div id="outline-container-org757a1ed" class="outline-3">
+<h3 id="org757a1ed"><span class="section-number-3">10.1.</span> Include Particulars</h3>
 <div class="outline-text-3" id="text-10-1">
 <p>
 The following should be familiar boilerplate by now.
@@ -6051,8 +6069,8 @@ The following should be familiar boilerplate by now.
 </div>
 </div>
 </div>
-<div id="outline-container-orge42346a" class="outline-3">
-<h3 id="orge42346a"><span class="section-number-3">10.2.</span> Configure Hostname</h3>
+<div id="outline-container-orgc2c0904" class="outline-3">
+<h3 id="orgc2c0904"><span class="section-number-3">10.2.</span> Configure Hostname</h3>
 <div class="outline-text-3" id="text-10-2">
 <p>
 Clients should be using the expected host name.
@@ -6079,8 +6097,8 @@ Clients should be using the expected host name.
 </div>
 </div>
 </div>
-<div id="outline-container-orgba5d3f1" class="outline-3">
-<h3 id="orgba5d3f1"><span class="section-number-3">10.3.</span> Configure Systemd Resolved</h3>
+<div id="outline-container-org8550267" class="outline-3">
+<h3 id="org8550267"><span class="section-number-3">10.3.</span> Configure Systemd Resolved</h3>
 <div class="outline-text-3" id="text-10-3">
 <p>
 Campus machines use the campus name server on Core (or <code>dns.google</code>),
@@ -6109,7 +6127,8 @@ and include the institute's private domain in their search lists.
 <a href="roles_t/campus/handlers/main.yml"><q>roles_t/campus/handlers/main.yml</q></a><pre class="src src-conf">---
 - name: Reload Systemd.
   become: yes
-  command: systemctl daemon-reload
+  systemd:
+    daemon-reload: yes
 
 - name: Restart Systemd resolved.
   become: yes
@@ -6151,8 +6170,8 @@ and file timestamps.
 </div>
 </div>
 </div>
-<div id="outline-container-org3e078d4" class="outline-3">
-<h3 id="org3e078d4"><span class="section-number-3">10.5.</span> Add Administrator to System Groups</h3>
+<div id="outline-container-org6f719ec" class="outline-3">
+<h3 id="org6f719ec"><span class="section-number-3">10.5.</span> Add Administrator to System Groups</h3>
 <div class="outline-text-3" id="text-10-5">
 <p>
 The administrator often needs to read (directories of) log files owned
@@ -6172,8 +6191,8 @@ these groups speeds up debugging.
 </div>
 </div>
 </div>
-<div id="outline-container-orgae71e41" class="outline-3">
-<h3 id="orgae71e41"><span class="section-number-3">10.6.</span> Install Unattended Upgrades</h3>
+<div id="outline-container-org915c5c3" class="outline-3">
+<h3 id="org915c5c3"><span class="section-number-3">10.6.</span> Install Unattended Upgrades</h3>
 <div class="outline-text-3" id="text-10-6">
 <p>
 The institute prefers to install security updates as soon as possible.
@@ -7588,7 +7607,7 @@ A <code>debian</code> host runs a Debian desktop with Network Manager.  Again
 two files are generated, for the campus and public VPNs.</li>
 
 <li><code>./inst client campus NEW</code> <br />
-A <code>campus</code> host is an Debian host (with or without desktop) that is
+A <code>campus</code> host is a Debian host (with or without desktop) that is
 used by the institute generally, is <i>not</i> the property of a member,
 never roams off campus, and so is remotely administered with
 Ansible.  One file is generated, <q>campus.ovpn</q>.</li>
@@ -9108,7 +9127,7 @@ routes on Front and Gate, making the simulation less&#x2026; similar.
 </div></div>
 <div id="postamble" class="status">
 <p class="author">Author: Matt Birkholz</p>
-<p class="date">Created: 2024-05-08 Wed 14:42</p>
+<p class="date">Created: 2024-09-03 Tue 08:43</p>
 <p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
 </div>
 </body>
Small Institute Networking