Merge pull request #142 from iiab/master

sync from iiab/iiab

roles/0-init/tasks/main.yml

@@ -116,11 +116,11 @@
     postgresql_enabled: True
   when: moodle_enabled or pathagar_enabled
 
-- name: Turn on vars for Docker if SchoolTool is to be installed
+#- name: Turn on vars for Docker if SchoolTool is to be installed
-  set_fact:
+#  set_fact:
-    docker_install: True
+#    docker_install: True
-    docker_enabled: True
+#    docker_enabled: True
-  when: schooltool_enabled or schooltool_install
+#  when: schooltool_enabled or schooltool_install
 
 - name: Set python_path (redhat)
   set_fact:

roles/6-generic-apps/tasks/main.yml

@@ -33,11 +33,11 @@
   when: nextcloud_install
   tags: nextcloud
 
-- name: OWNCLOUD
+#- name: OWNCLOUD
-  include_role:
+#  include_role:
-    name: owncloud
+#    name: owncloud
-  when: owncloud_install
+#  when: owncloud_install
-  tags: owncloud
+#  tags: owncloud
 
 - name: WORDPRESS
   include_role:

roles/7-edu-apps/tasks/main.yml

@@ -36,7 +36,7 @@
 - name: PATHAGAR
   include_role:
     name: pathagar
-  when: pathagar_install
+  when: pathagar_install is defined and pathagar_install
   tags: pathagar
 
 - name: SUGARIZER

roles/8-mgmt-tools/tasks/main.yml

@@ -3,12 +3,6 @@
 - name: ...IS BEGINNING ======================================
   command: echo
 
-- name: TRANSMISSION
-  include_role:
-    name: transmission
-  when: transmission_install
-  tags: transmission
-
 - name: AWSTATS
   include_role:
     name: awstats

roles/9-local-addons/tasks/main.yml

@@ -2,7 +2,7 @@
 
 - name: ...IS BEGINNING ====================================
   command: echo
-  
+
 - name: CALIBRE
   include_role:
     name: calibre
@@ -15,6 +15,12 @@
   when: calibreweb_install
   tags: calibre-web
 
+- name: TRANSMISSION
+  include_role:
+    name: transmission
+  when: transmission_install
+  tags: transmission
+
 - name: Recording STAGE 9 HAS COMPLETED ====================
   lineinfile:
     dest: /etc/iiab/iiab.env

roles/calibre-web/README.rst

@@ -3,14 +3,14 @@ Calibre-Web README
 ==================
 
 Calibre-Web provides a clean interface for browsing, reading and downloading
-e-books using an existing Calibre database.  Teachers can add upload e-books,
+e-books using an existing Calibre database.  Teachers can upload e-books,
-adjust e-book metadata, and create custom book collections ("bookshelves"):
+adjust e-book metadata, and create custom e-book collections ("bookshelves"):
 https://github.com/janeczku/calibre-web#about
 
-This Ansible role installs Calibre-Web as part of your Internet-in-a-Box, as a
+This Ansible role installs Calibre-Web as part of your Internet-in-a-Box (IIAB)
-possible alternative to Calibre (we'll call it 'calibre-web' from here down,
+as a possible alternative to Calibre (we'll call it 'calibre-web' from here
-noting that ``calibreweb_*`` variables do not include the dash, per Ansible
+down, noting that ``calibreweb_*`` variables do not include the dash, per
-recommendations).
+Ansible recommendations).
 
 Using It
 --------
@@ -24,7 +24,7 @@ whereas teachers add books using an administrative account, as follows::
   Password: changeme
 
 If the default configuration is not found, the calibre-web server creates a
-new settings file with calibre-web's own administrative account default::
+new settings file with calibre-web's own default administrative account::
 
   Username: admin
   Password: admin123
@@ -42,7 +42,7 @@ You can manage the backend calibre-web server with these systemd commands::
 Configuration
 -------------
 
-To configure calibre-web, login as user 'Admin' then click 'Admin' on top.
+To configure calibre-web, log in as user 'Admin' then click 'Admin' on top.
 Check 'Configuration' options near the bottom of the page.
 
 Critical settings are stored in::
@@ -57,8 +57,8 @@ See also::
 
   /library/calibre-web/metadata_db_prefs_backup.json
 
-Back Up Your Content
+Back Up Everything
---------------------
+------------------
 
 Please back up the entire folder ``/library/calibre-web`` before upgrading —
 as it contains your calibre-web content **and** settings!
@@ -66,17 +66,19 @@ as it contains your calibre-web content **and** settings!
 Upgrading
 ---------
 
-Reinstalling calibre-web automatically upgrades to the latest version.
+Reinstalling calibre-web automatically upgrades to the latest version if your
+Internet-in-a-Box (IIAB) is online.
 
-Back up your content **and** settings before reinstalling, as explained above.
+But first: back up your content **and** settings, as explained above.
 
-**Move your /library/calibre-web/metadata.db if you're sure you want to install
+**Then move your /library/calibre-web/metadata.db out of the way, if you're
-a bare/minimal metadata.db and force all settings to the default.  Then run**::
+sure you want to (re)install bare/minimal metadata, and force all calibre-web
+settings to the default.  Then run**::
 
   cd /opt/iiab/iiab
   ./runrole calibre-web
   
-Or, to reinstall all of Internet-in-a-Box::
+Or, to reinstall all of IIAB::
 
   cd /opt/iiab/iiab
   ./iiab-install --reinstall
@@ -92,11 +94,22 @@ Known Issues
 
 * Trying to access an empty public bookshelf causes a system error.
 
