Merge pull request #293 from iiab/master

sync from iiab/iiab

roles/kiwix/defaults/main.yml

@@ -24,9 +24,9 @@ kiwix_src_file_linux64: "{{ kiwix_version_linux64 }}.tar.gz"
 kiwix_src_file_i686: "{{ kiwix_version_i686 }}.tar.gz"
 
 # Used for Kiwix proxy http://box/kiwix/
-kiwix_url: /kiwix/
+kiwix_url_without_slash: /kiwix
-kiwix_alias_url: /kiwix
+kiwix_url: "{{ kiwix_url_without_slash }}/"    # /kiwix/
-kiwix_path: "{{ iiab_base }}/kiwix"    # /opt/iiab
+kiwix_path: "{{ iiab_base }}/kiwix"            # /opt/iiab/kiwix
 
 # /library/zims contains 3 important things:
 # - library.xml

roles/kiwix/tasks/kiwix_install.yml

@@ -19,14 +19,12 @@
 
 - name: Install a stub /library/zims/library.xml if one doesn't exist
   template:
-    src: "{{ item }}"
+    src: library.xml
     dest: "{{ kiwix_library_xml }}"
     mode: 0644
     owner: root
     group: root
     force: no
-  with_items:
-  - library.xml
   when: not kiwix_xml.stat.exists
 
 - name: Check for /opt/iiab/kiwix/bin/kiwix-serve binary
@@ -73,6 +71,7 @@
 
 # 3. ENABLE MODS FOR APACHE PROXY IF DEBUNTU
 
+# 2019-09-29: Compare roles/kolibri/defaults/main.yml using just 1 (proxy_http)
 - name: Enable the 4 mods which permit Apache to proxy (debuntu)
   apache2_module:
     name: "{{ item }}"
@@ -95,10 +94,8 @@
     mode: "{{ item.mode }}"
   with_items:
     - { src: 'kiwix-serve.service.j2', dest: '/etc/systemd/system/kiwix-serve.service', mode: '0644'}
-#   - { src: 'kiwix-serve-init.j2', dest: '/usr/libexec/kiwix-serve-init', mode: '0755'}
     - { src: 'iiab-make-kiwix-lib', dest: '/usr/bin/iiab-make-kiwix-lib', mode: '0755'}
     - { src: 'iiab-make-kiwix-lib.py', dest: '/usr/bin/iiab-make-kiwix-lib.py', mode: '0755'}
-#  - { src: 'iiab-make-apache-config.py', dest: '/usr/bin/iiab-make-apache-config.py', mode: '0755'}
     - { src: 'kiwix.conf.j2', dest: '/etc/{{ apache_config_dir }}/kiwix.conf', mode: '0644'}
 
 - name: Create softlink kiwix.conf from sites-enabled to sites-available - for Kiwix Proxy in Apache - is disabled by turning off service kiwix-serve (debuntu)

roles/kiwix/templates/iiab-make-apache-config.py

@@ -1,40 +0,0 @@
-#!/usr/bin/python
-# write out proxy definitions for zim currently loaded
-
-import os, sys, syslog
-
-iiab_zim_path = "{{ iiab_zim_path }}"
-kiwix_apache_config = "/etc/{{ apache_config_dir }}/kiwix.conf"
-
-def main ():
-    content = iiab_zim_path + "/content/"
-    index = iiab_zim_path + "/index/"
-
-    # remove existing file
-    try:
-        os.remove(kiwix_apache_config)
-    except:
-        pass
-
-    with open(kiwix_apache_config, 'w') as fp:
-       fp.write("RewriteEngine on\n")
-       fp.write("ProxyPreserveHost on\n")
-       fp.write("ProxyPass /kiwix  http://127.0.0.1:3000\n")
-       fp.write("ProxyPassReverse /kiwix  http://127.0.0.1:3000\n")
-
-       for filename in os.listdir(content):
-          zimpos = filename.find(".zim")
-          if zimpos != -1:
-	     filename = filename[:zimpos]
-          fp.write("RewriteRule %s(.*)  http://127.0.0.1:3000/%s$1 [P]\n"% (filename,filename))
-          fp.write("ProxyPassReverse %s$1 http://localhost:3000/%s$1\n" % (filename,filename))
-
-
-
-
-if __name__ == "__main__":
-
-    # Run the main routine
-    main()
-
-# vim: tabstop=3 shiftwidth=3 expandtab softtabstop=3

