Merge branch 'master' into claim

roles/network/tasks/squid.yml

@@ -34,7 +34,7 @@
 # Squid auto-creation of cache_dir (or the old way, 'squid -z') both fail:
 # "FATAL: Failed to make swap directory /library/cache: (13) Permission denied"
 #
-# SEE ALSO: https://github.com/iiab/iiab/blob/master/roles/network/templates/squid/squid.conf.j2#L10-L30
+# SEE ALSO: https://github.com/iiab/iiab/blob/master/roles/network/templates/squid/squid.conf.j2#L12-L32
 
 - name: Create Squid directory /library/cache ({{ proxy_user }}:{{ proxy_user }}, 0750)
   file:

roles/network/templates/squid/squid.conf.j2

@@ -1,3 +1,5 @@
+# This is /etc/squid/squid.conf <- roles/network/templates/squid/squid.conf.j2
+
 # 2021-08-16 IIAB PR #2948 - April 2007 OLPC School Server legacy moved to:
 # https://github.com/iiab/iiab/blob/master/roles/network/templates/squid/squid-iiab.conf.j2.unused
 

roles/remoteit/README.md

@@ -100,6 +100,7 @@ Prerequisite: Find any IIAB with `remoteit_installed: True` in `/etc/iiab/iiab_s
 
 - https://docs.remote.it
   - https://docs.remote.it/developer-tools/cli-usage
+  - https://docs.remote.it/oem-and-bulk-provisioning/registration-into-a-users-account
 - https://support.remote.it
   - https://support.remote.it/hc/en-us/categories/360003417511-Getting-Started
   - https://support.remote.it/hc/en-us/articles/360061228252-Oops-I-cloned-an-SD-card-

roles/remoteit/tasks/enable-or-disable.yml

@@ -28,7 +28,7 @@
     - schannel
   when: not remoteit_enabled
 
-- name: Stop & Disable any remoteit@* services found in /etc/systemd/system/multi-user.target.wants/ e.g. remoteit@80:00:01:7F:7E:00:56:36.service
+- name: Stop & Disable "Remote tcp connection services" remoteit@* found in /etc/systemd/system/multi-user.target.wants/ e.g. remoteit@80:00:01:7F:7E:00:56:36.service
   shell: |
     systemctl stop $(ls /etc/systemd/system/multi-user.target.wants/ | grep remoteit@*)
     systemctl disable $(ls /etc/systemd/system/multi-user.target.wants/ | grep remoteit@*)

roles/remoteit/tasks/install.yml

@@ -36,17 +36,16 @@
   shell: mkdir /etc/remoteit || true && touch /etc/remoteit/registration
   when: remoteit_REGISTRATION_CODE is not none
 
-- name: Install remote.it Device Package for your CPU/OS, using https://downloads.remote.it/remoteit/install_agent.sh
+- name: Install remote.it Device Package for your CPU/OS, using https://downloads.remote.it/remoteit/install_agent.sh -- this puts a claim code in /etc/remoteit/config.json which is valid for 24h
   shell: curl -L https://downloads.remote.it/remoteit/install_agent.sh | sh
 
-
-- name: "Install /usr/bin/iiab-remoteit from template -- so IIAB operators can quickly enable remote.it AND generate a new remote.it claim code (in /etc/remoteit/config.json) -- optionally downloading + installing the very latest Device Package (like the 2 steps above)"
+- name: Install /usr/bin/iiab-remoteit from template -- so IIAB operators can quickly enable remote.it AND generate a new remote.it claim code (in /etc/remoteit/config.json) -- optionally downloading + installing the very latest Device Package (like the 2 steps above)
   template:
     src: iiab-remoteit
     dest: /usr/bin
     mode: 0755
 
-- name: "Install /usr/bin/iiab-remoteit-off from template -- so IIAB operators can quickly turn off AND disable remote.it services on this IIAB"
+- name: Install /usr/bin/iiab-remoteit-off from template -- so IIAB operators can quickly turn off AND disable remote.it services on this IIAB
   template:
     src: iiab-remoteit-off
     dest: /usr/bin

roles/remoteit/templates/iiab-remoteit

@@ -45,6 +45,9 @@ else
     mv /etc/remoteit/config.json /etc/remoteit/config.json.$(date +%F_%T_%Z) || true
 
     systemctl start connectd     # Claim Code logic + kickstarts 2 svcs below
+    # /usr/share/remoteit/refresh.sh does the same thing (or close) as per:
+    # https://docs.remote.it/oem-and-bulk-provisioning/registration-into-a-users-account
+
     systemctl enable connectd    # 2 enable lines, like enable-or-disable.yml
 
     # schannel = "Remote tcp command service" started by connectd above if nec