1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00

Merge pull request #142 from iiab/master

sync from iiab/iiab
This commit is contained in:
A Holt 2018-08-31 03:18:01 -04:00 committed by GitHub
commit 5c61e086d8
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
22 changed files with 428 additions and 306 deletions

View file

@ -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
set_fact:
docker_install: True
docker_enabled: True
when: schooltool_enabled or schooltool_install
#- name: Turn on vars for Docker if SchoolTool is to be installed
# set_fact:
# docker_install: True
# docker_enabled: True
# when: schooltool_enabled or schooltool_install
- name: Set python_path (redhat)
set_fact:

View file

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

View file

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

View file

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

View file

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

View file

@ -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,
adjust e-book metadata, and create custom book collections ("bookshelves"):
e-books using an existing Calibre database. Teachers can upload e-books,
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
possible alternative to Calibre (we'll call it 'calibre-web' from here down,
noting that ``calibreweb_*`` variables do not include the dash, per Ansible
recommendations).
This Ansible role installs Calibre-Web as part of your Internet-in-a-Box (IIAB)
as a possible alternative to Calibre (we'll call it 'calibre-web' from here
down, noting that ``calibreweb_*`` variables do not include the dash, per
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
a bare/minimal metadata.db and force all settings to the default. Then run**::
**Then move your /library/calibre-web/metadata.db out of the way, if you're
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
array client devices and client software).
teachers to convert between PDF, EPUB, HTML, TXT etc — to permit reading on a
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
issues here, if they do arise: https://github.com/janeczku/calibre-web/issues
occasionally arise, when upstream developers change its master branch without
warning.
* *Please assist us in reporting serious issues here:*
https://github.com/janeczku/calibre-web/issues

View file

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

View file

@ -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)

View file

@ -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)
#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.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)
#- 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.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)
# 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

View file

@ -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)

View file

@ -2,48 +2,50 @@
KA Lite README
==============
This role installs KA Lite, an offline version of the Khan Academy (https://www.khanacademy.org/),
written by Learning Equality (https://learningequality.org/ka-lite/).
This role installs KA Lite, an offline version of Khan Academy (https://www.khanacademy.org) created by Learning Equality
(https://learningequality.org/ka-lite/).
KA Lite has 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 are
separate flags to enable these two servers.
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.
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
Password: changme
After your Internet-in-a-Box (IIAB) is completely installed, log in to KA Lite to explore and configure::
Bulk Loading Videos
-------------------
Username: Admin
Password: changeme
Videos and their corresponding png images can be copied into /library/ka-lite/content and will
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.
Bulk Downloading Videos
-----------------------
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
in this readme assumes the default values.
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.
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.*

View file

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

View file

@ -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_linux64: "kiwix-tools_linux-x86_64-0.6.0"
kiwix_version_i686: "kiwix-tools_linux-i586-0.6.0"
kiwix_version_armhf: "kiwix-tools_linux-armhf-0.6.1"
kiwix_version_linux64: "kiwix-tools_linux-x86_64-0.6.1"
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:

View file

@ -1,4 +1,11 @@
RewriteEngine on
RewriteRule ^{{ kiwix_alias_url }}$ {{ kiwix_url }} [R]
# 2018-08-31: FAILS to enable http://box/kiwix
#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 }}

View file

@ -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)

View file

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

View file

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

View file

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

View file

@ -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
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 - 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)

View file

@ -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
# sugar_stats_enabled: False
# Unmaintained
# xovis_install: False
# xovis_enabled: False
# docker_install: False
# docker_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

View file

@ -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
# sugar_stats_enabled: False
# Unmaintained
# xovis_install: False
# xovis_enabled: False
# docker_install: False
# docker_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

View file

@ -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
# sugar_stats_enabled: False
# Unmaintained
# xovis_install: False
# xovis_enabled: False
# docker_install: False
# docker_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