roles/kiwix/templates/kiwix.conf.j2

@@ -1,9 +1,11 @@
+# SEE https://github.com/iiab/iiab/blob/master/roles/kolibri/templates/kolibri.conf.j2
+
 # 2018-08-31: FAILS to enable http://box/kiwix
 #RewriteEngine on
-#RewriteRule ^{{ kiwix_alias_url }}$ {{ kiwix_url }} [R]
+#RewriteRule ^{{ kiwix_url_without_slash }}$ {{ kiwix_url }} [R]
 
 # 2018-08-31: SUCCEEDS in enabling http://box/kiwix
-RedirectMatch ^{{ kiwix_alias_url }}$ {{ kiwix_url }}
+RedirectMatch ^{{ kiwix_url_without_slash }}$ {{ kiwix_url }}
 
 # 2018-08-31: SUCCEEDS in enabling http://box/kiwix/ & http://box/kiwix/zim & http://box/kiwix/zim/
 #ProxyPreserveHost On

roles/kolibri/defaults/main.yml

@@ -1,38 +1,45 @@
 # kolibri_install: False
 # kolibri_enabled: False
 
+# kolibri_language: en    # ar,bn-bd,en,es-es,fa,fr-fr,hi-in,mr,nyn,pt-br,sw-tz,ta,te,ur-pk,yo,zu
+
 # kolibri_http_port: 8009
 
 # All above are set in: github.com/iiab/iiab/blob/master/vars/default_vars.yml
 # If nec, change them by editing /etc/iiab/local_vars.yml prior to installing!
 
-# 2019-06-21: Just comment out this pinning line if you want Kolibri's "latest" version, after 0.12.4's bug is resolved: https://github.com/iiab/iiab/issues/1675 https://github.com/learningequality/kolibri/issues/5664
+# 2019-09-27: Pinning to a particular version is unfortunately NOT supported
-# kolibri_version: 0.12.5
+# with our new apt approach (.deb installer) at this time.
+# 2019-06-21: Uncomment this pinning line if you want a particular version of
+# Kolibri rather than the "latest", e.g. to work around after 0.12.4's bug:
+# kolibri_version: 0.12.3
+# https://github.com/iiab/iiab/issues/1675
+# https://github.com/learningequality/kolibri/issues/5664
+
+kolibri_deb_url: https://learningequality.org/r/kolibri-deb-latest
 
 # Kolibri folder to store its data and configuration files.
 kolibri_home: "{{ content_base }}/kolibri"    # /library/kolibri
 
-kolibri_url: /kolibri
+kolibri_url_without_slash: /kolibri
-kolibri_venv_path: /usr/local/kolibri
+kolibri_url: "{{ kolibri_url_without_slash }}/"    # /kolibri/
-# 2018-07-16: IIAB recommends /usr/bin but @arky says this isn't yet possible, due to pip
-kolibri_exec_path: "{{ kolibri_venv_path }}/bin/kolibri"
 
-# Kolibri system user
+kolibri_exec_path: /usr/bin/kolibri
-kolibri_user: kolibri
 
-# Kolibri setup will be provisioned with default administration account, preset and
+kolibri_user: kolibri    # Whereas a vanilla install of Kolibri auto-identifies
-# language. You could turn this to 'False' while reinstalling kolibri.
+# and saves a 'desktop' user like {iiab-admin, pi} to /etc/kolibri/username,
+# towards guaranteeing access to USB devices, per:
+# https://kolibri.readthedocs.io/en/latest/install.html#changing-the-owner-of-kolibri-system-service
+
+# To populate /library/kolibri with essential/minimum files and dirs.  This
+# provisions Kolibri with facility name, admin acnt / password, preset type,
+# and language.  You can set this to 'False' when reinstalling Kolibri:
 kolibri_provision: True
 
-# Kolibri Facility name
 kolibri_facility: Kolibri-in-a-Box
 
+kolibri_admin_user: Admin
+kolibri_admin_password: changeme
+
 # Kolibri Preset type: formal, nonformal, informal
 kolibri_preset: formal
-
-# Kolibri default language (ar,bn-bd,en,es-es,fa,fr-fr,hi-in,mr,nyn,pt-br,sw-tz,ta,te,ur-pk,yo,zu)
-kolibri_language: en
-
-# Kolibri admin account
-kolibri_admin_user: Admin
-kolibri_admin_password: changeme