+* As of August 2018, it's sometimes impossible to set the language of an
+  e-book: `#1040 <https://github.com/iiab/iiab/issues/1040>`_, `janeczku/calibre-web#593 <https://github.com/janeczku/calibre-web/issues/593>`_
+
 * As of August 2018, calibre-web doesn't yet include Calibre's e-book
   conversion functionality (e.g. Calibre 3.27.1 [released 2018-07-06] allows
-  teachers to convert between PDF, epub, txt etc — to permit reading on a wider
+  teachers to convert between PDF, EPUB, HTML, TXT etc — to permit reading on a
-  array client devices and client software).
+  wider array client devices and client software).
+
+* http://192.168.0.x:8083 does not work, as a result of `iptables <https://github.com/iiab/iiab/blob/master/roles/network/templates/gateway/iiab-gen-iptables#L93>`_,
+  even when ``services_externally_visible: true``.  This is fixable, but perhaps
+  it's not a priority, as URL's like {http://192.168.0.x/books,
+  http://10.8.0.x/books, http://127.0.0.1/books and http://box/books} all work.
 
 * calibre-web does not currently use version numbers, so glitches might
-  occasionally arise using its master branch.  Please assist us in reporting
+  occasionally arise, when upstream developers change its master branch without
-  issues here, if they do arise: https://github.com/janeczku/calibre-web/issues
+  warning.
+  
+* *Please assist us in reporting serious issues here:*
+  https://github.com/janeczku/calibre-web/issues

roles/calibre-web/tasks/main.yml

@@ -86,7 +86,8 @@
     state: restarted
   when: calibreweb_enabled
 
-- name: Enable http://box/calibre-web with Apache
+# Default: http://box/books
+- name: Enable http://box{{ calibreweb_url }} with Apache
   command: a2ensite calibre-web.conf
   when: calibreweb_enabled
 

roles/calibre/defaults/main.yml

@@ -19,6 +19,12 @@ calibre_sample_book: "Metamorphosis-jackson.epub"
 
 calibre_src_url: "https://raw.githubusercontent.com/kovidgoyal/calibre/master/setup/linux-installer.py"
 
+calibre_deb_url: http://download.iiab.io/packages
+# Must contain both packages for the pinned version, formatted as follows:
+# calibre_3.30.0+dfsg-1_all (25M, 2018-08-24)
+# calibre-bin_3.30.0+dfsg-1_armhf (742K, 2018-08-30)
+calibre_deb_pin_version: 3.30.0
+
 # USE TO TEST debs.yml (RASPBIAN APPROACH!) ON DEBIAN 9.X: (now handled by calibre_via_debs in /opt/iiab/iiab/vars/*)
 #calibre_debs_on_debian: True
 # Enable unstable .deb's, not just testing .deb's: (moved to /etc/iiab/local_vars.yml & /opt/iiab/iiab/vars/default_vars.yml)

roles/calibre/tasks/debs.yml

@@ -27,16 +27,33 @@
 #  command: scripts/calibre-install-latest.sh       # NECESSARY since Calibre 3.24 (BEWARE installing libc6 will prevent boot in RPi Zero W, i.e. if calibre-install-packages.sh isn't run above!)
 #  when: is_rpi and internet_available
 
-- name: Upgrade to latest Calibre using .deb's from testing (rpi)
+#- name: Upgrade to latest Calibre using .deb's from testing (rpi)
-  #command: scripts/calibre-install-latest-rpi-plus.sh    # WORKS for Calibre 3.27.1 on 2018-07-22 (#948 -> PR #950) THO NOT BOOTABLE IN Zero W (#952).  Similar to Calibre 3.24.x & 3.25 in June 2018, which had used calibre-install-packages.sh then Debian's own calibre-install-latest.sh
+#  #command: scripts/calibre-install-latest-rpi-plus.sh    # WORKS for Calibre 3.27.1 on 2018-07-22 (#948 -> PR #950) THO NOT BOOTABLE IN Zero W (#952).  Similar to Calibre 3.24.x & 3.25 in June 2018, which had used calibre-install-packages.sh then Debian's own calibre-install-latest.sh
-  #command: scripts/calibre-install-latest-rpi.sh    # WORKS for Calibre 3.28 on 2018-07-26 (PR #971).  Likewise for Calibre 3.26.x
+#  #command: scripts/calibre-install-latest-rpi.sh    # WORKS for Calibre 3.28 on 2018-07-26 (PR #971).  Likewise for Calibre 3.26.x
-  command: scripts/calibre-install-latest.sh    # REQUIRED for Calibre 3.29 on 2018-08-21 (PR #1015), as all above strategies failed (only script that was not attempted: Sid-like calibre-install-unstable.sh).  CLARIF: RESULTING microSD's ARE NOT BOOTABLE IN Zero W (#952)
+#  command: scripts/calibre-install-latest.sh    # REQUIRED for Calibre 3.29 on 2018-08-21 (PR #1015), as all above strategies failed (only script that was not attempted: Sid-like calibre-install-unstable.sh).  CLARIF: RESULTING microSD's ARE NOT BOOTABLE IN Zero W (#952)
+#  when: is_rpi and internet_available
+
+- name: Download PINNED version {{ calibre_deb_pin_version }} of calibre & calibre-bin (rpi)
+  get_url:
+    url: "{{ calibre_deb_url }}/{{ item }}"
+    dest: "{{ downloads_dir }}/{{ item }}"
+    mode: 0644
+    #force: no
+    #backup: no
+    timeout: "{{ download_timeout }}"
+  with_items:
+    - calibre_{{ calibre_deb_pin_version }}+dfsg-1_all.deb
+    - calibre-bin_{{ calibre_deb_pin_version }}+dfsg-1_armhf.deb
   when: is_rpi and internet_available
 
-- name: Upgrade to Calibre testing .deb's - target Ubuntu 16.04 (not rpi and not ubuntu_18)
+- name: Install/Upgrade both, to PINNED version {{ calibre_deb_pin_version }} while using additional .deb's from testing (rpi)
+  command: scripts/calibre-install-pinned-rpi.sh    # RECOMMENDED for Calibre 3.30 on 2018-08-30, so IIAB microSD will be bootable in RPi Zero W
+  when: is_rpi and internet_available
+
+- name: Install/Upgrade to Calibre testing .deb's - target Ubuntu 16.04 (not rpi and not ubuntu_18)
   command: scripts/calibre-install-latest.sh
   when: not is_rpi and not is_ubuntu_18 and internet_available
 
-- name: Upgrade to Calibre unstable .deb's IF calibre_unstable_debs
+- name: Install/Upgrade to Calibre unstable .deb's IF calibre_unstable_debs
   command: scripts/calibre-install-unstable.sh
   when: calibre_unstable_debs and internet_available

roles/calibre/tasks/main.yml

@@ -12,9 +12,9 @@
   with_items:
     - calibre
     - calibre-bin
-  when: internet_available and (not calib_executable.stat.exists)
+  when: internet_available and not is_rpi and (not calib_executable.stat.exists)
 
-- name: Install Calibre experimental .debs IF calibre_via_debs (AND /usr/bin/calibre WAS MISSING)
+- name: Install Calibre .debs IF calibre_via_debs (AND /usr/bin/calibre WAS MISSING)
   include_tasks: debs.yml
   when: calibre_via_debs and (not calib_executable.stat.exists)
 

roles/kalite/README.rst

@@ -2,48 +2,50 @@
 KA Lite README
 ==============
 
-This role installs KA Lite, an offline version of the Khan Academy (https://www.khanacademy.org/),
+This role installs KA Lite, an offline version of Khan Academy (https://www.khanacademy.org) created by Learning Equality
-written by Learning Equality (https://learningequality.org/ka-lite/).
+(https://learningequality.org/ka-lite/).
 
-KA Lite has two servers, a light httpd server that serves Khan Academy videos, and a cron server
+KA Lite downloads Khan Academy videos to your Internet-in-a-Box for offline use, with exercises and accounts if students want to track their own progress.
-that sets up cron jobs to download language packs and KA videos from the internet.  There are
-separate flags to enable these two servers.
 
-Access
+[Originally KA Lite had two servers, a light httpd server that serves Khan Academy videos, and a cron server that sets up cron jobs to download language packs and KA videos from the internet.  There were separate flags to enable these two servers.]
-------
 
-If enabled and with the default settings KA Lite should be accessible at http://schoolserver:8008/
+Using It
+--------
 
-To login to kalite enter
+If enabled with the default settings, KA Lite should be accessible at http://box:8008 or http://box.lan:8008
 
-User Name: Admin
+After your Internet-in-a-Box (IIAB) is completely installed, log in to KA Lite to explore and configure::
-Password: changme
 
-Bulk Loading Videos
+  Username: Admin
--------------------
+  Password: changeme
 
-Videos and their corresponding png images can be copied into /library/ka-lite/content and will
+Bulk Downloading Videos
-be recognized the next time kalite is started.  The kalite website has instructions on getting
+-----------------------
-videos with bitsync.  These videos are also smaller than the ones downloaded with the kalite
+
-admin interface.
+Videos and their corresponding PNG thumbnail images can be copied into /library/ka-lite/content and will be recognized the next time KA Lite is started.
+
+Please see http://FAQ.IIAB.IO ("KA Lite Administration: What tips & tricks exist?") to use BitTorrent to download compressed KA Lite videos, that are much smaller than the ones downloaded via KA Lite's administrative interface.
+
+As of August 2018, please also consider the `"Transmission" BitTorrent tool <https://github.com/iiab/iiab/tree/master/roles/transmission#transmission-readme>`_ that will automatically download thousands of KA Lite videos to your Internet-in-a-Box (IIAB) — if you install and enable "transmission" within /etc/iiab/local_vars.yml — carefully choosing the language(s) you want as downloading these videos can take many hours if not days!
 
 Configuration Parameters
 ------------------------
 
-Please look in defaults/main.yml for the default values of the various install parameters.  Everything
+Look at `role/kalite/defaults/main.yml <https://github.com/iiab/iiab/blob/master/roles/kalite/defaults/main.yml>`_ for the default values of the various install parameters.
-in this readme assumes the default values.
 
-Trouble Shooting
+Troubleshooting
-----------------
+---------------
 
-Starting with kalite 0.15 you can run the server manually with the following commands:
+Starting with KA Lite 0.15 (October 2015) you can run the server manually with the following commands:
 
 * systemctl stop kalite-serve (make sure the systemd service is not running)
 * export KALITE_HOME=/library/ka-lite (point kalite to the right environment)
-* kalite start (start the server; can take more than 10 minutes in some environment)
+* kalite start (start the server; can take more than 10 minutes in some environments)
 
 To return to using the systemd unit:
 
 * export KALITE_HOME=/library/ka-lite (point kalite to the right environment)
 * kalite stop
 * systemctl start kalite-serve
+
+*In late 2017, Internet-in-a-Box added a virtual environment (/usr/local/kalite/venv/) to keep KA Lite's Python package/dependency risks under control.  As such the command* `/usr/bin/kalite <https://github.com/iiab/iiab/blob/master/roles/kalite/templates/kalite.sh.j2>`_ *is a wrapper to this virtualenv.*

roles/kalite/tasks/main.yml

@@ -2,12 +2,12 @@
 
 # Assume all XOs are F18 and nothing else is
 
-- name: Calc KA Lite db file name (Fedora 18)
+- name: Set KA Lite's SQLite filename (Fedora 18)
   set_fact:
     kalite_db_name: "{{ kalite_root }}/kalite/database/data.sqlite"
   when: is_F18
 
-- name: Calc KA Lite db file name (OS's other than Fedora 18)
+- name: Set KA Lite's SQLite filename (OS's other than Fedora 18)
   set_fact:
     kalite_db_name: "{{ kalite_root }}/database/data.sqlite"
   when: not is_F18
@@ -46,7 +46,7 @@
   - option: name
     value: "KA Lite"
   - option: description
-    value: '"KA Lite is a server to present Khan Academy videos offline and to download them."'
+    value: '"KA Lite downloads Khan Academy videos for offline use, with exercises and accounts if students want to track their own progress."'
   - option: path
     value: "{{ kalite_root }}"
   - option: port

roles/kiwix/defaults/main.yml

@@ -1,9 +1,9 @@
 # Which kiwix-tools to download from http://download.iiab.io/packages/
 # As obtained from http://download.kiwix.org/release/kiwix-tools/ or http://download.kiwix.org/nightly/
 
-kiwix_version_armhf: "kiwix-tools_linux-armhf-0.6.0"
+kiwix_version_armhf: "kiwix-tools_linux-armhf-0.6.1"
-kiwix_version_linux64: "kiwix-tools_linux-x86_64-0.6.0"
+kiwix_version_linux64: "kiwix-tools_linux-x86_64-0.6.1"
-kiwix_version_i686: "kiwix-tools_linux-i586-0.6.0"
+kiwix_version_i686: "kiwix-tools_linux-i586-0.6.1"
 # kiwix_src_file_i686: "kiwix-linux-i686.tar.bz2"
 # v0.9 for i686 published May 2014 ("use it to test legacy ZIM content")
 # v0.10 for i686 published Oct 2016 ("experimental") REPLACED IN EARLY 2018, thx to Matthieu Gautier:

roles/kiwix/templates/kiwix.conf.j2

@@ -1,4 +1,11 @@
-RewriteEngine on
+# 2018-08-31: FAILS to enable http://box/kiwix
-RewriteRule ^{{ kiwix_alias_url }}$ {{ kiwix_url }} [R]
+#RewriteEngine on
+#RewriteRule ^{{ kiwix_alias_url }}$ {{ kiwix_url }} [R]
 
+# 2018-08-31: SUCCEEDS in enabling http://box/kiwix
+RedirectMatch ^{{ kiwix_alias_url }}$ {{ kiwix_url }}
+
+# 2018-08-31: SUCCEEDS in enabling http://box/kiwix/ & http://box/kiwix/zim & http://box/kiwix/zim/
+#ProxyPreserveHost On
 ProxyPass {{ kiwix_url }} http://127.0.0.1:{{ kiwix_port}}{{ kiwix_url }}
+#ProxyPassReverse {{ kiwix_url }} http://127.0.0.1:{{ kiwix_port}}{{ kiwix_url }}

roles/osm/tasks/main.yml

@@ -87,12 +87,14 @@
 
 - name: Set osm_path (redhat)
   set_fact:
-    osm_path: "{{ osm_venv }}/{{ python_path }}/iiab"
+    #osm_path: "{{ osm_venv }}/{{ python_path }}/iiab"
+    osm_path: "{{ osm_venv }}{{ python_path }}/iiab"
   when: osm_enabled and is_redhat
 
 - name: Set osm_path (debuntu)
   set_fact:
-    osm_path: "{{ osm_venv }}/lib/python2.7/site-packages/iiab"
+    #osm_path: "{{ osm_venv }}/lib/python2.7/site-packages/iiab"
+    osm_path: "{{ osm_venv }}lib/python2.7/site-packages/iiab"
   when: osm_enabled and is_debuntu
 
 - name: Point wsgi to virtual environment (all OS's)

roles/osm/templates/osm.conf.j2

@@ -5,9 +5,12 @@ XSendFilePath /
 
 WSGIScriptAlias /iiab {{ doc_root }}/osm.wsgi
 
+# For old bitmap/raster tileset
 Alias /iiabstatic {{ osm_path }}/static
-Alias /osm {{ osm_path }}/static
+
-Alias /maps {{ osm_path }}/static
+# For new vector tileset, as documented @ http://FAQ.IIAB.IO ("How do I add zoomable maps for my region? ") & http://download.iiab.io/content/OSM/vector-tiles/
+Alias /maps /library/www/html/modules/en-osm-omt-min/
+Alias /osm /library/www/html/modules/en-osm-omt-min/
 
 <Directory {{ osm_path }}/static>
 	require all granted

roles/transmission/README.rst

@@ -17,7 +17,7 @@ Caveat emptor!  (That's Latin for "Buyer Beware")
 Using It
 --------
 
-Install Transmission by setting 'transmission_install' and 'transmission_enabled' to True in /etc/iiab/local_vars.yml and then running::
+Install Transmission by setting 'transmission_install' and 'transmission_enabled' to True in `/etc/iiab/local_vars.yml <http://wiki.iiab.io/local_vars.yml>`_ — carefully choosing language(s) for KA Lite videos you want to download — and then run::
 
   cd /opt/iiab/iiab
   ./runrole transmission
@@ -59,7 +59,7 @@ Adding Torrents
 
 Transmission can facilitate provisioning content onto your IIAB, e.g. by adding thousands of KA Lite videos from places like: http://pantry.learningequality.org/downloads/ka-lite/0.17/content/
 
-Please read the lettered instructions (A, B, C, D) in /etc/iiab/local_vars.yml and 'KA Lite Administration: What tips & tricks exist?' at http://FAQ.IIAB.IO outlining how to use Transmission to download and then install KA Lite content.
+Please read the lettered instructions (A, B, C, D) in `/etc/iiab/local_vars.yml <http://wiki.iiab.io/local_vars.yml>`_ and 'KA Lite Administration: What tips & tricks exist?' at http://FAQ.IIAB.IO outlining how to use Transmission to download and then install KA Lite content.
 
 You can also download other torrents using Transmission's web interface, or by typing 'transmission-remote' at the command-line::
 
@@ -68,7 +68,7 @@ You can also download other torrents using Transmission's web interface, or by t
 Known Issues
 ------------
 
-* Default Transmission user/group may need fixing (https://github.com/transmission/transmission/issues/537).  You can set Ansible variables 'transmission_user' and 'transmission_group' e.g. in /opt/iiab/iiab/roles/transmission/defaults/main.yml (you might need 'User=' and 'Group=' in systemd unit file /lib/systemd/system/transmission-daemon.service — both might need to be set to 'debian-transmission' — if so 'systemctl daemon-reload' then 'systemctl restart transmission-daemon').
+* Default Transmission user/group may need fixing (https://github.com/transmission/transmission/issues/537) in some circumstances.  You can set Ansible variables 'transmission_user' and 'transmission_group' e.g. in /opt/iiab/iiab/roles/transmission/defaults/main.yml (you might need 'User=' and 'Group=' in systemd unit file /lib/systemd/system/transmission-daemon.service — e.g. both might need to be set to 'debian-transmission' — if so then run 'systemctl daemon-reload' and 'systemctl restart transmission-daemon').
 
 * Random Ports: Currently it is not possible to use random ports in the range 49152-65535.  It is difficult to open multiple ports in IIAB's iptables-based firewall.
 

scripts/calibre-install-pinned-rpi.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+# Thanks to Jerry Vonau (https://github.com/jvonau) who made this critical
+# breakthrough possible!
+#
+# Might break future updates; you have been warned.
+# SEE NOTES AT TOP OF scripts/calibre-install-packages.sh
+
+export DEBIAN_FRONTEND=noninteractive
+# Prepares to update to latest from raspbian testing
+echo "deb http://raspbian.raspberrypi.org/raspbian/ testing main" > /etc/apt/sources.list.d/rpi-testing.list
+apt update
+# @jvonau explains that stale .deb's should be avoided as: "apt will pick the highest version to install after churning a bit..."
+apt -y install /opt/iiab/downloads/calibre*.deb
+#sed -i '$ d' /etc/apt/sources.list.d/rpi-testing.list    # Removes last line
+rm /etc/apt/sources.list.d/rpi-testing.list
+# Clears the cache of rpi/testing
+apt update

vars/default_vars.yml

@@ -153,16 +153,9 @@ wan_nameserver:
 # Our past convention was to install everything in all aggregates
 # And to enable everything in 1-PREP, 2-COMMON, and 3-BASE-SERVER
 
+
 # 1-PREP
 
-# Docker (lesser-supported)
-docker_install: False
-docker_enabled: False
-
-# SchoolTool - unmaintained
-schooltool_install: False
-schooltool_enabled: False
-
 # 2-COMMON
 
 # 3-BASE-SERVER
@@ -180,6 +173,7 @@ mysql_enabled: True
 # mysql_root_password: $6$iiab51$3ICIW0CLWxxMW2a3yrHZ38ukZItD5tcadL4rWcE9D.qIGStxhh8rRsaSxoj3b.MYxI/VRDNjpzSYK/V6zkWFI0
 mysql_root_password: fixmysql
 
+
 # 4-SERVER-OPTIONS
 
 # sshd
@@ -237,6 +231,7 @@ iiab_usb_lib_show_all: False
 # Toggle iiab-refresh-wiki-docs scraping for offline docs (http://box/info)
 nodocs: False
 
+
 # 5-XO-SERVICES
 
 # Lesser-supported XO services need additional testing.  Please contact
@@ -257,32 +252,9 @@ ejabberd_xs_enabled: False
 idmgr_install: False
 idmgr_enables: False
 
+
 # 6-GENERIC-APPS
 
-# Calibre E-Book Library
-# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
-# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
-
-calibre_install: True
-calibre_enabled: True
-# vars/raspbian-9.yml tries the .deb upgrade of Calibre, overriding this default:
-calibre_via_debs: False
-calibre_unstable_debs: False
-# vars/<most-OS's>.yml use Calibre's python installer/upgrader (x86_64), overriding this default:
-calibre_via_python: False
-# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
-calibre_port: 8080
-# Change calibre to XYZ add your own mnemonic URL like: http://box/XYZ
-calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
-
-# Calibre-Web alternative to Calibre, offers a clean/modern UX
-calibreweb_install: True
-calibreweb_enabled: True
-calibreweb_port: 8083
-# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
-calibreweb_url: /books
-calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
-
 # DokuWiki
 dokuwiki_install: False
 dokuwiki_enabled: False
@@ -305,14 +277,11 @@ ejabberd_enabled: False
 nextcloud_install: True
 nextcloud_enabled: False
 
-# ownCloud
-owncloud_install: False
-owncloud_enabled: False
-
 # WordPress
 wordpress_install: True
 wordpress_enabled: False
 
+
 # 7-EDU-APPS
 
 # KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS
@@ -348,10 +317,6 @@ osm_enabled: False
 # iiab_install: True
 # iiab_enabled: False
 
-# Pathagar - similar to Calibre, but unmaintained
-pathagar_install: False
-pathagar_enabled: False
-
 # Sugarizer
 # Might stall MongoDB on Power Failure: github.com/xsce/xsce/issues/879
 # Sugarizer 1.0.1+ strategies to solve? github.com/iiab/iiab/pull/957
@@ -359,8 +324,62 @@ sugarizer_install: True
 sugarizer_enabled: False
 sugarizer_port: 8089
 
+
 # 8-MGMT-TOOLS
 
+# AWStats - summarizes http access logs
+awstats_install: True
+awstats_enabled: False
+
+# Monit
+monit_install: False
+monit_enabled: False
+watchdog:
+  - sshd
+  - idmgr
+  - ejabberd
+  - httpd
+  - postgresql
+  - squid
+
+# Munin
+munin_install: True
+munin_enabled: False
+
+# Handy for maintaining tables, but DANGEROUS if not locked down
+phpmyadmin_install: False
+phpmyadmin_enabled: False
+
+# vnStat
+vnstat_install: True
+vnstat_enabled: False
+
+
+# 9-LOCAL-ADDONS
+
+# Calibre E-Book Library
+# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
+# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
+calibre_install: True
+calibre_enabled: True
+# vars/raspbian-9.yml tries the .deb upgrade of Calibre, overriding this default:
+calibre_via_debs: False
+calibre_unstable_debs: False
+# vars/<most-OS's>.yml use Calibre's python installer/upgrader (x86_64), overriding this default:
+calibre_via_python: False
+# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
+calibre_port: 8080
+# Change calibre to XYZ add your own mnemonic URL like: http://box/XYZ
+calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
+
+# Calibre-Web alternative to Calibre, offers a clean/modern UX
+calibreweb_install: True
+calibreweb_enabled: True
+calibreweb_port: 8083
+# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
+calibreweb_url: /books
+calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
+
 # Transmission is a BitTorrent downloader for large Content Packs etc
 transmission_install: False
 transmission_enabled: False
@@ -400,39 +419,27 @@ transmission_kalite_languages:
 transmission_username: Admin
 transmission_password: changeme
 
-# AWStats - summarizes http access logs
-awstats_install: True
-awstats_enabled: False
 
-# Monit
+# TeamViewer - unmaintained (better to install from http://teamviewer.com or prep scripts at http://download.iiab.io)
-monit_install: False
-monit_enabled: False
-watchdog:
-  - sshd
-  - idmgr
-  - ejabberd
-  - httpd
-  - postgresql
-  - squid
-
-# Munin
-munin_install: True
-munin_enabled: False
-
-# Handy for maintaining tables, but DANGEROUS if not locked down
-phpmyadmin_install: False
-phpmyadmin_enabled: False
-
-# vnStat
-vnstat_install: True
-vnstat_enabled: False
-
-# ================================================================
-
-# Unmaintained (better to install from http://teamviewer.com or prep scripts at http://download.iiab.io)
 # teamviewer_install: False
 # teamviewer_enabled: False
 
+# Docker - unmaintained
+# docker_install: False
+# docker_enabled: False
+
+# SchoolTool - unmaintained
+# schooltool_install: False
+# schooltool_enabled: False
+
+# Debian SchoolTool - nnmaintained
+# debian_schooltool_install: False
+# debian_schooltool_enabled: False
+
+# Pathagar - unmaintained (consider Calibre or Calibre-Web above?)
+# pathagar_install: False
+# pathagar_enabled: False
+
 # sugar-stats - unmaintained
 # sugar_stats_install: False
 # sugar_stats_enabled: False
@@ -450,6 +457,10 @@ vnstat_enabled: False
 # xovis_backup_dir: "/library/users"
 # xovis_chart_heading: "My School: Usage Data Visualization"
 
+# ownCloud - unmaintained
+# owncloud_install: False
+# owncloud_enabled: False
+
 # Ajenti - unmaintained
 # ajenti_install: False
 # ajenti_enabled: False
@@ -479,3 +490,9 @@ is_rpi: False
 is_redhat: False
 is_fedora: False
 is_centos: False
+
+# How This Works:
+# 1. /opt/iiab/iiab/iiab-install copies scripts/local_facts.fact to /etc/ansible/facts.d/local_facts.fact
+# 2. Ansible runs /etc/ansible/facts.d/local_facts.fact to identify the OS
+# 3. ./iiab-install (iiab-stages.yml) or ./runrole (run-one-role.yml) or Admin Console (iiab-from-console.yml) invoke the correct /opt/iiab/iiab/vars/<OS>.yml
+# Longer Explanation: https://github.com/iiab/iiab/wiki/IIAB-Variables (Order of Execution and Precedence)

vars/local_vars_big.yml

@@ -69,6 +69,7 @@ dansguardian_enabled: True
 # wondershaper_install: False
 # wondershaper_enabled: False
 
+
 # 1-PREP
 
 # 2-COMMON
@@ -80,6 +81,7 @@ allow_apache_sudo: True
 
 # roles/mysql runs here (mandatory)
 
+
 # 4-SERVER-OPTIONS
 
 # SECURITY WARNING: See http://wiki.laptop.org/go/IIAB/Security
@@ -113,6 +115,7 @@ samba_enabled: False
 # Show entire contents of USB sticks/drives (at http://box/usb)
 iiab_usb_lib_show_all: True
 
+
 # 5-XO-SERVICES
 
 # Lesser-supported XO services need additional testing.  Please contact
@@ -131,33 +134,9 @@ iiab_usb_lib_show_all: True
 # ejabberd_xs_install: False
 # ejabberd_xs_enabled: False
 
+
 # 6-GENERIC-APPS
 
-# Calibre E-Book Library
-# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
-# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
-
-calibre_install: True
-calibre_enabled: True
-# Try .deb upgrade of Calibre (like vars/raspbian-9.yml already does)
-# calibre_via_debs: True
-calibre_unstable_debs: False
-# Try python x86_64 upgrade of Calibre (like vars/<most-OS's>.yml already do)
-# calibre_via_python: True
-# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
-calibre_port: 8080
-# Change calibre to XYZ to add your own mnemonic URL like: http://box/XYZ
-calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
-# In addition to: http://box/books box/libros box/livres box/livros box/liv
-
-# Calibre-Web alternative to Calibre, offers a clean/modern UX
-calibreweb_install: True
-calibreweb_enabled: True
-calibreweb_port: 8083
-# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
-calibreweb_url: /books
-calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
-
 dokuwiki_install: True
 dokuwiki_enabled: True
 
@@ -176,6 +155,7 @@ nextcloud_enabled: True
 wordpress_install: True
 wordpress_enabled: True
 
+
 # 7-EDU-APPS
 
 # KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS
@@ -198,21 +178,60 @@ moodle_enabled: True
 osm_install: True
 osm_enabled: True
 
-# Similar to Calibre, but unmaintained
-pathagar_install: False
-pathagar_enabled: False
-
 # Might stall MongoDB on Power Failure: github.com/xsce/xsce/issues/879
 # Sugarizer 1.0.1+ strategies to solve? github.com/iiab/iiab/pull/957
 sugarizer_install: True
 sugarizer_enabled: True
 
+
 # 8-MGMT-TOOLS
 
+awstats_install: True
+awstats_enabled: True
+
+monit_install: True
+monit_enabled: True
+
+munin_install: True
+munin_enabled: True
+
+# Handy for maintaining tables, but DANGEROUS if not locked down
+phpmyadmin_install: True
+phpmyadmin_enabled: False
+
+vnstat_install: True
+vnstat_enabled: True
+
+
+# 9-LOCAL-ADDONS
+
+# Calibre E-Book Library
+# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
+# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
+calibre_install: True
+calibre_enabled: True
+# Try .deb upgrade of Calibre (like vars/raspbian-9.yml already does)
+# calibre_via_debs: True
+calibre_unstable_debs: False
+# Try python x86_64 upgrade of Calibre (like vars/<most-OS's>.yml already do)
+# calibre_via_python: True
+# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
+calibre_port: 8080
+# Change calibre to XYZ to add your own mnemonic URL like: http://box/XYZ
+calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
+# In addition to: http://box/books box/libros box/livres box/livros box/liv
+
+# Calibre-Web alternative to Calibre, offers a clean/modern UX
+calibreweb_install: True
+calibreweb_enabled: True
+calibreweb_port: 8083
+# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
+calibreweb_url: /books
+calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
+
 # BitTorrent downloader for large Content Packs etc
 transmission_install: False
 transmission_enabled: False
-
 # A. Uncomment language(s) to download KA Lite videos to /library/transmission
 #    using http://pantry.learningequality.org/downloads/ka-lite/0.17/content/
 transmission_kalite_languages:
@@ -231,33 +250,14 @@ transmission_kalite_languages:
 #    then click "Scan content folder for videos" (can take many minutes!)
 # E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO
 
-awstats_install: True
-awstats_enabled: True
-
-monit_install: True
-monit_enabled: True
-
-munin_install: True
-munin_enabled: True
-
-# Handy for maintaining tables, but DANGEROUS if not locked down
-phpmyadmin_install: True
-phpmyadmin_enabled: False
-
-vnstat_install: True
-vnstat_enabled: True
 
 # Unmaintained (better to install from http://teamviewer.com or prep scripts at http://download.iiab.io)
 # teamviewer_install: False
 # teamviewer_enabled: False
 
 # Unmaintained
-# sugar_stats_install: False
+# docker_install: False
-# sugar_stats_enabled: False
+# docker_enabled: False
-
-# Unmaintained
-# xovis_install: False
-# xovis_enabled: False
 
 # Unmaintained
 # schooltool_install: False
@@ -266,3 +266,15 @@ vnstat_enabled: True
 # Unmaintained
 # debian_schooltool_install: False
 # debian_schooltool_enabled: False
+
+# Unmaintained (consider Calibre or Calibre-Web above?)
+# pathagar_install: False
+# pathagar_enabled: False
+
+# Unmaintained
+# sugar_stats_install: False
+# sugar_stats_enabled: False
+
+# Unmaintained
+# xovis_install: False
+# xovis_enabled: False

vars/local_vars_medium.yml

@@ -69,6 +69,7 @@ dansguardian_enabled: False
 # wondershaper_install: False
 # wondershaper_enabled: False
 
+
 # 1-PREP
 
 # 2-COMMON
@@ -80,6 +81,7 @@ allow_apache_sudo: True
 
 # roles/mysql runs here (mandatory)
 
+
 # 4-SERVER-OPTIONS
 
 # SECURITY WARNING: See http://wiki.laptop.org/go/IIAB/Security
@@ -113,6 +115,7 @@ samba_enabled: False
 # Show entire contents of USB sticks/drives (at http://box/usb)
 iiab_usb_lib_show_all: True
 
+
 # 5-XO-SERVICES
 
 # Lesser-supported XO services need additional testing.  Please contact
@@ -131,33 +134,9 @@ iiab_usb_lib_show_all: True
 # ejabberd_xs_install: False
 # ejabberd_xs_enabled: False
 
+
 # 6-GENERIC-APPS
 
-# Calibre E-Book Library
-# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
-# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
-
-calibre_install: True
-calibre_enabled: True
-# Try .deb upgrade of Calibre (like vars/raspbian-9.yml already does)
-# calibre_via_debs: True
-calibre_unstable_debs: False
-# Try python x86_64 upgrade of Calibre (like vars/<most-OS's>.yml already do)
-# calibre_via_python: True
-# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
-calibre_port: 8080
-# Change calibre to XYZ to add your own mnemonic URL like: http://box/XYZ
-calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
-# In addition to: http://box/books box/libros box/livres box/livros box/liv
-
-# Calibre-Web alternative to Calibre, offers a clean/modern UX
-calibreweb_install: True
-calibreweb_enabled: True
-calibreweb_port: 8083
-# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
-calibreweb_url: /books
-calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
-
 dokuwiki_install: False
 dokuwiki_enabled: False
 
@@ -176,6 +155,7 @@ nextcloud_enabled: True
 wordpress_install: True
 wordpress_enabled: True
 
+
 # 7-EDU-APPS
 
 # KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS
@@ -198,21 +178,60 @@ moodle_enabled: False
 osm_install: True
 osm_enabled: True
 
-# Similar to Calibre, but unmaintained
-pathagar_install: False
-pathagar_enabled: False
-
 # Might stall MongoDB on Power Failure: github.com/xsce/xsce/issues/879
 # Sugarizer 1.0.1+ strategies to solve? github.com/iiab/iiab/pull/957
 sugarizer_install: True
 sugarizer_enabled: True
 
+
 # 8-MGMT-TOOLS
 
+awstats_install: True
+awstats_enabled: True
+
+monit_install: False
+monit_enabled: False
+
+munin_install: True
+munin_enabled: True
+
+# Handy for maintaining tables, but DANGEROUS if not locked down
+phpmyadmin_install: False
+phpmyadmin_enabled: False
+
+vnstat_install: True
+vnstat_enabled: True
+
+
+# 9-LOCAL-ADDONS
+
+# Calibre E-Book Library
+# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
+# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
+calibre_install: True
+calibre_enabled: True
+# Try .deb upgrade of Calibre (like vars/raspbian-9.yml already does)
+# calibre_via_debs: True
+calibre_unstable_debs: False
+# Try python x86_64 upgrade of Calibre (like vars/<most-OS's>.yml already do)
+# calibre_via_python: True
+# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
+calibre_port: 8080
+# Change calibre to XYZ to add your own mnemonic URL like: http://box/XYZ
+calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
+# In addition to: http://box/books box/libros box/livres box/livros box/liv
+
+# Calibre-Web alternative to Calibre, offers a clean/modern UX
+calibreweb_install: True
+calibreweb_enabled: True
+calibreweb_port: 8083
+# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
+calibreweb_url: /books
+calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
+
 # BitTorrent downloader for large Content Packs etc
 transmission_install: False
 transmission_enabled: False
-
 # A. Uncomment language(s) to download KA Lite videos to /library/transmission
 #    using http://pantry.learningequality.org/downloads/ka-lite/0.17/content/
 transmission_kalite_languages:
@@ -231,33 +250,14 @@ transmission_kalite_languages:
 #    then click "Scan content folder for videos" (can take many minutes!)
 # E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO
 
-awstats_install: True
-awstats_enabled: True
-
-monit_install: False
-monit_enabled: False
-
-munin_install: True
-munin_enabled: True
-
-# Handy for maintaining tables, but DANGEROUS if not locked down
-phpmyadmin_install: False
-phpmyadmin_enabled: False
-
-vnstat_install: True
-vnstat_enabled: True
 
 # Unmaintained (better to install from http://teamviewer.com or prep scripts at http://download.iiab.io)
 # teamviewer_install: False
 # teamviewer_enabled: False
 
 # Unmaintained
-# sugar_stats_install: False
+# docker_install: False
-# sugar_stats_enabled: False
+# docker_enabled: False
-
-# Unmaintained
-# xovis_install: False
-# xovis_enabled: False
 
 # Unmaintained
 # schooltool_install: False
@@ -266,3 +266,15 @@ vnstat_enabled: True
 # Unmaintained
 # debian_schooltool_install: False
 # debian_schooltool_enabled: False
+
+# Unmaintained (consider Calibre or Calibre-Web above?)
+# pathagar_install: False
+# pathagar_enabled: False
+
+# Unmaintained
+# sugar_stats_install: False
+# sugar_stats_enabled: False
+
+# Unmaintained
+# xovis_install: False
+# xovis_enabled: False

vars/local_vars_min.yml

@@ -69,6 +69,7 @@ dansguardian_enabled: False
 # wondershaper_install: False
 # wondershaper_enabled: False
 
+
 # 1-PREP
 
 # 2-COMMON
@@ -80,6 +81,7 @@ allow_apache_sudo: True
 
 # roles/mysql runs here (mandatory)
 
+
 # 4-SERVER-OPTIONS
 
 # SECURITY WARNING: See http://wiki.laptop.org/go/IIAB/Security
@@ -113,6 +115,7 @@ samba_enabled: False
 # Show entire contents of USB sticks/drives (at http://box/usb)
 iiab_usb_lib_show_all: True
 
+
 # 5-XO-SERVICES
 
 # Lesser-supported XO services need additional testing.  Please contact
@@ -131,33 +134,9 @@ iiab_usb_lib_show_all: True
 # ejabberd_xs_install: False
 # ejabberd_xs_enabled: False
 
+
 # 6-GENERIC-APPS
 
-# Calibre E-Book Library
-# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
-# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
-
-calibre_install: False
-calibre_enabled: False
-# Try .deb upgrade of Calibre (like vars/raspbian-9.yml already does)
-# calibre_via_debs: True
-calibre_unstable_debs: False
-# Try python x86_64 upgrade of Calibre (like vars/<most-OS's>.yml already do)
-# calibre_via_python: True
-# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
-calibre_port: 8080
-# Change calibre to XYZ to add your own mnemonic URL like: http://box/XYZ
-calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
-# In addition to: http://box/books box/libros box/livres box/livros box/liv
-
-# Calibre-Web alternative to Calibre, offers a clean/modern UX
-calibreweb_install: False
-calibreweb_enabled: False
-calibreweb_port: 8083
-# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
-calibreweb_url: /books
-calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
-
 dokuwiki_install: False
 dokuwiki_enabled: False
 
@@ -176,6 +155,7 @@ nextcloud_enabled: False
 wordpress_install: False
 wordpress_enabled: False
 
+
 # 7-EDU-APPS
 
 # KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS
@@ -198,21 +178,60 @@ moodle_enabled: False
 osm_install: False
 osm_enabled: False
 
-# Similar to Calibre, but unmaintained
-pathagar_install: False
-pathagar_enabled: False
-
 # Might stall MongoDB on Power Failure: github.com/xsce/xsce/issues/879
 # Sugarizer 1.0.1+ strategies to solve? github.com/iiab/iiab/pull/957
 sugarizer_install: False
 sugarizer_enabled: False
 
+
 # 8-MGMT-TOOLS
 
+awstats_install: True
+awstats_enabled: True
+
+monit_install: False
+monit_enabled: False
+
+munin_install: True
+munin_enabled: True
+
+# Handy for maintaining tables, but DANGEROUS if not locked down
+phpmyadmin_install: False
+phpmyadmin_enabled: False
+
+vnstat_install: True
+vnstat_enabled: True
+
+
+# 9-LOCAL-ADDONS
+
+# Calibre E-Book Library
+# WARNING: CALIBRE INSTALLS GRAPHICAL LIBRARIES SIMILAR TO X WINDOWS & OPENGL
+# ON (HEADLESS, SERVER, LITE) OS'S THAT DON'T ALREADY HAVE THESE INSTALLED.
+calibre_install: False
+calibre_enabled: False
+# Try .deb upgrade of Calibre (like vars/raspbian-9.yml already does)
+# calibre_via_debs: True
+calibre_unstable_debs: False
+# Try python x86_64 upgrade of Calibre (like vars/<most-OS's>.yml already do)
+# calibre_via_python: True
+# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
+calibre_port: 8080
+# Change calibre to XYZ to add your own mnemonic URL like: http://box/XYZ
+calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
+# In addition to: http://box/books box/libros box/livres box/livros box/liv
+
+# Calibre-Web alternative to Calibre, offers a clean/modern UX
+calibreweb_install: False
+calibreweb_enabled: False
+calibreweb_port: 8083
+# http://box/books works.  Add {box/libros, box/livres, box/livros, box/liv} etc?
+calibreweb_url: /books
+calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
+
 # BitTorrent downloader for large Content Packs etc
 transmission_install: False
 transmission_enabled: False
-
 # A. Uncomment language(s) to download KA Lite videos to /library/transmission
 #    using http://pantry.learningequality.org/downloads/ka-lite/0.17/content/
 transmission_kalite_languages:
@@ -231,33 +250,14 @@ transmission_kalite_languages:
 #    then click "Scan content folder for videos" (can take many minutes!)
 # E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO
 
-awstats_install: True
-awstats_enabled: True
-
-monit_install: False
-monit_enabled: False
-
-munin_install: True
-munin_enabled: True
-
-# Handy for maintaining tables, but DANGEROUS if not locked down
-phpmyadmin_install: False
-phpmyadmin_enabled: False
-
-vnstat_install: True
-vnstat_enabled: True
 
 # Unmaintained (better to install from http://teamviewer.com or prep scripts at http://download.iiab.io)
 # teamviewer_install: False
 # teamviewer_enabled: False
 
 # Unmaintained
-# sugar_stats_install: False
+# docker_install: False
-# sugar_stats_enabled: False
+# docker_enabled: False
-
-# Unmaintained
-# xovis_install: False
-# xovis_enabled: False
 
 # Unmaintained
 # schooltool_install: False
@@ -266,3 +266,15 @@ vnstat_enabled: True
 # Unmaintained
 # debian_schooltool_install: False
 # debian_schooltool_enabled: False
+
+# Unmaintained (consider Calibre or Calibre-Web above?)
+# pathagar_install: False
+# pathagar_enabled: False
+
+# Unmaintained
+# sugar_stats_install: False
+# sugar_stats_enabled: False
+
+# Unmaintained
+# xovis_install: False
+# xovis_enabled: False