Merge branch 'master' of https://github.com/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

@@ -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/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/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/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/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.
 

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