roles/kolibri/tasks/main.yml

@@ -1,4 +1,4 @@
-- name: Create Linux user {{ kolibri_user }} and add it to groups {{ apache_user }}, disk
+- name: Create Linux user '{{ kolibri_user }}' and add it to groups '{{ apache_user }}', 'disk'
   user:
     name: "{{ kolibri_user }}"
     groups:
@@ -9,34 +9,37 @@
     system: yes
     create_home: no
 
-- name: Create {{ kolibri_home }} (for data) and {{ kolibri_venv_path }} (venv for program/config)
+- name: Create {{ kolibri_home }} (for Kolibri content, configuration, sqlite3 databases)
   file:
-    path: "{{ item }}"
+    path: "{{ kolibri_home }}"     # /library/kolibri
-    owner: "{{ kolibri_user }}"
+    owner: "{{ kolibri_user }}"    # kolibri
-    group: "{{ apache_user }}"
+    group: "{{ apache_user }}"     # www-data (on Debian/Ubuntu/Raspbian)
     mode: 0755
     state: directory
-  with_items:
-    - "{{ kolibri_home }}"         # /library/kolibri
-    - "{{ kolibri_venv_path }}"    # /usr/local/kolibri
 
-- name: Install latest Kolibri using pip, to venv
+- name: Create /etc/kolibri
-  pip:
+  file:
-    name: kolibri
+    name: /etc/kolibri
-    virtualenv: "{{ kolibri_venv_path }}"
+    state: directory
-    virtualenv_site_packages: no
+    owner: root
-    state: latest
+    group: root
-    extra_args: --no-cache-dir
+    mode: 0755
-  when: internet_available and not (kolibri_version is defined)
 
-- name: Install Kolibri {{ kolibri_version }} using pip, to venv
+- name: Save kolibri_user ({{ kolibri_user }}) to /etc/kolibri/username
-  pip:
+  copy:
-    name: kolibri
+    content: "{{ kolibri_user }}"
-    virtualenv: "{{ kolibri_venv_path }}"
+    dest: /etc/kolibri/username
-    virtualenv_site_packages: no
+    owner: root
-    version: "{{ kolibri_version }}"
+    group: root
-    extra_args: --no-cache-dir
+    mode: 0644
-  when: internet_available and kolibri_version is defined
+
+- name: apt install latest Kolibri .deb from {{ kolibri_deb_url }}
+  apt:
+    deb: "{{ kolibri_deb_url }}"    # https://learningequality.org/r/kolibri-deb-latest
+  environment:
+    KOLIBRI_HOME: "{{ kolibri_home }}"    # these don't do a thing for now but
+    KOLIBRI_USER: "{{ kolibri_user }}"    # both can't hurt & Might Help Later
+  when: internet_available | bool
 
 - name: 'Install from templates: kolibri.service unit file for systemd & sites-available/kolibri.conf for Apache'
   template:
@@ -56,33 +59,47 @@
     enabled: yes
     state: stopped
 
-- name: Run Kolibri migrations (WHY? WHAT DOES THIS DO?)
+
+- name: Run Kolibri migrations to begin populating {{ kolibri_home }}    # i.e. /library/kolibri
   shell: export KOLIBRI_HOME="{{ kolibri_home }}" && "{{ kolibri_exec_path }}" manage migrate
   ignore_errors: yes
+  become: yes
+  become_user: "{{ kolibri_user }}"
   when: kolibri_provision | bool
 
 - name: Set Kolibri default language
   shell: export KOLIBRI_HOME="{{ kolibri_home }}" && "{{ kolibri_exec_path }}" language setdefault "{{ kolibri_language }}"
   ignore_errors: yes
+  become: yes
+  become_user: "{{ kolibri_user }}"
   when: kolibri_provision | bool
 
-- name: Create Kolibri default facility name, admin account and language
+- name: Set Kolibri facility name, admin acnt / password, preset type, and language
   shell: >
     export KOLIBRI_HOME="{{ kolibri_home }}" &&
     "{{ kolibri_exec_path }}" manage provisiondevice --facility "{{ kolibri_facility }}"
     --superusername "{{ kolibri_admin_user }}" --superuserpassword "{{ kolibri_admin_password }}"
     --preset "{{ kolibri_preset }}" --language_id "{{ kolibri_language }}" --verbosity 0 --noinput
   ignore_errors: yes
+  become: yes
+  become_user: "{{ kolibri_user }}"
   when: kolibri_provision | bool
 
-- name: chown -R {{ kolibri_user }}:{{ apache_user }} {{ kolibri_home }}
+- name: chown -R {{ kolibri_user }}:{{ apache_user }} {{ kolibri_home }} for good measure?
   file:
-    path: "{{ kolibri_home }}"
+    path: "{{ kolibri_home }}"     # /library/kolibri
-    owner: "{{ kolibri_user }}"
+    owner: "{{ kolibri_user }}"    # kolibri
-    group: "{{ apache_user }}"
+    group: "{{ apache_user }}"     # www-data (on Debian/Ubuntu/Raspbian)
     recurse: yes
   when: kolibri_provision | bool
 
+
+# 2019-09-29: roles/kiwix/tasks/kiwix_install.yml installs 4 Apache modules
+# for similar purposes (not all nec?)  Only 1 (proxy_http) is needed here.
+- name: Enable Apache module proxy_http for http://box{{ kolibri_url }}    # i.e. http://box/kolibri
+  apache2_module:
+    name: proxy_http
+
 - name: Start 'kolibri' systemd service, if kolibri_enabled
   systemd:
     name: kolibri
@@ -122,9 +139,9 @@
       value: '"Kolibri is an open-source educational platform specially designed to provide offline access to a wide range of quality, openly licensed educational contents in low-resource contexts like rural schools, refugee camps, orphanages, and also in non-formal school programs."'
     - option: kolibri_url
       value: "{{ kolibri_url }}"
-    - option: kolibri_path
+    - option: kolibri_exec_path
       value: "{{ kolibri_exec_path }}"
-    - option: kolibri_port
+    - option: kolibri_http_port
       value: "{{ kolibri_http_port }}"
     - option: kolibri_enabled
       value: "{{ kolibri_enabled }}"

roles/kolibri/templates/kolibri.conf.j2

@@ -1,3 +1,6 @@
+# SEE https://github.com/iiab/iiab/blob/master/roles/kiwix/templates/kiwix.conf.j2
+RedirectMatch ^{{ kolibri_url_without_slash }}$ {{ kolibri_url }}
+
 ProxyPreserveHost   On
 ProxyPass           {{ kolibri_url }}          http://localhost:{{ kolibri_http_port }}{{ kolibri_url }}
 ProxyPassReverse    {{ kolibri_url }}          http://localhost:{{ kolibri_http_port }}{{ kolibri_url }}

scripts/ansible

@@ -7,7 +7,7 @@ GOOD_VER="2.8.5"    # For XO laptops (pip install) & CentOS (yum install rpm)
 export DEBIAN_FRONTEND=noninteractive
 
 echo -e "\n\nYOU ARE RUNNING: /opt/iiab/iiab/scripts/ansible (TO INSTALL ANSIBLE)"
-echo -e 'Alternative:     /opt/iiab/iiab/scripts/ansible-2.6.x ("Slow Food")\n'
+echo -e 'Alternative:     /opt/iiab/iiab/scripts/ansible-2.7.x ("Slow Food")\n'
 
 echo -e "RECOMMENDED PREREQUISITES:"
 echo -e "(1) Verify you're online"

scripts/iiab-diagnostics

@@ -165,7 +165,7 @@ cat_cmd 'netstat -natp' 'Ports/Services in use'
 cat_cmd 'iptables-save' 'Firewall rules'
 cat_cmd 'systemctl status dnsmasq' 'Is dnsmasq Ok?'
 cat_cmd 'journalctl -u dnsmasq' 'dnsmasq log'
-#cat_cmd 'ansible localhost -m setup 2>/dev/null' 'All Ansible facts'    # For cleaner scraping of Ansible vars, see alternative ~20 lines above?
+#cat_cmd 'ansible localhost -m setup 2>/dev/null' 'All Ansible facts'    # For cleaner scraping of Ansible vars, consider "./runrole all-vars /tmp/all-ansible-vars" 15-19 lines above?
 
 echo -e "\n  5. Log Files: (last 100 lines of each)\n"
 cat_tail /opt/iiab/iiab/iiab-install.log 100

vars/default_vars.yml

@@ -387,6 +387,7 @@ kalite_password: kalite
 
 kolibri_install: False
 kolibri_enabled: False
+kolibri_language: en    # ar,bn-bd,en,es-es,fa,fr-fr,hi-in,mr,nyn,pt-br,sw-tz,ta,te,ur-pk,yo,zu
 kolibri_http_port: 8009
 
 # kiwix_install: True is REQUIRED, if you install IIAB's Admin Console
@@ -407,11 +408,12 @@ mongodb_install: False
 mongodb_enabled: False
 mongodb_port: 27018
 
-# Regional OSM vector maps use much less disk space than bitmap/raster versions
+# Regional OSM vector maps use far less disk space than bitmap/raster versions.
+# Instructions: https://github.com/iiab/iiab/wiki/IIAB-Maps
 osm_vector_maps_install: True
 osm_vector_maps_enabled: True
 iiab_map_url : http://download.iiab.io/content/OSM/vector-tiles/maplist/hidden
-vector_map_path: "{{ content_base }}/www/osm-vector-maps"
+vector_map_path: "{{ content_base }}/www/osm-vector-maps"    # /library/www/osm-vector-maps
 
 # roles/sugarizer/meta/main.yml auto-invokes 2 above prereqs: mongodb & nodejs
 # Might stall MongoDB on Power Failure: github.com/xsce/xsce/issues/879
@@ -542,14 +544,13 @@ minetest_flat_world: False
 # authserver_install: False
 # authserver_enabled: False
 
-# CONSIDER THESE 2 NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD, AS OF 2018:
+# CONSIDER THESE NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD:
-# - http://download.iiab.io/content/OSM/vector-tiles/
-# - http://oer2go.org/viewmod/en-worldmap-10
 #
-# DOWNLOAD EITHER OSM MANUALLY, OR BETTER YET TRY IIAB'S ADMIN CONSOLE:
+# 2019: https://github.com/iiab/iiab/wiki/IIAB-Maps SEE ABOVE osm_vector_maps_*
-#   http://box/admin -> Install Content -> Get OER2GO(RACHEL) Modules
+# 2018: http://download.iiab.io/content/OSM/vector-tiles/
+# 2017: http://oer2go.org/viewmod/en-worldmap-10
 #
-# Unmaintained:
+# Unmaintained
 # osm_install: False
 # osm_enabled: False
 # Changed in June 2017, from the original:

vars/local_vars_big.yml

@@ -238,9 +238,6 @@ nextcloud_allow_public_ips: False
 # Configuration tips for IPv4 access controls and tuning RAM/resources:
 # https://github.com/iiab/iiab/blob/master/roles/nextcloud/README.md
 
-# To further refine Nextcloud access controls based on IPv4 addresses, see:
-# https://github.com/iiab/iiab/blob/master/roles/nextcloud/templates/nextcloud.conf.j2
-
 # A full-featured PBX (for rural telephony, etc) based on Asterisk and FreePBX.
 # Works on Ubuntu 18.04, Debian 9. Experimental on Rasp/RPi 3. Uses Node.js 10.x
 pbx_install: False
@@ -262,6 +259,7 @@ kalite_cron_enabled: True
 
 kolibri_install: True
 kolibri_enabled: True
+kolibri_language: en    # ar,bn-bd,en,es-es,fa,fr-fr,hi-in,mr,nyn,pt-br,sw-tz,ta,te,ur-pk,yo,zu
 
 # kiwix_install: True is REQUIRED, if you install IIAB's Admin Console
 kiwix_install: True
@@ -272,7 +270,8 @@ moodle_install: True
 moodle_enabled: True
 # If using Moodle intensively, set apache_high_php_limits in 3-BASE-SERVER
 
-# Regional OSM vector maps use much less disk space than bitmap/raster versions
+# Regional OSM vector maps use far less disk space than bitmap/raster versions.
+# Instructions: https://github.com/iiab/iiab/wiki/IIAB-Maps
 osm_vector_maps_install: True
 osm_vector_maps_enabled: True
 
@@ -360,12 +359,11 @@ minetest_install: True
 minetest_enabled: True
 
 
-# CONSIDER THESE 2 NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD, AS OF 2018:
+# CONSIDER THESE NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD:
-# - http://download.iiab.io/content/OSM/vector-tiles/
-# - http://oer2go.org/viewmod/en-worldmap-10
 #
-# DOWNLOAD EITHER OSM MANUALLY, OR BETTER YET TRY IIAB'S ADMIN CONSOLE:
+# 2019: https://github.com/iiab/iiab/wiki/IIAB-Maps SEE ABOVE osm_vector_maps_*
-#   http://box/admin -> Install Content -> Get OER2GO(RACHEL) Modules
+# 2018: http://download.iiab.io/content/OSM/vector-tiles/
+# 2017: http://oer2go.org/viewmod/en-worldmap-10
 #
 # Unmaintained
 # osm_install: False

vars/local_vars_medium.yml

@@ -259,6 +259,7 @@ kalite_cron_enabled: True
 
 kolibri_install: False
 kolibri_enabled: False
+kolibri_language: en    # ar,bn-bd,en,es-es,fa,fr-fr,hi-in,mr,nyn,pt-br,sw-tz,ta,te,ur-pk,yo,zu
 
 # kiwix_install: True is REQUIRED, if you install IIAB's Admin Console
 kiwix_install: True
@@ -269,7 +270,8 @@ moodle_install: False
 moodle_enabled: False
 # If using Moodle intensively, set apache_high_php_limits in 3-BASE-SERVER
 
-# Regional OSM vector maps use much less disk space than bitmap/raster versions
+# Regional OSM vector maps use far less disk space than bitmap/raster versions.
+# Instructions: https://github.com/iiab/iiab/wiki/IIAB-Maps
 osm_vector_maps_install: True
 osm_vector_maps_enabled: True
 
@@ -357,12 +359,11 @@ minetest_install: False
 minetest_enabled: False
 
 
-# CONSIDER THESE 2 NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD, AS OF 2018:
+# CONSIDER THESE NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD:
-# - http://download.iiab.io/content/OSM/vector-tiles/
-# - http://oer2go.org/viewmod/en-worldmap-10
 #
-# DOWNLOAD EITHER OSM MANUALLY, OR BETTER YET TRY IIAB'S ADMIN CONSOLE:
+# 2019: https://github.com/iiab/iiab/wiki/IIAB-Maps SEE ABOVE osm_vector_maps_*
-#   http://box/admin -> Install Content -> Get OER2GO(RACHEL) Modules
+# 2018: http://download.iiab.io/content/OSM/vector-tiles/
+# 2017: http://oer2go.org/viewmod/en-worldmap-10
 #
 # Unmaintained
 # osm_install: False

vars/local_vars_min.yml

@@ -259,6 +259,7 @@ kalite_cron_enabled: True
 
 kolibri_install: False
 kolibri_enabled: False
+kolibri_language: en    # ar,bn-bd,en,es-es,fa,fr-fr,hi-in,mr,nyn,pt-br,sw-tz,ta,te,ur-pk,yo,zu
 
 # kiwix_install: True is REQUIRED, if you install IIAB's Admin Console
 kiwix_install: True
@@ -269,7 +270,8 @@ moodle_install: False
 moodle_enabled: False
 # If using Moodle intensively, set apache_high_php_limits in 3-BASE-SERVER
 
-# Regional OSM vector maps use much less disk space than bitmap/raster versions
+# Regional OSM vector maps use far less disk space than bitmap/raster versions.
+# Instructions: https://github.com/iiab/iiab/wiki/IIAB-Maps
 osm_vector_maps_install: True
 osm_vector_maps_enabled: True
 
@@ -357,12 +359,11 @@ minetest_install: False
 minetest_enabled: False
 
 
-# CONSIDER THESE 2 NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD, AS OF 2018:
+# CONSIDER THESE NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD:
-# - http://download.iiab.io/content/OSM/vector-tiles/
-# - http://oer2go.org/viewmod/en-worldmap-10
 #
-# DOWNLOAD EITHER OSM MANUALLY, OR BETTER YET TRY IIAB'S ADMIN CONSOLE:
+# 2019: https://github.com/iiab/iiab/wiki/IIAB-Maps SEE ABOVE osm_vector_maps_*
-#   http://box/admin -> Install Content -> Get OER2GO(RACHEL) Modules
+# 2018: http://download.iiab.io/content/OSM/vector-tiles/
+# 2017: http://oer2go.org/viewmod/en-worldmap-10
 #
 # Unmaintained
 # osm_install: False