From c27b6d31aeef0871f26cc8e7bceca9a5eeac8a22 Mon Sep 17 00:00:00 2001 From: Arky Date: Thu, 16 Aug 2018 16:36:45 +0700 Subject: [PATCH 01/71] Initial Import --- roles/transmission/README.rst | 32 ++++++++++++++++++++++++++++ roles/transmission/defaults/main.yml | 6 ++++++ roles/transmission/tasks/main.yml | 25 ++++++++++++++++++++++ 3 files changed, 63 insertions(+) create mode 100644 roles/transmission/README.rst create mode 100644 roles/transmission/defaults/main.yml create mode 100644 roles/transmission/tasks/main.yml diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst new file mode 100644 index 000000000..4f51851e8 --- /dev/null +++ b/roles/transmission/README.rst @@ -0,0 +1,32 @@ +===================== +Transmission README +===================== +Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All its incarnations feature a very simple, intuitive + interface on top on an efficient, cross-platform back-end. + +In Internet in a box we are using transmission-daemon, transmission-cli and transmission-remote-cli. + +#transmission-cli - lightweight BitTorrent client (command line programs) +#transmission-daemon - lightweight BitTorrent client (daemon) +#transmission-remote-cli - ncurses interface for the Transmission BitTorrent daemon + + Access + ------ + +You can access transmission using http://box/port or using the command line program. + + + Adding torrents + --------------- + +The torrents are added by provisioning system based on the variables. You can also add +your own torrent using web UI or command-line option. + +$ transmission-remote-cli http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ \ +ka-lite-0.17-resized-videos-english.torrent + + + + + Troubleshooting + ---------------- diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml new file mode 100644 index 000000000..9bf6bb63a --- /dev/null +++ b/roles/transmission/defaults/main.yml @@ -0,0 +1,6 @@ +# The values here are defaults. +# To override them edit /etc/iiab/local_vars.yml + +# Installation Variables +transmission_install: False +transmission_enabled: False diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml new file mode 100644 index 000000000..49bb612d8 --- /dev/null +++ b/roles/transmission/tasks/main.yml @@ -0,0 +1,25 @@ +--- +- name: Install Transmission daemon and cli-tools. + package: + name: "{{ item }}" + state: present + with_items: + - transmission-daemon + - transmission-remote-cli + - transmission-cli + +- name: Add transmission to list of services at /etc/iiab/iiab.ini + ini_file: + dest: "{{ service_filelist }}" + section: transmission + option: "{{ item.option }}" + value: "{{ item.value }}" + with_items: + - option: name + value: transmission + - option: description + value: '"Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form)."' + - option: transmission_enabled + value: "{{ transmission_enabled }}" + - option: transmission_install + value: "{{ transmission_install }}" From 78dace3a3ee593cafcba74d28845fb5fd1f1e61d Mon Sep 17 00:00:00 2001 From: Arky Date: Fri, 17 Aug 2018 00:46:23 +0700 Subject: [PATCH 02/71] Removing transmission-remote-cli: Not found on Raspbian --- roles/transmission/tasks/main.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 49bb612d8..48d8ef1d8 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -5,7 +5,6 @@ state: present with_items: - transmission-daemon - - transmission-remote-cli - transmission-cli - name: Add transmission to list of services at /etc/iiab/iiab.ini From 6e846399028ffc5c94f3254968bb4b122266619d Mon Sep 17 00:00:00 2001 From: Arky Date: Fri, 17 Aug 2018 01:54:55 +0700 Subject: [PATCH 03/71] Proof-of-Concept: Install and Start downloading a torrent --- .../templates/gateway/iiab-gen-iptables | 2 + roles/transmission/README.rst | 18 ++--- roles/transmission/defaults/main.yml | 18 +++++ roles/transmission/tasks/main.yml | 38 ++++++++++ roles/transmission/templates/settings.json.j2 | 73 +++++++++++++++++++ 5 files changed, 140 insertions(+), 9 deletions(-) create mode 100644 roles/transmission/templates/settings.json.j2 diff --git a/roles/network/templates/gateway/iiab-gen-iptables b/roles/network/templates/gateway/iiab-gen-iptables index 812fe1b39..7271e2f32 100755 --- a/roles/network/templates/gateway/iiab-gen-iptables +++ b/roles/network/templates/gateway/iiab-gen-iptables @@ -94,6 +94,8 @@ if [ "$services_externally_visible" == "True" ]; then $IPTABLES -A INPUT -p tcp --dport $kolibri_http_port -m state --state NEW -i $wan -j ACCEPT $IPTABLES -A INPUT -p tcp --dport $calibre_port -m state --state NEW -i $wan -j ACCEPT $IPTABLES -A INPUT -p tcp --dport $sugarizer_port -m state --state NEW -i $wan -j ACCEPT + $IPTABLES -A INPUT -p tcp --dport $transmission_http_port -m state --state NEW -i $wan -j ACCEPT + $IPTABLES -A INPUT -p tcp --dport $transmission_peer_port -m state --state NEW -i $wan -j ACCEPT fi if [ "$iiab_gateway_enabled" == "True" ]; then diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 4f51851e8..53ea77678 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -4,26 +4,26 @@ Transmission README Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All its incarnations feature a very simple, intuitive interface on top on an efficient, cross-platform back-end. -In Internet in a box we are using transmission-daemon, transmission-cli and transmission-remote-cli. - -#transmission-cli - lightweight BitTorrent client (command line programs) -#transmission-daemon - lightweight BitTorrent client (daemon) -#transmission-remote-cli - ncurses interface for the Transmission BitTorrent daemon +Caution +------- +Usage of transmission consumes significant Internet data and system resources. +Caveat emptor! (That's Latin for "Buyer Beware"). Access ------ -You can access transmission using http://box/port or using the command line program. +You can login transmission using http://box:9091/ or using the command line program. +Username: Admin +Password: changeme Adding torrents --------------- The torrents are added by provisioning system based on the variables. You can also add -your own torrent using web UI or command-line option. +your own torrent using web UI or command-line option. -$ transmission-remote-cli http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ \ -ka-lite-0.17-resized-videos-english.torrent +$ transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ka-lite-0.17-resized-videos-english.torrent diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index 9bf6bb63a..91d05059f 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -4,3 +4,21 @@ # Installation Variables transmission_install: False transmission_enabled: False + +# Provision Transmission with default torrents +transmission_provision: True + +transmission_KaLite-Version: 0.17 +transmission_KaLite-Languages: English + +transmission_download_dir: /library/transmission + +#TODO Open this port to WAN. +#TODO Also open the default peer port 51413 and range 65535-49152 +transmission_http_port: 9091 +transmission_peer_port: 51413 + +transmission_url : "/transmission/" + +transmission_username: Admin +transmission_password: changeme diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 48d8ef1d8..2890910d1 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -1,4 +1,14 @@ --- +- name: Create Transmission download directory + file: + path: "{{ item }}" + owner: root + group: root + mode: 0755 + state: directory + with_items: + - "{{ transmission_download_dir }}" + - name: Install Transmission daemon and cli-tools. package: name: "{{ item }}" @@ -7,6 +17,34 @@ - transmission-daemon - transmission-cli +- name: Stop Transmission daemon before creating settings. + service: + name: transmission-daemon + state: stopped + +- name: Create the transmission-daemon settings + template: + src: "{{ item.src }}" + dest: "{{ item.dest }}" + mode: "{{ item.mode }}" + owner: root + group: root + with_items: + - { src: 'settings.json.j2', dest: '/etc/transmission-daemon/settings.json', mode: '0644' } + +- name: Start Transmission daemon. + service: + name: transmission-daemon + state: restarted + enabled: yes + when: transmission_enabled + +# TODO Make this loop transmission_KaLite-Languages +- name: Add a torrent Ka-Lite English + shell: transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ka-lite-0.17-resized-videos-english.torrent + ignore_errors: yes + when: transmission_provision + - name: Add transmission to list of services at /etc/iiab/iiab.ini ini_file: dest: "{{ service_filelist }}" diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 new file mode 100644 index 000000000..067037e07 --- /dev/null +++ b/roles/transmission/templates/settings.json.j2 @@ -0,0 +1,73 @@ +{ + "alt-speed-down": 50, + "alt-speed-enabled": false, + "alt-speed-time-begin": 540, + "alt-speed-time-day": 127, + "alt-speed-time-enabled": false, + "alt-speed-time-end": 1020, + "alt-speed-up": 50, + "bind-address-ipv4": "0.0.0.0", + "bind-address-ipv6": "::", + "blocklist-enabled": false, + "blocklist-url": "http://www.example.com/blocklist", + "cache-size-mb": 4, + "dht-enabled": true, + "download-dir": "{{ transmission_download_dir }}", + "download-limit": 100, + "download-limit-enabled": 0, + "download-queue-enabled": true, + "download-queue-size": 5, + "encryption": 1, + "idle-seeding-limit": 30, + "idle-seeding-limit-enabled": false, + "incomplete-dir": "/var/lib/transmission-daemon/Downloads", + "incomplete-dir-enabled": false, + "lpd-enabled": false, + "max-peers-global": 200, + "message-level": 1, + "peer-congestion-algorithm": "", + "peer-id-ttl-hours": 6, + "peer-limit-global": 200, + "peer-limit-per-torrent": 50, + "peer-port": "{{ transmission_peer_port }}", + "peer-port-random-high": 65535, + "peer-port-random-low": 49152, + "peer-port-random-on-start": false, + "peer-socket-tos": "default", + "pex-enabled": true, + "port-forwarding-enabled": false, + "preallocation": 1, + "prefetch-enabled": true, + "queue-stalled-enabled": true, + "queue-stalled-minutes": 30, + "ratio-limit": 2, + "ratio-limit-enabled": false, + "rename-partial-files": true, + "rpc-authentication-required": false, + "rpc-bind-address": "0.0.0.0", + "rpc-enabled": true, + "rpc-host-whitelist": "", + "rpc-host-whitelist-enabled": true, + "rpc-password": "{{ transmission_password }}", + "rpc-port": "{{ transmission_http_port }}", + "rpc-url": "{{ transmission_url }}", + "rpc-username": "{{ transmission_username }}", + "rpc-whitelist": "127.0.0.1", + "rpc-whitelist-enabled": true, + "scrape-paused-torrents-enabled": true, + "script-torrent-done-enabled": false, + "script-torrent-done-filename": "", + "seed-queue-enabled": false, + "seed-queue-size": 10, + "speed-limit-down": 100, + "speed-limit-down-enabled": false, + "speed-limit-up": 100, + "speed-limit-up-enabled": false, + "start-added-torrents": true, + "trash-original-torrent-files": false, + "umask": 18, + "upload-limit": 100, + "upload-limit-enabled": 0, + "upload-slots-per-torrent": 14, + "utp-enabled": true +} From 7de870d611bf75b1b516f985294e547f77ac771d Mon Sep 17 00:00:00 2001 From: Arky Date: Fri, 17 Aug 2018 22:40:48 +0700 Subject: [PATCH 04/71] Enable adding multiple language torrents. You can add multiple ka-lite language downloads by using provisioning system. Also added notes to the readme file. --- roles/transmission/README.rst | 7 +++++-- roles/transmission/defaults/main.yml | 16 ++++++++++++---- roles/transmission/tasks/main.yml | 10 ++++++++-- 3 files changed, 25 insertions(+), 8 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 53ea77678..91b35a7d8 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -22,9 +22,12 @@ Password: changeme The torrents are added by provisioning system based on the variables. You can also add your own torrent using web UI or command-line option. +s +$ transmission-remote -a -$ transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ka-lite-0.17-resized-videos-english.torrent - +Known Issues +------------- +Currently it is not possible to use random ports in the range 65535-49152. It is difficult to open multiple ports in IIAB firewall. diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index 91d05059f..635e02e4d 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -5,12 +5,20 @@ transmission_install: False transmission_enabled: False -# Provision Transmission with default torrents +# Provision Transmission with default torrents from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ transmission_provision: True +transmission_kalite_version: 0.17 +# Uncomment to enable a language to download. +transmission_kalite_languages: + - "english" + - "french" + - "hindi" + - "portugal-portuguese" + - "brazilian-portuguese" + - "spanish" + - "swahili" -transmission_KaLite-Version: 0.17 -transmission_KaLite-Languages: English - +# Transmission default download directory. transmission_download_dir: /library/transmission #TODO Open this port to WAN. diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 2890910d1..7c2cc8955 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -40,8 +40,14 @@ when: transmission_enabled # TODO Make this loop transmission_KaLite-Languages -- name: Add a torrent Ka-Lite English - shell: transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ka-lite-0.17-resized-videos-english.torrent +#- name: Add a torrent Ka-Lite English +# shell: transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ka-lite-0.17-resized-videos-english.torrent +# ignore_errors: yes +# when: transmission_provision + +- name: Add ka-lite torrents + shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/"{{ transmission_kalite_version }}"/content/ka-lite-0.17-resized-videos-"{{ transmission_kalite_languages }}".torrent + with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes when: transmission_provision From a4d41441568f93511517fe2e103988841d6973e4 Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 11:13:16 +0700 Subject: [PATCH 05/71] Correct transmission variables and use 'to_json' Ensure that transmission_http_port variable is not reset in iiab-gen-iptables. Remote the extra qoutes and also use to_json to clean the transmission_kalite_languages output. Restructure the defaults section. Update the README documentation. --- .../templates/gateway/iiab-gen-iptables | 1 + roles/transmission/README.rst | 30 +++++++++++++++---- roles/transmission/defaults/main.yml | 19 ++++++------ roles/transmission/tasks/main.yml | 2 +- 4 files changed, 36 insertions(+), 16 deletions(-) diff --git a/roles/network/templates/gateway/iiab-gen-iptables b/roles/network/templates/gateway/iiab-gen-iptables index 7271e2f32..9daa3e5bd 100755 --- a/roles/network/templates/gateway/iiab-gen-iptables +++ b/roles/network/templates/gateway/iiab-gen-iptables @@ -58,6 +58,7 @@ calibre_port={{ calibre_port }} kiwix_port={{ kiwix_port }} kalite_server_port={{ kalite_server_port }} kolibri_http_port={{ kolibri_http_port }} +transmission_http_port={{ transmission_http_port }} sugarizer_port={{ sugarizer_port }} block_DNS={{ block_DNS }} captive_portal_enabled={{ captive_portal_enabled }} diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 91b35a7d8..eeb994ef7 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -4,6 +4,9 @@ Transmission README Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All its incarnations feature a very simple, intuitive interface on top on an efficient, cross-platform back-end. +The transmission program is used to download and seed Ka-Lite packages. Once the packages are download, Please verify the content +before copying them to Ka-Lite content directory. + Caution ------- Usage of transmission consumes significant Internet data and system resources. @@ -12,17 +15,29 @@ Caveat emptor! (That's Latin for "Buyer Beware"). Access ------ -You can login transmission using http://box:9091/ or using the command line program. +You can login transmission using its web interface http://box:9091/ with the following administration account. Username: Admin Password: changeme +Alternatively you can also access transmission using the 'transmission-remote' or 'transmission-remote' on the command line. + +Configuration +-------------- +You can configure transmission using the web interface http://box:9091. + +You can also edit the transmission settings in '/etc/transmission-daemon/settings.json'. Before you start editing the +'settings.json' file, Please ensure that transmission-daemon.service is stop. + +$ sudo systemctl stop transmission-daemon.service +$ sudo nano /etc/transmission-daemon/settings.json + + Adding torrents --------------- +The transmission provisioning system is designed to add ka-Lite packages. You can also use transmission is +download torrent using the Transmission web interface or using 'transmission-remote' program. -The torrents are added by provisioning system based on the variables. You can also add -your own torrent using web UI or command-line option. -s $ transmission-remote -a Known Issues @@ -30,6 +45,11 @@ Known Issues Currently it is not possible to use random ports in the range 65535-49152. It is difficult to open multiple ports in IIAB firewall. - Troubleshooting ---------------- + +Please check if the transmission daemon is running: + +$ sudo systemctl status transmission-daemon.service + +Check the transmission settings '/etc/transmission-daemon/settings.json' are correct. diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index 635e02e4d..f089f9daf 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -5,6 +5,14 @@ transmission_install: False transmission_enabled: False +# Transmission default download directory. +transmission_download_dir: /library/transmission + +# Transmission default web and bittorrent ports +transmission_http_port: 9091 +transmission_peer_port: 51413 +transmission_url : "/transmission/" + # Provision Transmission with default torrents from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ transmission_provision: True transmission_kalite_version: 0.17 @@ -18,15 +26,6 @@ transmission_kalite_languages: - "spanish" - "swahili" -# Transmission default download directory. -transmission_download_dir: /library/transmission - -#TODO Open this port to WAN. -#TODO Also open the default peer port 51413 and range 65535-49152 -transmission_http_port: 9091 -transmission_peer_port: 51413 - -transmission_url : "/transmission/" - +# Transmission administration account transmission_username: Admin transmission_password: changeme diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 7c2cc8955..eccb9e4c2 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -46,7 +46,7 @@ # when: transmission_provision - name: Add ka-lite torrents - shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/"{{ transmission_kalite_version }}"/content/ka-lite-0.17-resized-videos-"{{ transmission_kalite_languages }}".torrent + shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ transmission_kalite_languages | to_json }}.torrent with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes when: transmission_provision From 3681a0ed56bc61e7aee19bdf484fc60e715d4ece Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 11:18:15 +0700 Subject: [PATCH 06/71] Simple typo corrected --- roles/transmission/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index eeb994ef7..2f461a88c 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -4,7 +4,7 @@ Transmission README Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All its incarnations feature a very simple, intuitive interface on top on an efficient, cross-platform back-end. -The transmission program is used to download and seed Ka-Lite packages. Once the packages are download, Please verify the content +The transmission program is used to download and seed Ka-Lite packages. Once the packages are downloaded, Please verify the content before copying them to Ka-Lite content directory. Caution From 62ed40a792c7962f069bcc2b41604f55f5e46652 Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 11:20:00 +0700 Subject: [PATCH 07/71] Correctly assign transmission_peer_port in iiab-gen-iptables --- roles/network/templates/gateway/iiab-gen-iptables | 1 + 1 file changed, 1 insertion(+) diff --git a/roles/network/templates/gateway/iiab-gen-iptables b/roles/network/templates/gateway/iiab-gen-iptables index 9daa3e5bd..fdd91f56d 100755 --- a/roles/network/templates/gateway/iiab-gen-iptables +++ b/roles/network/templates/gateway/iiab-gen-iptables @@ -59,6 +59,7 @@ kiwix_port={{ kiwix_port }} kalite_server_port={{ kalite_server_port }} kolibri_http_port={{ kolibri_http_port }} transmission_http_port={{ transmission_http_port }} +transmission_peer_port={{ transmission_peer_port }} sugarizer_port={{ sugarizer_port }} block_DNS={{ block_DNS }} captive_portal_enabled={{ captive_portal_enabled }} From e89f1eb9d7e4e36fc4a773c558f953db99abfae5 Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 11:26:19 +0700 Subject: [PATCH 08/71] Disable Transmission daemon and update variables --- roles/transmission/tasks/main.yml | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index eccb9e4c2..89282ed9a 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -39,18 +39,20 @@ enabled: yes when: transmission_enabled -# TODO Make this loop transmission_KaLite-Languages -#- name: Add a torrent Ka-Lite English -# shell: transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ka-lite-0.17-resized-videos-english.torrent -# ignore_errors: yes -# when: transmission_provision - - name: Add ka-lite torrents shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ transmission_kalite_languages | to_json }}.torrent with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes when: transmission_provision +- name: Disable Transmission daemon service. + service: + name: transmission-daemon + enabled: no + state: stopped + when: not transmission_enabled + + - name: Add transmission to list of services at /etc/iiab/iiab.ini ini_file: dest: "{{ service_filelist }}" @@ -66,3 +68,7 @@ value: "{{ transmission_enabled }}" - option: transmission_install value: "{{ transmission_install }}" + - option: transmission_http_port + value: "{{ transmission_http_port }}" + - option: transmission_url + value: "{{ Transmission_url }}" From 57f24c3ecafc07f40518ff995b935f2fa85cf38b Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 11:32:45 +0700 Subject: [PATCH 09/71] Minor syntax and cosmetics fixes --- roles/transmission/README.rst | 12 ++++++------ roles/transmission/tasks/main.yml | 6 +++--- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 2f461a88c..466a83300 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -12,8 +12,8 @@ Caution Usage of transmission consumes significant Internet data and system resources. Caveat emptor! (That's Latin for "Buyer Beware"). - Access - ------ +Access +------ You can login transmission using its web interface http://box:9091/ with the following administration account. @@ -33,8 +33,8 @@ $ sudo systemctl stop transmission-daemon.service $ sudo nano /etc/transmission-daemon/settings.json - Adding torrents - --------------- +Adding torrents +--------------- The transmission provisioning system is designed to add ka-Lite packages. You can also use transmission is download torrent using the Transmission web interface or using 'transmission-remote' program. @@ -45,8 +45,8 @@ Known Issues Currently it is not possible to use random ports in the range 65535-49152. It is difficult to open multiple ports in IIAB firewall. - Troubleshooting - ---------------- +Troubleshooting +---------------- Please check if the transmission daemon is running: diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 89282ed9a..f3eb72348 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -9,7 +9,7 @@ with_items: - "{{ transmission_download_dir }}" -- name: Install Transmission daemon and cli-tools. +- name: Install Transmission daemon and its command line tools. package: name: "{{ item }}" state: present @@ -17,7 +17,7 @@ - transmission-daemon - transmission-cli -- name: Stop Transmission daemon before creating settings. +- name: Stop Transmission daemon before modifying its settings. service: name: transmission-daemon state: stopped @@ -39,7 +39,7 @@ enabled: yes when: transmission_enabled -- name: Add ka-lite torrents +- name: Add ka-lite torrents to transmission daemon. shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ transmission_kalite_languages | to_json }}.torrent with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes From 6591d75639a41ec88efc6f593e726c01053cbc9c Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 17:32:35 +0700 Subject: [PATCH 10/71] Correct the variable transmission_url --- roles/transmission/tasks/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index f3eb72348..8a515eb6b 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -71,4 +71,4 @@ - option: transmission_http_port value: "{{ transmission_http_port }}" - option: transmission_url - value: "{{ Transmission_url }}" + value: "{{ transmission_url }}" From 7d7774f67212efadf55edef98a29d9bfa022d09f Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 17:43:59 +0700 Subject: [PATCH 11/71] Remote quotes --- roles/transmission/defaults/main.yml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index f089f9daf..e6ed2bb18 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -18,13 +18,13 @@ transmission_provision: True transmission_kalite_version: 0.17 # Uncomment to enable a language to download. transmission_kalite_languages: - - "english" - - "french" - - "hindi" - - "portugal-portuguese" - - "brazilian-portuguese" - - "spanish" - - "swahili" + - english + - french + - hindi + - portugal-portuguese + - brazilian-portuguese + - spanish + - swahili # Transmission administration account transmission_username: Admin From ee0f537a9f354f482f35a9314f2c0f08ca0ea1e7 Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 18:04:49 +0700 Subject: [PATCH 12/71] Fix looping issue. --- roles/transmission/tasks/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 8a515eb6b..96d712814 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -40,7 +40,7 @@ when: transmission_enabled - name: Add ka-lite torrents to transmission daemon. - shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ transmission_kalite_languages | to_json }}.torrent + shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ item }}.torrent with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes when: transmission_provision From b5e587df5eb7e31895229dddb447d16699facac5 Mon Sep 17 00:00:00 2001 From: Arky Date: Sat, 18 Aug 2018 23:23:14 +0700 Subject: [PATCH 13/71] Comment-off languages: Continue to debug transmission_http_port variable issue --- roles/transmission/defaults/main.yml | 11 ++++++----- roles/transmission/templates/settings.json.j2 | 13 +++++++------ 2 files changed, 13 insertions(+), 11 deletions(-) diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index e6ed2bb18..c6f2f35ae 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -8,7 +8,8 @@ transmission_enabled: False # Transmission default download directory. transmission_download_dir: /library/transmission -# Transmission default web and bittorrent ports +# Transmission default web and bittorrent ports http://box:9091/transmission/ +# TODO: BUG transmission_http_port is not assigned in settings.json? transmission_http_port: 9091 transmission_peer_port: 51413 transmission_url : "/transmission/" @@ -20,11 +21,11 @@ transmission_kalite_version: 0.17 transmission_kalite_languages: - english - french - - hindi + #- hindi - portugal-portuguese - - brazilian-portuguese - - spanish - - swahili + #- brazilian-portuguese + #- spanish + #- swahili # Transmission administration account transmission_username: Admin diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 index 067037e07..03da5036b 100644 --- a/roles/transmission/templates/settings.json.j2 +++ b/roles/transmission/templates/settings.json.j2 @@ -12,7 +12,7 @@ "blocklist-url": "http://www.example.com/blocklist", "cache-size-mb": 4, "dht-enabled": true, - "download-dir": "{{ transmission_download_dir }}", + "download-dir": {{ transmission_download_dir }}, "download-limit": 100, "download-limit-enabled": 0, "download-queue-enabled": true, @@ -29,7 +29,7 @@ "peer-id-ttl-hours": 6, "peer-limit-global": 200, "peer-limit-per-torrent": 50, - "peer-port": "{{ transmission_peer_port }}", + "peer-port": {{ transmission_peer_port }}, "peer-port-random-high": 65535, "peer-port-random-low": 49152, "peer-port-random-on-start": false, @@ -48,10 +48,11 @@ "rpc-enabled": true, "rpc-host-whitelist": "", "rpc-host-whitelist-enabled": true, - "rpc-password": "{{ transmission_password }}", - "rpc-port": "{{ transmission_http_port }}", - "rpc-url": "{{ transmission_url }}", - "rpc-username": "{{ transmission_username }}", + "rpc-password": {{ transmission_password }}, + # TODO: BUG transmission_http_port is not assigned in settings.json? + "rpc-port": {{ transmission_http_port }}, + "rpc-url": {{ transmission_url }}, + "rpc-username": {{ transmission_username }}, "rpc-whitelist": "127.0.0.1", "rpc-whitelist-enabled": true, "scrape-paused-torrents-enabled": true, From 5ec4c5ee2d202d727c39a786a4d94fbb06dddb26 Mon Sep 17 00:00:00 2001 From: Arky Date: Mon, 20 Aug 2018 15:51:47 +0700 Subject: [PATCH 14/71] Correct handling strings/numbers in templates, systemd transmission user/group --- roles/transmission/README.rst | 4 ++++ roles/transmission/defaults/main.yml | 9 +++++---- roles/transmission/tasks/main.yml | 9 ++++----- roles/transmission/templates/settings.json.j2 | 11 +++++------ 4 files changed, 18 insertions(+), 15 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 466a83300..f7680ee0f 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -42,6 +42,10 @@ $ transmission-remote -a Known Issues ------------- +* Default Transmission user/group (See https://github.com/transmission/transmission/issues/537) +Currently you need to set these these in "transmission_user" and "transmission_group" variables. You can check +the value for these in transmission-daemon systemd unit file "lib/systemd/system/transmission-daemon.service" +* Random Ports Currently it is not possible to use random ports in the range 65535-49152. It is difficult to open multiple ports in IIAB firewall. diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index c6f2f35ae..ba9c6929e 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -6,13 +6,14 @@ transmission_install: False transmission_enabled: False # Transmission default download directory. -transmission_download_dir: /library/transmission +transmission_download_dir: "/library/transmission/" # Transmission default web and bittorrent ports http://box:9091/transmission/ -# TODO: BUG transmission_http_port is not assigned in settings.json? transmission_http_port: 9091 transmission_peer_port: 51413 transmission_url : "/transmission/" +transmission_user: debian-transmission +transmission_group: root # Provision Transmission with default torrents from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ transmission_provision: True @@ -20,9 +21,9 @@ transmission_kalite_version: 0.17 # Uncomment to enable a language to download. transmission_kalite_languages: - english - - french + #- french #- hindi - - portugal-portuguese + #- portugal-portuguese #- brazilian-portuguese #- spanish #- swahili diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 96d712814..a71f831ee 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -2,8 +2,8 @@ - name: Create Transmission download directory file: path: "{{ item }}" - owner: root - group: root + owner: "{{ transmission_user }}" + group: "{{ transmission_group }}" mode: 0755 state: directory with_items: @@ -27,8 +27,8 @@ src: "{{ item.src }}" dest: "{{ item.dest }}" mode: "{{ item.mode }}" - owner: root - group: root + owner: "{{ transmission_user }}" + group: "{{ transmission_group }}" with_items: - { src: 'settings.json.j2', dest: '/etc/transmission-daemon/settings.json', mode: '0644' } @@ -52,7 +52,6 @@ state: stopped when: not transmission_enabled - - name: Add transmission to list of services at /etc/iiab/iiab.ini ini_file: dest: "{{ service_filelist }}" diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 index 03da5036b..d0c54402e 100644 --- a/roles/transmission/templates/settings.json.j2 +++ b/roles/transmission/templates/settings.json.j2 @@ -12,7 +12,7 @@ "blocklist-url": "http://www.example.com/blocklist", "cache-size-mb": 4, "dht-enabled": true, - "download-dir": {{ transmission_download_dir }}, + "download-dir": "{{ transmission_download_dir }}", "download-limit": 100, "download-limit-enabled": 0, "download-queue-enabled": true, @@ -29,7 +29,7 @@ "peer-id-ttl-hours": 6, "peer-limit-global": 200, "peer-limit-per-torrent": 50, - "peer-port": {{ transmission_peer_port }}, + "peer-port": {{ transmission_peer_port }}, "peer-port-random-high": 65535, "peer-port-random-low": 49152, "peer-port-random-on-start": false, @@ -48,11 +48,10 @@ "rpc-enabled": true, "rpc-host-whitelist": "", "rpc-host-whitelist-enabled": true, - "rpc-password": {{ transmission_password }}, - # TODO: BUG transmission_http_port is not assigned in settings.json? + "rpc-password": "{{ transmission_password }}", "rpc-port": {{ transmission_http_port }}, - "rpc-url": {{ transmission_url }}, - "rpc-username": {{ transmission_username }}, + "rpc-url": "{{ transmission_url }}", + "rpc-username": "{{ transmission_username }}", "rpc-whitelist": "127.0.0.1", "rpc-whitelist-enabled": true, "scrape-paused-torrents-enabled": true, From d6f475d57c8275743bb8aff50829a5df42f2a0bb Mon Sep 17 00:00:00 2001 From: Arky Date: Mon, 20 Aug 2018 16:27:41 +0700 Subject: [PATCH 15/71] Allow connections from localhost and local lan computers --- roles/transmission/templates/settings.json.j2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 index d0c54402e..a7c31a1ee 100644 --- a/roles/transmission/templates/settings.json.j2 +++ b/roles/transmission/templates/settings.json.j2 @@ -52,7 +52,7 @@ "rpc-port": {{ transmission_http_port }}, "rpc-url": "{{ transmission_url }}", "rpc-username": "{{ transmission_username }}", - "rpc-whitelist": "127.0.0.1", + "rpc-whitelist": "127.0.0.1,192.168.*.*", "rpc-whitelist-enabled": true, "scrape-paused-torrents-enabled": true, "script-torrent-done-enabled": false, From be51c32a74ab0b99833f3ad89caa4a8b10fa6f10 Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 20 Aug 2018 14:15:26 -0400 Subject: [PATCH 16/71] Proposed README.rst cleanups @arky please revert any of these changes/suggestions as necessary! --- roles/transmission/README.rst | 53 ++++++++++++++++++----------------- 1 file changed, 28 insertions(+), 25 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index f7680ee0f..12029afea 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -1,59 +1,62 @@ -===================== +=================== Transmission README -===================== -Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All its incarnations feature a very simple, intuitive - interface on top on an efficient, cross-platform back-end. +=================== -The transmission program is used to download and seed Ka-Lite packages. Once the packages are downloaded, Please verify the content -before copying them to Ka-Lite content directory. +Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All these incarnations feature a very simple and intuitive interface, on top on an efficient, cross-platform back-end. + +Transmission is intended to download KA Lite content to IIAB, from places like http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ -- and also to seed it, in assistance of others. + +Once the packages are downloaded, please verify the content before copying it (carefully) to KA Lite content directory: /library/ka-lite/content Caution ------- -Usage of transmission consumes significant Internet data and system resources. -Caveat emptor! (That's Latin for "Buyer Beware"). + +Usage of Transmission consumes significant Internet data and system resources. +Caveat emptor! (That's Latin for "Buyer Beware") Access ------ -You can login transmission using its web interface http://box:9091/ with the following administration account. +Login to Transmission's web interface http://box:9091 using administrative account: Username: Admin Password: changeme -Alternatively you can also access transmission using the 'transmission-remote' or 'transmission-remote' on the command line. +Alternatively, you can type 'transmission-remote' at the command-line. Configuration --------------- -You can configure transmission using the web interface http://box:9091. +------------- -You can also edit the transmission settings in '/etc/transmission-daemon/settings.json'. Before you start editing the -'settings.json' file, Please ensure that transmission-daemon.service is stop. +You can configure Transmission using its web interface http://box:9091 + +You can also edit Transmission settings in '/etc/transmission-daemon/settings.json'. Before you start editing the +'settings.json' file, please ensure that transmission-daemon.service is stopped: $ sudo systemctl stop transmission-daemon.service -$ sudo nano /etc/transmission-daemon/settings.json +$ sudo nano /etc/transmission-daemon/settings.json Adding torrents --------------- -The transmission provisioning system is designed to add ka-Lite packages. You can also use transmission is -download torrent using the Transmission web interface or using 'transmission-remote' program. + +Transmission can facilitate provisioning your IIAB, by adding KA Lite content from places like: http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ + +You can also download other torrents using Transmission's web interface, or by typing 'transmission-remote' at the command-line. $ transmission-remote -a Known Issues -------------- -* Default Transmission user/group (See https://github.com/transmission/transmission/issues/537) -Currently you need to set these these in "transmission_user" and "transmission_group" variables. You can check -the value for these in transmission-daemon systemd unit file "lib/systemd/system/transmission-daemon.service" -* Random Ports -Currently it is not possible to use random ports in the range 65535-49152. It is difficult to open multiple ports in IIAB firewall. +------------ +* Default Transmission user/group (See https://github.com/transmission/transmission/issues/537). Currently you need to set these "transmission_user" and "transmission_group" variables. Check their values in transmission-daemon's systemd unit file: lib/systemd/system/transmission-daemon.service + +* 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. Troubleshooting ----------------- +--------------- Please check if the transmission daemon is running: $ sudo systemctl status transmission-daemon.service -Check the transmission settings '/etc/transmission-daemon/settings.json' are correct. +Check that Transmission's settings are correct in: /etc/transmission-daemon/settings.json From 28827d8ded668a2b72dd78e121dc6d5c8a818f78 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 17:42:10 -0400 Subject: [PATCH 17/71] Update README.rst --- roles/transmission/README.rst | 44 +++++++++++++++++------------------ 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 12029afea..056139253 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -2,11 +2,11 @@ Transmission README =================== -Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All these incarnations feature a very simple and intuitive interface, on top on an efficient, cross-platform back-end. +Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All these incarnations feature a very simple and intuitive interface, on top on an efficient, cross-platform backend. -Transmission is intended to download KA Lite content to IIAB, from places like http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ -- and also to seed it, in assistance of others. +Transmission is intended to download KA Lite content to IIAB, from places like http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ — and also to seed content, assisting others. -Once the packages are downloaded, please verify the content before copying it (carefully) to KA Lite content directory: /library/ka-lite/content +Once the packages are downloaded, please verify the content before copying it (carefully!) into KA Lite content directory: ``/library/ka-lite/content`` Caution ------- @@ -14,49 +14,49 @@ Caution Usage of Transmission consumes significant Internet data and system resources. Caveat emptor! (That's Latin for "Buyer Beware") -Access ------- +Using It +-------- -Login to Transmission's web interface http://box:9091 using administrative account: +Login to Transmission's web interface http://box:9091 using administrative account:: -Username: Admin -Password: changeme + Username: Admin + Password: changeme -Alternatively, you can type 'transmission-remote' at the command-line. +Alternatively, you can run ``transmission-remote`` at the command-line. Configuration ------------- -You can configure Transmission using its web interface http://box:9091 +Configure Transmission using its web interface: http://box:9091 -You can also edit Transmission settings in '/etc/transmission-daemon/settings.json'. Before you start editing the -'settings.json' file, please ensure that transmission-daemon.service is stopped: +You can also edit Transmission settings in '/etc/transmission-daemon/settings.json'. Before you edit this file, ensure that transmission-daemon.service is stopped:: -$ sudo systemctl stop transmission-daemon.service - -$ sudo nano /etc/transmission-daemon/settings.json + systemctl stop transmission-daemon + nano /etc/transmission-daemon/settings.json Adding torrents --------------- -Transmission can facilitate provisioning your IIAB, by adding KA Lite content from places like: http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ +Transmission can facilitate provisioning content onto your IIAB, e.g. by adding KA Lite content from places like: http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ -You can also download other torrents using Transmission's web interface, or by typing 'transmission-remote' at the command-line. +You can also download other torrents using Transmission's web interface, or by typing 'transmission-remote' at the command-line:: -$ transmission-remote -a + transmission-remote -a Known Issues ------------ -* Default Transmission user/group (See https://github.com/transmission/transmission/issues/537). Currently you need to set these "transmission_user" and "transmission_group" variables. Check their values in transmission-daemon's systemd unit file: lib/systemd/system/transmission-daemon.service +* 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 (in the end check "User=" and "Group=" in systemd unit file /lib/systemd/system/transmission-daemon.service — both might need to be set to "debian-transmission" — followed by "systemctl daemon-reload" then "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. Troubleshooting --------------- -Please check if the transmission daemon is running: +Verify that transmission-daemon is running:: -$ sudo systemctl status transmission-daemon.service + systemctl status transmission-daemon -Check that Transmission's settings are correct in: /etc/transmission-daemon/settings.json +Check that Transmission's settings are correct in:: + + /etc/transmission-daemon/settings.json From a987e4c6dae13af8028714fabe5cc0b22f3813f6 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 17:44:50 -0400 Subject: [PATCH 18/71] Update main.yml --- roles/transmission/defaults/main.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index ba9c6929e..59679c499 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -5,10 +5,10 @@ transmission_install: False transmission_enabled: False -# Transmission default download directory. +# Transmission default download directory transmission_download_dir: "/library/transmission/" -# Transmission default web and bittorrent ports http://box:9091/transmission/ +# Transmission default web and BitTorrent ports for http://box:9091/transmission/ transmission_http_port: 9091 transmission_peer_port: 51413 transmission_url : "/transmission/" @@ -28,6 +28,6 @@ transmission_kalite_languages: #- spanish #- swahili -# Transmission administration account +# Transmission administrative account transmission_username: Admin transmission_password: changeme From 6a5634f47166ce481f35b17614aa0c17333d589b Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 17:47:05 -0400 Subject: [PATCH 19/71] Update main.yml --- roles/transmission/tasks/main.yml | 36 +++++++++++++++---------------- 1 file changed, 17 insertions(+), 19 deletions(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index a71f831ee..d5d22ac56 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -1,15 +1,12 @@ ---- - name: Create Transmission download directory file: - path: "{{ item }}" + path: "{{ transmission_download_dir }}" owner: "{{ transmission_user }}" group: "{{ transmission_group }}" mode: 0755 state: directory - with_items: - - "{{ transmission_download_dir }}" -- name: Install Transmission daemon and its command line tools. +- name: Install transmission-daemon and transmission-cli package: name: "{{ item }}" state: present @@ -17,37 +14,38 @@ - transmission-daemon - transmission-cli -- name: Stop Transmission daemon before modifying its settings. - service: +- name: Stop transmission-daemon before modifying its settings + systemd: name: transmission-daemon state: stopped + ignore_errors: yes -- name: Create the transmission-daemon settings +- name: Create transmission-daemon settings template: - src: "{{ item.src }}" - dest: "{{ item.dest }}" - mode: "{{ item.mode }}" + src: settings.json.j2 + dest: /etc/transmission-daemon/settings.json + mode: 0644 owner: "{{ transmission_user }}" group: "{{ transmission_group }}" - with_items: - - { src: 'settings.json.j2', dest: '/etc/transmission-daemon/settings.json', mode: '0644' } -- name: Start Transmission daemon. - service: +- name: Enable and Restart transmission-daemon service + systemd: name: transmission-daemon - state: restarted + daemon_reload: yes enabled: yes + state: restarted when: transmission_enabled -- name: Add ka-lite torrents to transmission daemon. +- name: Add KA Lite torrents to transmission-daemon's queue shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ item }}.torrent with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes when: transmission_provision -- name: Disable Transmission daemon service. - service: +- name: Disable transmission-daemon service + systemd: name: transmission-daemon + daemon_reload: yes enabled: no state: stopped when: not transmission_enabled From 5e4d7b0dbcc01aa90e2bd67bec37d8e2678b6012 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 18:05:14 -0400 Subject: [PATCH 20/71] Update main.yml --- roles/transmission/tasks/main.yml | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index d5d22ac56..b50c582f7 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -1,11 +1,3 @@ -- name: Create Transmission download directory - file: - path: "{{ transmission_download_dir }}" - owner: "{{ transmission_user }}" - group: "{{ transmission_group }}" - mode: 0755 - state: directory - - name: Install transmission-daemon and transmission-cli package: name: "{{ item }}" @@ -14,6 +6,14 @@ - transmission-daemon - transmission-cli +- name: Create Transmission download directory + file: + path: "{{ transmission_download_dir }}" + owner: "{{ transmission_user }}" + group: "{{ transmission_group }}" + mode: 0755 + state: directory + - name: Stop transmission-daemon before modifying its settings systemd: name: transmission-daemon From aabe79b4773361da74488dfa6d99bae2ad941aa2 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 18:07:41 -0400 Subject: [PATCH 21/71] Update README.rst --- roles/transmission/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 056139253..4edd03027 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -46,7 +46,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 (in the end check "User=" and "Group=" in systemd unit file /lib/systemd/system/transmission-daemon.service — both might need to be set to "debian-transmission" — followed by "systemctl daemon-reload" then "systemctl restart transmission-daemon"). +* 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 (in the end check 'User=' and 'Group=' in systemd unit file /lib/systemd/system/transmission-daemon.service — both might need to be set to 'debian-transmission' — followed by 'systemctl daemon-reload' then '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. From 66f9bf23020ad379f8c321e05f27ce03fac11380 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 18:16:46 -0400 Subject: [PATCH 22/71] Update README.rst --- roles/transmission/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 4edd03027..ecd6e5bf2 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -46,7 +46,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 (in the end check 'User=' and 'Group=' in systemd unit file /lib/systemd/system/transmission-daemon.service — both might need to be set to 'debian-transmission' — followed by 'systemctl daemon-reload' then 'systemctl restart transmission-daemon'). +* 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'). * 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. From 8bb8d773a7eb7bcfea45e47ab7d02346f9d28dab Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 18:39:35 -0400 Subject: [PATCH 23/71] Update main.yml --- roles/transmission/tasks/main.yml | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index b50c582f7..c916951fb 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -61,11 +61,29 @@ value: transmission - option: description value: '"Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form)."' - - option: transmission_enabled - value: "{{ transmission_enabled }}" - option: transmission_install value: "{{ transmission_install }}" + - option: transmission_enabled + value: "{{ transmission_enabled }}" + - option: transmission_download_dir + value: "{{ transmission_download_dir }}" - option: transmission_http_port value: "{{ transmission_http_port }}" + - option: transmission_peer_port + value: "{{ transmission_peer_port }}" - option: transmission_url value: "{{ transmission_url }}" + - option: transmission_user + value: "{{ transmission_user }}" + - option: transmission_group + value: "{{ transmission_group }}" + - option: transmission_provision + value: "{{ transmission_provision }}" + - option: transmission_kalite_version + value: "{{ transmission_kalite_version }}" + - option: transmission_kalite_languages + value: "{{ transmission_kalite_languages }}" + - option: transmission_username + value: "{{ transmission_username }}" + - option: transmission_password + value: "{{ transmission_password }}" From c2819a918d38d24fed5879a2de08d1835eb044e7 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 18:50:05 -0400 Subject: [PATCH 24/71] Update main.yml --- roles/transmission/tasks/main.yml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index c916951fb..40ed3c792 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -67,16 +67,16 @@ value: "{{ transmission_enabled }}" - option: transmission_download_dir value: "{{ transmission_download_dir }}" - - option: transmission_http_port - value: "{{ transmission_http_port }}" - - option: transmission_peer_port - value: "{{ transmission_peer_port }}" - - option: transmission_url - value: "{{ transmission_url }}" - option: transmission_user value: "{{ transmission_user }}" - option: transmission_group value: "{{ transmission_group }}" + - option: transmission_http_port + value: "{{ transmission_http_port }}" + - option: transmission_url + value: "{{ transmission_url }}" + - option: transmission_peer_port + value: "{{ transmission_peer_port }}" - option: transmission_provision value: "{{ transmission_provision }}" - option: transmission_kalite_version From 31766db6b05184ac3196cbc00420df7c4ac15963 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 18:50:57 -0400 Subject: [PATCH 25/71] Update main.yml --- roles/transmission/defaults/main.yml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index 59679c499..92cdfa17c 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -5,20 +5,20 @@ transmission_install: False transmission_enabled: False -# Transmission default download directory -transmission_download_dir: "/library/transmission/" - -# Transmission default web and BitTorrent ports for http://box:9091/transmission/ -transmission_http_port: 9091 -transmission_peer_port: 51413 -transmission_url : "/transmission/" +# Transmission download directory & general owner/group +transmission_download_dir: "{{ content_base }}/transmission/" # /library/transmission/ transmission_user: debian-transmission transmission_group: root -# Provision Transmission with default torrents from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ +# Transmission web interface http://box:9091/transmission/ and BitTorrent port +transmission_http_port: 9091 +transmission_url : "/transmission/" +transmission_peer_port: 51413 + +# Provision Transmission with torrent(s) from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ transmission_provision: True transmission_kalite_version: 0.17 -# Uncomment to enable a language to download. +# Uncomment to enable a language to download: transmission_kalite_languages: - english #- french From c66641196db51e2b7009185cd0d9cb534388cdc4 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 18:55:21 -0400 Subject: [PATCH 26/71] Update main.yml --- roles/transmission/tasks/main.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index 40ed3c792..c179317e6 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -1,4 +1,4 @@ -- name: Install transmission-daemon and transmission-cli +- name: Install packages transmission-daemon and transmission-cli package: name: "{{ item }}" state: present @@ -6,7 +6,7 @@ - transmission-daemon - transmission-cli -- name: Create Transmission download directory +- name: Create /library/transmission download directory file: path: "{{ transmission_download_dir }}" owner: "{{ transmission_user }}" @@ -36,7 +36,7 @@ state: restarted when: transmission_enabled -- name: Add KA Lite torrents to transmission-daemon's queue +- name: Add KA Lite torrent(s) to transmission-daemon's queue shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ item }}.torrent with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes From fec3b7b49aa37643fd77399ee4f1515049322136 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 19:00:53 -0400 Subject: [PATCH 27/71] Update settings.json.j2 --- roles/transmission/templates/settings.json.j2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 index a7c31a1ee..1f6386f7c 100644 --- a/roles/transmission/templates/settings.json.j2 +++ b/roles/transmission/templates/settings.json.j2 @@ -52,7 +52,7 @@ "rpc-port": {{ transmission_http_port }}, "rpc-url": "{{ transmission_url }}", "rpc-username": "{{ transmission_username }}", - "rpc-whitelist": "127.0.0.1,192.168.*.*", + "rpc-whitelist": "127.0.0.1,192.168.*.*,10.8.0.*", "rpc-whitelist-enabled": true, "scrape-paused-torrents-enabled": true, "script-torrent-done-enabled": false, From 0633039d4fb184f2db3d0e19bc3dfb1adccb646e Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 19:05:49 -0400 Subject: [PATCH 28/71] Update settings.json.j2 --- roles/transmission/templates/settings.json.j2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 index 1f6386f7c..a09ee9045 100644 --- a/roles/transmission/templates/settings.json.j2 +++ b/roles/transmission/templates/settings.json.j2 @@ -52,7 +52,7 @@ "rpc-port": {{ transmission_http_port }}, "rpc-url": "{{ transmission_url }}", "rpc-username": "{{ transmission_username }}", - "rpc-whitelist": "127.0.0.1,192.168.*.*,10.8.0.*", + "rpc-whitelist": "127.0.0.1,192.168.*.*,172.18.96.*,10.8.0.*", "rpc-whitelist-enabled": true, "scrape-paused-torrents-enabled": true, "script-torrent-done-enabled": false, From 5574d72f9a0b4ba70e451c2358ee128840523517 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 19:24:35 -0400 Subject: [PATCH 29/71] Update settings.json.j2 --- roles/transmission/templates/settings.json.j2 | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 index a09ee9045..8e62d0e6f 100644 --- a/roles/transmission/templates/settings.json.j2 +++ b/roles/transmission/templates/settings.json.j2 @@ -43,17 +43,17 @@ "ratio-limit": 2, "ratio-limit-enabled": false, "rename-partial-files": true, - "rpc-authentication-required": false, + "rpc-authentication-required": true, "rpc-bind-address": "0.0.0.0", "rpc-enabled": true, "rpc-host-whitelist": "", - "rpc-host-whitelist-enabled": true, + "rpc-host-whitelist-enabled": false, "rpc-password": "{{ transmission_password }}", "rpc-port": {{ transmission_http_port }}, "rpc-url": "{{ transmission_url }}", "rpc-username": "{{ transmission_username }}", "rpc-whitelist": "127.0.0.1,192.168.*.*,172.18.96.*,10.8.0.*", - "rpc-whitelist-enabled": true, + "rpc-whitelist-enabled": false, "scrape-paused-torrents-enabled": true, "script-torrent-done-enabled": false, "script-torrent-done-filename": "", From 660047e784332c3bde2fea23a92b336dc6b99457 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 19:39:30 -0400 Subject: [PATCH 30/71] Update README.rst --- roles/transmission/README.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index ecd6e5bf2..f830a138b 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -29,11 +29,16 @@ Configuration Configure Transmission using its web interface: http://box:9091 -You can also edit Transmission settings in '/etc/transmission-daemon/settings.json'. Before you edit this file, ensure that transmission-daemon.service is stopped:: +More settings can be edited within '/etc/transmission-daemon/settings.json' if you first ensure that the transmission-daemon.service is stopped:: systemctl stop transmission-daemon + +Then edit the file:: + nano /etc/transmission-daemon/settings.json +Here are some short explanations, as to what those 70+ variables mean: https://github.com/transmission/transmission/wiki/Editing-Configuration-Files + Adding torrents --------------- @@ -57,6 +62,6 @@ Verify that transmission-daemon is running:: systemctl status transmission-daemon -Check that Transmission's settings are correct in:: +Re-check that Transmission's settings are correct in:: /etc/transmission-daemon/settings.json From bcad4d8029788528281059e6674286a7e31c8954 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 20:13:22 -0400 Subject: [PATCH 31/71] Update default_vars.yml --- vars/default_vars.yml | 33 +++++++++++++++++++++++++++------ 1 file changed, 27 insertions(+), 6 deletions(-) diff --git a/vars/default_vars.yml b/vars/default_vars.yml index 4654ae3e0..9bfa218fb 100644 --- a/vars/default_vars.yml +++ b/vars/default_vars.yml @@ -259,10 +259,9 @@ idmgr_enables: False # 6-GENERIC-APPS -# Calibre - -# WARNING: CALIBRE REQUIRES X WINDOWS / OPENGL LIBRARIES. Consider installing -# an OS that includes a GUI (desktop) environment if you need Calibre E-Books. +# 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 @@ -275,10 +274,14 @@ calibre_via_python: False 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 -# 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 dokuwiki_install: False @@ -360,7 +363,25 @@ sugarizer_port: 8089 # 8-MGMT-TOOLS -# AWStats -- sumarizes http access logs +# Transmission BitTorrent download of large Content Packs etc +transmission_install: False +transmission_enabled: False + +# Monitor downloads at http://box:9091 using Admin/changeme +transmission_http_port: 9091 +transmission_peer_port: 51413 + +# Uncomment language(s) to download their KA Lite content into /library/transmission +transmission_kalite_languages: + - english + #- french + #- hindi + #- portugal-portuguese + #- brazilian-portuguese + #- spanish + #- swahili + +# AWStats -- summarizes http access logs awstats_install: True awstats_enabled: False From 1447dcf7555ca36a03da1eb05ce86fbe841fb66f Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 20:24:05 -0400 Subject: [PATCH 32/71] Update default_vars.yml --- vars/default_vars.yml | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/vars/default_vars.yml b/vars/default_vars.yml index 9bfa218fb..25766e4be 100644 --- a/vars/default_vars.yml +++ b/vars/default_vars.yml @@ -268,7 +268,7 @@ 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/.yml try the x86_64 python upgrade of Calibre, overriding this default: +# vars/.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 @@ -279,7 +279,7 @@ calibre_web_path: calibre #NEEDS WORK: https://github.com/iiab/iiab/issues/529 calibreweb_install: True calibreweb_enabled: True calibreweb_port: 8083 -# http://box/books works. Add {box/libros, box/livres, box/livros, box/liv etc? +# 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 @@ -315,7 +315,7 @@ wordpress_enabled: False # 7-EDU-APPS -# KA Lite +# KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THE VIDEOS kalite_install: True kalite_enabled: False kalite_server_port: 8008 @@ -325,8 +325,6 @@ kalite_cron_enabled: False kalite_user: kalite kalite_password_hash: $6$$KHET0XRRsgAY.wOWyTOI3W7dyDh0ESOr48uI5vtk2xdzsU7aw0TF4ZkNuM34RmHBGMJ1fTCmOyVobo0LOhBlJ/ kalite_password: kalite -# Unused in 2018 -# kalite_server_name: kalite # Kolibri kolibri_install: False @@ -363,7 +361,7 @@ sugarizer_port: 8089 # 8-MGMT-TOOLS -# Transmission BitTorrent download of large Content Packs etc +# Transmission BitTorrent downloads large Content Packs etc transmission_install: False transmission_enabled: False From cf7a8d49081e04a42d12e6de5e75f1aa341b8ede Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 21:45:28 -0400 Subject: [PATCH 33/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index f0e55f4dc..3abc0748a 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -202,6 +202,23 @@ sugarizer_enabled: False # 8-MGMT-TOOLS +transmission_install: False +transmission_enabled: False + +# A. Uncomment language(s) to download KA Lite videos to /library/transmission +transmission_kalite_languages: + - english + #- french + #- hindi + #- portugal-portuguese + #- brazilian-portuguese + #- spanish + #- swahili +# B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme +# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) +# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO + awstats_install: True awstats_enabled: True From a78823a2bdba6ac92b58e48c3ab3ac9a3c041879 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 21:53:13 -0400 Subject: [PATCH 34/71] Update default_vars.yml --- vars/default_vars.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/vars/default_vars.yml b/vars/default_vars.yml index 25766e4be..3940beb87 100644 --- a/vars/default_vars.yml +++ b/vars/default_vars.yml @@ -315,7 +315,7 @@ wordpress_enabled: False # 7-EDU-APPS -# KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THE VIDEOS +# KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS kalite_install: True kalite_enabled: False kalite_server_port: 8008 From a8734b2cb224abc529aae49bc82bf9d689304cce Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 21:53:17 -0400 Subject: [PATCH 35/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index 3abc0748a..d741079e9 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -172,6 +172,7 @@ wordpress_enabled: False # 7-EDU-APPS +# KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS kalite_install: True kalite_enabled: True # Unused in 2018; but remains as placeholder for Fedora 18 legacy (XO laptops) From 45aafdbed297ca587ea063cb9bcc9f6610eef682 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 21:53:22 -0400 Subject: [PATCH 36/71] Update local_vars_medium.yml --- vars/local_vars_medium.yml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/vars/local_vars_medium.yml b/vars/local_vars_medium.yml index 2848aa0ce..1fd5cad98 100644 --- a/vars/local_vars_medium.yml +++ b/vars/local_vars_medium.yml @@ -172,6 +172,7 @@ wordpress_enabled: True # 7-EDU-APPS +# KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS kalite_install: True kalite_enabled: True # Unused in 2018; but remains as placeholder for Fedora 18 legacy (XO laptops) @@ -202,6 +203,23 @@ sugarizer_enabled: True # 8-MGMT-TOOLS +transmission_install: False +transmission_enabled: False + +# A. Uncomment language(s) to download KA Lite videos to /library/transmission +transmission_kalite_languages: + - english + #- french + #- hindi + #- portugal-portuguese + #- brazilian-portuguese + #- spanish + #- swahili +# B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme +# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) +# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO + awstats_install: True awstats_enabled: True From 2f3410d484c2acb6d449b76f4e644b3c751e53e9 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 22:00:23 -0400 Subject: [PATCH 37/71] Update default_vars.yml --- vars/default_vars.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/vars/default_vars.yml b/vars/default_vars.yml index 3940beb87..013cfd303 100644 --- a/vars/default_vars.yml +++ b/vars/default_vars.yml @@ -361,7 +361,7 @@ sugarizer_port: 8089 # 8-MGMT-TOOLS -# Transmission BitTorrent downloads large Content Packs etc +# Transmission is a BitTorrent downloader for large Content Packs etc transmission_install: False transmission_enabled: False @@ -379,7 +379,7 @@ transmission_kalite_languages: #- spanish #- swahili -# AWStats -- summarizes http access logs +# AWStats - summarizes http access logs awstats_install: True awstats_enabled: False From fe96e3b3e291e936c70861b1a5b72f2002e053cf Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 22:00:31 -0400 Subject: [PATCH 38/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index d741079e9..cc872aecc 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -203,6 +203,7 @@ sugarizer_enabled: False # 8-MGMT-TOOLS +# BitTorrent downloader for large Content Packs etc transmission_install: False transmission_enabled: False From 5cde3c8f8f12e2af757e5dd552c7efbc7a242b24 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 22:00:37 -0400 Subject: [PATCH 39/71] Update local_vars_medium.yml --- vars/local_vars_medium.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_medium.yml b/vars/local_vars_medium.yml index 1fd5cad98..551d2ccc2 100644 --- a/vars/local_vars_medium.yml +++ b/vars/local_vars_medium.yml @@ -203,6 +203,7 @@ sugarizer_enabled: True # 8-MGMT-TOOLS +# BitTorrent downloader for large Content Packs etc transmission_install: False transmission_enabled: False From 42d968c84c90994527d615516bbf81282e0e90a0 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 22:00:45 -0400 Subject: [PATCH 40/71] Update local_vars_big.yml --- vars/local_vars_big.yml | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/vars/local_vars_big.yml b/vars/local_vars_big.yml index 464ca014f..841fa979b 100644 --- a/vars/local_vars_big.yml +++ b/vars/local_vars_big.yml @@ -172,6 +172,7 @@ wordpress_enabled: True # 7-EDU-APPS +# KA Lite - SEE THE "Transmission" BITTORRENT DOWNLOADER FURTHER BELOW, TO INSTALL THOUSANDS OF VIDEOS kalite_install: True kalite_enabled: True # Unused in 2018; but remains as placeholder for Fedora 18 legacy (XO laptops) @@ -202,6 +203,24 @@ sugarizer_enabled: True # 8-MGMT-TOOLS +# 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 +transmission_kalite_languages: + - english + #- french + #- hindi + #- portugal-portuguese + #- brazilian-portuguese + #- spanish + #- swahili +# B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme +# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) +# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO + awstats_install: True awstats_enabled: True From a4979f098e794b4ad0d8892d684667c5a5301af7 Mon Sep 17 00:00:00 2001 From: A Holt Date: Tue, 28 Aug 2018 22:01:40 -0400 Subject: [PATCH 41/71] Delete local_vars_min_vpn.yml --- vars/local_vars_min_vpn.yml | 239 ------------------------------------ 1 file changed, 239 deletions(-) delete mode 100644 vars/local_vars_min_vpn.yml diff --git a/vars/local_vars_min_vpn.yml b/vars/local_vars_min_vpn.yml deleted file mode 100644 index d3b52eb79..000000000 --- a/vars/local_vars_min_vpn.yml +++ /dev/null @@ -1,239 +0,0 @@ -# This is local_vars_min_vpn.yml -- copy it to /etc/iiab/local_vars.yml then... - -# Put variables herein to override /opt/iiab/iiab/vars/default_vars.yml - -# PLEASE READ http://wiki.iiab.io/local_vars.yml - -# Orig Idea: branch github.com/xsce/xsce-local for your deployment/community - - -# Ansible's default timeout for "get_url:" downloads (10 seconds) often fails -download_timeout: 200 - -# Users and Passwords - -iiab_admin_user: iiab-admin -# Obtain a password hash with: -# python -c 'import crypt; print crypt.crypt("", "$6$<salt>")' -# iiab_admin_passw_hash: -admin_install: True - -# Set admin_install: False if you don't want iiab_admin_user & wheel group -# auto-created in roles/iiab-admin/tasks/main.yml, thereby disabling sudo-based -# warnings on use of published passwords like pi/raspberry & iiab-admin/g0adm1n - -# If admin_install: False, set iiab_admin_user (above) to an existing Linux -# user that has sudo access, so you can login to Admin Console http://box/admin - -iiab_hostname: box -iiab_domain: lan - -# Set to /home or /wordpress or /mediawiki or /wiki (for DokuWiki) -iiab_home_url: /home - -# Raspbian requires WiFi country since March 2018. Please set it here: -host_country_code: US -host_ssid: "Internet in a Box" -host_wifi_mode: g -host_channel: 6 -hostapd_secure: False -hostapd_password: changeme - -# Enables "campus access" to kiwix (3000), kalite (8008) & calibre (8010 or -# 8080) on WAN side of server. See network/templates/gateway/iiab-gen-iptables -# within github.com/iiab/iiab/blob/master/roles/ -services_externally_visible: True - -# Make this True if client machines should have access to WAN/Internet: -iiab_gateway_enabled: False - -# dnsmasq -dnsmasq_install: True -dnsmasq_enabled: False - -# Enable AFTER installing IIAB! Then run "cd /opt/iiab/iiab; ./iiab-network" -dns_jail_enabled: False - -# Simple python Captive Portal, that @m-anish & @jvonau are experimenting with in July 2018: github.com/iiab/iiab/pull/870 -py_captive_portal_install: True -py_captive_portal_enabled: False - -# Stages 3 & 4 must be run (using iiab-install or runrole) if changing these: -squid_install: False -squid_enabled: False - -dansguardian_install: False -dansguardian_enabled: False - -# Unmaintained as of October 2017: https://github.com/iiab/iiab/pull/382 -# wondershaper_install: False -# wondershaper_enabled: False - -# 1-PREP - -# 2-COMMON - -# 3-BASE-SERVER - -# Make this False to disable http://box/common/services/power_off.php button: -allow_apache_sudo: True - -# roles/mysql runs here (mandatory) - -# 4-SERVER-OPTIONS - -# SECURITY WARNING: See http://wiki.laptop.org/go/IIAB/Security -openvpn_install: True -openvpn_enabled: True - -# Set /etc/iiab/openvpn_handle in advance here: -openvpn_handle: "" - -# The following seems necessary on CentOS: -# openvpn_cron_enabled: True - -# roles/network runs here (MANY SETTINGS ABOVE) - -# PostgreSQL - auto-installed by Moodle and/or Pathagar - no need to touch! -postgresql_install: False -postgresql_enabled: False - -# Unmaintained -# authserver_install: False -# authserver_enabled: False - -# Common UNIX Printing System -cups_install: False -cups_enabled: False - -# At Your Own Risk: take a security audit seriously before deploying this -samba_install: False -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 -# http://lists.laptop.org/pipermail/server-devel/ if you're able to help test. - -# xo_services_install: False -# xo_services_enabled: False - -# activity_server_install: False -# activity_server_enabled: False - -# Change calibre_port from 8080 to 8010 below, if you enable idmgr -# idmgr_install: False -# idmgr_enabled: False - -# ejabberd_xs_install: False -# ejabberd_xs_enabled: False - -# 6-GENERIC-APPS - -# WARNING: CALIBRE REQUIRES X WINDOWS / OPENGL LIBRARIES. Consider installing -# an OS that includes a GUI (desktop) environment if you need Calibre E-Books. - -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 - -calibreweb_install: False -calibreweb_enabled: False - -dokuwiki_install: False -dokuwiki_enabled: False - -mediawiki_install: False -mediawiki_enabled: False - -elgg_install: False -elgg_enabled: False - -ejabberd_install: False -ejabberd_enabled: False - -nextcloud_install: False -nextcloud_enabled: False - -wordpress_install: False -wordpress_enabled: False - -# 7-EDU-APPS - -kalite_install: True -kalite_enabled: True -# Unused in 2018; but remains as placeholder for Fedora 18 legacy (XO laptops) -kalite_cron_enabled: True - -kolibri_install: False -kolibri_enabled: False - -kiwix_install: True -kiwix_enabled: True - -# Warning: Moodle is a serious LMS, that takes a while to install -moodle_install: False -moodle_enabled: False - -# OpenStreetMap: renamed from {iiab_install, iiab_enabled} in June 2017 -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 - -# 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 - -# Unmaintained -# schooltool_install: False -# schooltool_enabled: False - -# Unmaintained -# debian_schooltool_install: False -# debian_schooltool_enabled: False From 2e198bce1526a0c769f9c332111a49bd798849cd Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:01:44 -0400 Subject: [PATCH 42/71] Delete local_vars_medium_vpn.yml --- vars/local_vars_medium_vpn.yml | 239 --------------------------------- 1 file changed, 239 deletions(-) delete mode 100644 vars/local_vars_medium_vpn.yml diff --git a/vars/local_vars_medium_vpn.yml b/vars/local_vars_medium_vpn.yml deleted file mode 100644 index d73fe8699..000000000 --- a/vars/local_vars_medium_vpn.yml +++ /dev/null @@ -1,239 +0,0 @@ -# This is local_vars_medium_vpn.yml -- copy it to /etc/iiab/local_vars.yml then... - -# Put variables herein to override /opt/iiab/iiab/vars/default_vars.yml - -# PLEASE READ http://wiki.iiab.io/local_vars.yml - -# Orig Idea: branch github.com/xsce/xsce-local for your deployment/community - - -# Ansible's default timeout for "get_url:" downloads (10 seconds) often fails -download_timeout: 200 - -# Users and Passwords - -iiab_admin_user: iiab-admin -# Obtain a password hash with: -# python -c 'import crypt; print crypt.crypt("<plaintext>", "$6$<salt>")' -# iiab_admin_passw_hash: -admin_install: True - -# Set admin_install: False if you don't want iiab_admin_user & wheel group -# auto-created in roles/iiab-admin/tasks/main.yml, thereby disabling sudo-based -# warnings on use of published passwords like pi/raspberry & iiab-admin/g0adm1n - -# If admin_install: False, set iiab_admin_user (above) to an existing Linux -# user that has sudo access, so you can login to Admin Console http://box/admin - -iiab_hostname: box -iiab_domain: lan - -# Set to /home or /wordpress or /mediawiki or /wiki (for DokuWiki) -iiab_home_url: /home - -# Raspbian requires WiFi country since March 2018. Please set it here: -host_country_code: US -host_ssid: "Internet in a Box" -host_wifi_mode: g -host_channel: 6 -hostapd_secure: False -hostapd_password: changeme - -# Enables "campus access" to kiwix (3000), kalite (8008) & calibre (8010 or -# 8080) on WAN side of server. See network/templates/gateway/iiab-gen-iptables -# within github.com/iiab/iiab/blob/master/roles/ -services_externally_visible: True - -# Make this True if client machines should have access to WAN/Internet: -iiab_gateway_enabled: False - -# dnsmasq -dnsmasq_install: True -dnsmasq_enabled: False - -# Enable AFTER installing IIAB! Then run "cd /opt/iiab/iiab; ./iiab-network" -dns_jail_enabled: False - -# Simple python Captive Portal, that @m-anish & @jvonau are experimenting with in July 2018: github.com/iiab/iiab/pull/870 -py_captive_portal_install: True -py_captive_portal_enabled: False - -# Stages 3 & 4 must be run (using iiab-install or runrole) if changing these: -squid_install: False -squid_enabled: False - -dansguardian_install: False -dansguardian_enabled: False - -# Unmaintained as of October 2017: https://github.com/iiab/iiab/pull/382 -# wondershaper_install: False -# wondershaper_enabled: False - -# 1-PREP - -# 2-COMMON - -# 3-BASE-SERVER - -# Make this False to disable http://box/common/services/power_off.php button: -allow_apache_sudo: True - -# roles/mysql runs here (mandatory) - -# 4-SERVER-OPTIONS - -# SECURITY WARNING: See http://wiki.laptop.org/go/IIAB/Security -openvpn_install: True -openvpn_enabled: True - -# Set /etc/iiab/openvpn_handle in advance here: -openvpn_handle: "" - -# The following seems necessary on CentOS: -# openvpn_cron_enabled: True - -# roles/network runs here (MANY SETTINGS ABOVE) - -# PostgreSQL - auto-installed by Moodle and/or Pathagar - no need to touch! -postgresql_install: False -postgresql_enabled: False - -# Unmaintained -# authserver_install: False -# authserver_enabled: False - -# Common UNIX Printing System -cups_install: True -cups_enabled: False - -# At Your Own Risk: take a security audit seriously before deploying this -samba_install: False -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 -# http://lists.laptop.org/pipermail/server-devel/ if you're able to help test. - -# xo_services_install: False -# xo_services_enabled: False - -# activity_server_install: False -# activity_server_enabled: False - -# Change calibre_port from 8080 to 8010 below, if you enable idmgr -# idmgr_install: False -# idmgr_enabled: False - -# ejabberd_xs_install: False -# ejabberd_xs_enabled: False - -# 6-GENERIC-APPS - -# WARNING: CALIBRE REQUIRES X WINDOWS / OPENGL LIBRARIES. Consider installing -# an OS that includes a GUI (desktop) environment if you need Calibre E-Books. - -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 - -calibreweb_install: True -calibreweb_enabled: True - -dokuwiki_install: False -dokuwiki_enabled: False - -mediawiki_install: False -mediawiki_enabled: False - -elgg_install: True -elgg_enabled: True - -ejabberd_install: False -ejabberd_enabled: False - -nextcloud_install: True -nextcloud_enabled: True - -wordpress_install: True -wordpress_enabled: True - -# 7-EDU-APPS - -kalite_install: True -kalite_enabled: True -# Unused in 2018; but remains as placeholder for Fedora 18 legacy (XO laptops) -kalite_cron_enabled: True - -kolibri_install: False -kolibri_enabled: False - -kiwix_install: True -kiwix_enabled: True - -# Warning: Moodle is a serious LMS, that takes a while to install -moodle_install: False -moodle_enabled: False - -# OpenStreetMap: renamed from {iiab_install, iiab_enabled} in June 2017 -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 - -# 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 - -# Unmaintained -# schooltool_install: False -# schooltool_enabled: False - -# Unmaintained -# debian_schooltool_install: False -# debian_schooltool_enabled: False From e818891c5285fd4d2971fe51583d5a8b52c5e705 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:01:47 -0400 Subject: [PATCH 43/71] Delete local_vars_big_vpn.yml --- vars/local_vars_big_vpn.yml | 239 ------------------------------------ 1 file changed, 239 deletions(-) delete mode 100644 vars/local_vars_big_vpn.yml diff --git a/vars/local_vars_big_vpn.yml b/vars/local_vars_big_vpn.yml deleted file mode 100644 index 1e7db9e49..000000000 --- a/vars/local_vars_big_vpn.yml +++ /dev/null @@ -1,239 +0,0 @@ -# This is local_vars_big_vpn.yml -- copy it to /etc/iiab/local_vars.yml then... - -# Put variables herein to override /opt/iiab/iiab/vars/default_vars.yml - -# PLEASE READ http://wiki.iiab.io/local_vars.yml - -# Orig Idea: branch github.com/xsce/xsce-local for your deployment/community - - -# Ansible's default timeout for "get_url:" downloads (10 seconds) often fails -download_timeout: 200 - -# Users and Passwords - -iiab_admin_user: iiab-admin -# Obtain a password hash with: -# python -c 'import crypt; print crypt.crypt("<plaintext>", "$6$<salt>")' -# iiab_admin_passw_hash: -admin_install: True - -# Set admin_install: False if you don't want iiab_admin_user & wheel group -# auto-created in roles/iiab-admin/tasks/main.yml, thereby disabling sudo-based -# warnings on use of published passwords like pi/raspberry & iiab-admin/g0adm1n - -# If admin_install: False, set iiab_admin_user (above) to an existing Linux -# user that has sudo access, so you can login to Admin Console http://box/admin - -iiab_hostname: box -iiab_domain: lan - -# Set to /home or /wordpress or /mediawiki or /wiki (for DokuWiki) -iiab_home_url: /home - -# Raspbian requires WiFi country since March 2018. Please set it here: -host_country_code: US -host_ssid: "Internet in a Box" -host_wifi_mode: g -host_channel: 6 -hostapd_secure: False -hostapd_password: changeme - -# Enables "campus access" to kiwix (3000), kalite (8008) & calibre (8010 or -# 8080) on WAN side of server. See network/templates/gateway/iiab-gen-iptables -# within github.com/iiab/iiab/blob/master/roles/ -services_externally_visible: True - -# Make this True if client machines should have access to WAN/Internet: -iiab_gateway_enabled: False - -# dnsmasq -dnsmasq_install: True -dnsmasq_enabled: False - -# Enable AFTER installing IIAB! Then run "cd /opt/iiab/iiab; ./iiab-network" -dns_jail_enabled: False - -# Simple python Captive Portal, that @m-anish & @jvonau are experimenting with in July 2018: github.com/iiab/iiab/pull/870 -py_captive_portal_install: True -py_captive_portal_enabled: False - -# Stages 3 & 4 must be run (using iiab-install or runrole) if changing these: -squid_install: True -squid_enabled: True - -dansguardian_install: True -dansguardian_enabled: True - -# Unmaintained as of October 2017: https://github.com/iiab/iiab/pull/382 -# wondershaper_install: False -# wondershaper_enabled: False - -# 1-PREP - -# 2-COMMON - -# 3-BASE-SERVER - -# Make this False to disable http://box/common/services/power_off.php button: -allow_apache_sudo: True - -# roles/mysql runs here (mandatory) - -# 4-SERVER-OPTIONS - -# SECURITY WARNING: See http://wiki.laptop.org/go/IIAB/Security -openvpn_install: True -openvpn_enabled: True - -# Set /etc/iiab/openvpn_handle in advance here: -openvpn_handle: "" - -# The following seems necessary on CentOS: -# openvpn_cron_enabled: True - -# roles/network runs here (MANY SETTINGS ABOVE) - -# PostgreSQL - auto-installed by Moodle and/or Pathagar - no need to touch! -postgresql_install: False -postgresql_enabled: False - -# Unmaintained -# authserver_install: False -# authserver_enabled: False - -# Common UNIX Printing System -cups_install: True -cups_enabled: True - -# At Your Own Risk: take a security audit seriously before deploying this -samba_install: True -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 -# http://lists.laptop.org/pipermail/server-devel/ if you're able to help test. - -# xo_services_install: False -# xo_services_enabled: False - -# activity_server_install: False -# activity_server_enabled: False - -# Change calibre_port from 8080 to 8010 below, if you enable idmgr -# idmgr_install: False -# idmgr_enabled: False - -# ejabberd_xs_install: False -# ejabberd_xs_enabled: False - -# 6-GENERIC-APPS - -# WARNING: CALIBRE REQUIRES X WINDOWS / OPENGL LIBRARIES. Consider installing -# an OS that includes a GUI (desktop) environment if you need Calibre E-Books. - -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 - -calibreweb_install: True -calibreweb_enabled: True - -dokuwiki_install: True -dokuwiki_enabled: True - -mediawiki_install: True -mediawiki_enabled: True - -elgg_install: True -elgg_enabled: True - -ejabberd_install: True -ejabberd_enabled: False - -nextcloud_install: True -nextcloud_enabled: True - -wordpress_install: True -wordpress_enabled: True - -# 7-EDU-APPS - -kalite_install: True -kalite_enabled: True -# Unused in 2018; but remains as placeholder for Fedora 18 legacy (XO laptops) -kalite_cron_enabled: True - -kolibri_install: True -kolibri_enabled: True - -kiwix_install: True -kiwix_enabled: True - -# Warning: Moodle is a serious LMS, that takes a while to install -moodle_install: True -moodle_enabled: True - -# OpenStreetMap: renamed from {iiab_install, iiab_enabled} in June 2017 -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 - -# 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 - -# Unmaintained -# schooltool_install: False -# schooltool_enabled: False - -# Unmaintained -# debian_schooltool_install: False -# debian_schooltool_enabled: False From b9f9e3a2fbce0ffd36324a4fe980c4bada44f842 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:08:15 -0400 Subject: [PATCH 44/71] Update main.yml --- roles/transmission/defaults/main.yml | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index 92cdfa17c..bec0f8c45 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -18,7 +18,8 @@ transmission_peer_port: 51413 # Provision Transmission with torrent(s) from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ transmission_provision: True transmission_kalite_version: 0.17 -# Uncomment to enable a language to download: + +# A. Uncomment language(s) in /etc/iiab/local_vars.yml to download KA Lite videos to /library/transmission transmission_kalite_languages: - english #- french @@ -27,6 +28,10 @@ transmission_kalite_languages: #- brazilian-portuguese #- spanish #- swahili +# B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme +# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) +# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO # Transmission administrative account transmission_username: Admin From 82e46f91a606f750e44b2fd113f1a040a07eefcc Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:23:20 -0400 Subject: [PATCH 45/71] Update main.yml --- roles/transmission/defaults/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index bec0f8c45..fc6c9c83a 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -10,7 +10,7 @@ transmission_download_dir: "{{ content_base }}/transmission/" # /library/tran transmission_user: debian-transmission transmission_group: root -# Transmission web interface http://box:9091/transmission/ and BitTorrent port +# Monitor downloads at http://box:9091 or http://box:9091/transmission using Admin/changeme transmission_http_port: 9091 transmission_url : "/transmission/" transmission_peer_port: 51413 From ca4090bd12809937f5a99a86524e37fefe9250bc Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:23:26 -0400 Subject: [PATCH 46/71] Update default_vars.yml --- vars/default_vars.yml | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/vars/default_vars.yml b/vars/default_vars.yml index 013cfd303..368ad9e22 100644 --- a/vars/default_vars.yml +++ b/vars/default_vars.yml @@ -365,11 +365,21 @@ sugarizer_port: 8089 transmission_install: False transmission_enabled: False -# Monitor downloads at http://box:9091 using Admin/changeme +# Transmission download directory & general owner/group +transmission_download_dir: "{{ content_base }}/transmission/" # /library/transmission/ +transmission_user: debian-transmission +transmission_group: root + +# Monitor downloads at http://box:9091 or http://box:9091/transmission using Admin/changeme transmission_http_port: 9091 +transmission_url : "/transmission/" transmission_peer_port: 51413 -# Uncomment language(s) to download their KA Lite content into /library/transmission +# Provision Transmission with torrent(s) from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ +transmission_provision: True +transmission_kalite_version: 0.17 + +# A. Uncomment language(s) in /etc/iiab/local_vars.yml to download KA Lite videos to /library/transmission transmission_kalite_languages: - english #- french @@ -378,6 +388,14 @@ transmission_kalite_languages: #- brazilian-portuguese #- spanish #- swahili +# B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme +# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) +# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO + +# Transmission administrative account +transmission_username: Admin +transmission_password: changeme # AWStats - summarizes http access logs awstats_install: True From adbaa51d0747ab35fe586cd05df0c0f84875dd1d Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:23:30 -0400 Subject: [PATCH 47/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index cc872aecc..86ae3428b 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -208,6 +208,7 @@ 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: - english #- french From 65782ffac83decdb5da26c1c81c47832b2cfdcd7 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:23:35 -0400 Subject: [PATCH 48/71] Update local_vars_medium.yml --- vars/local_vars_medium.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_medium.yml b/vars/local_vars_medium.yml index 551d2ccc2..a10e2e45e 100644 --- a/vars/local_vars_medium.yml +++ b/vars/local_vars_medium.yml @@ -208,6 +208,7 @@ 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: - english #- french From 3305e55abfa52d94cca68011afa533bab854f592 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:23:38 -0400 Subject: [PATCH 49/71] Update local_vars_big.yml --- vars/local_vars_big.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_big.yml b/vars/local_vars_big.yml index 841fa979b..4f4664fbd 100644 --- a/vars/local_vars_big.yml +++ b/vars/local_vars_big.yml @@ -208,6 +208,7 @@ 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: - english #- french From e3329b4fd2cd81df864be7f9a8c35b535b53cd5c Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:34:43 -0400 Subject: [PATCH 50/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index 86ae3428b..bd8429d67 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -133,8 +133,8 @@ iiab_usb_lib_show_all: True # 6-GENERIC-APPS -# WARNING: CALIBRE REQUIRES X WINDOWS / OPENGL LIBRARIES. Consider installing -# an OS that includes a GUI (desktop) environment if you need Calibre E-Books. +# 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 @@ -149,8 +149,13 @@ calibre_port: 8080 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 From 12437434c51aea2f63f027e05bf4a783866a69a0 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:34:49 -0400 Subject: [PATCH 51/71] Update local_vars_medium.yml --- vars/local_vars_medium.yml | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/vars/local_vars_medium.yml b/vars/local_vars_medium.yml index a10e2e45e..8dedfe967 100644 --- a/vars/local_vars_medium.yml +++ b/vars/local_vars_medium.yml @@ -133,8 +133,8 @@ iiab_usb_lib_show_all: True # 6-GENERIC-APPS -# WARNING: CALIBRE REQUIRES X WINDOWS / OPENGL LIBRARIES. Consider installing -# an OS that includes a GUI (desktop) environment if you need Calibre E-Books. +# 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 @@ -149,8 +149,13 @@ calibre_port: 8080 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 From c73e097196e7b62e32274d816b449c6f2286a477 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:34:56 -0400 Subject: [PATCH 52/71] Update local_vars_big.yml --- vars/local_vars_big.yml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/vars/local_vars_big.yml b/vars/local_vars_big.yml index 4f4664fbd..778a7a430 100644 --- a/vars/local_vars_big.yml +++ b/vars/local_vars_big.yml @@ -133,8 +133,8 @@ iiab_usb_lib_show_all: True # 6-GENERIC-APPS -# WARNING: CALIBRE REQUIRES X WINDOWS / OPENGL LIBRARIES. Consider installing -# an OS that includes a GUI (desktop) environment if you need Calibre E-Books. +# 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 @@ -149,9 +149,13 @@ calibre_port: 8080 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 From b0e0eae6539fa837b640e20764186a4fff928533 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:36:31 -0400 Subject: [PATCH 53/71] Update local_vars_big.yml --- vars/local_vars_big.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_big.yml b/vars/local_vars_big.yml index 778a7a430..bc485de9d 100644 --- a/vars/local_vars_big.yml +++ b/vars/local_vars_big.yml @@ -156,6 +156,7 @@ 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 From fa81796efadbed58feb88ad896f47999419eb7d1 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:39:58 -0400 Subject: [PATCH 54/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index bd8429d67..6addb5a18 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -133,6 +133,7 @@ iiab_usb_lib_show_all: True # 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. From f04bff43135f633fd675c4c10ad8383eb18581a4 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:40:16 -0400 Subject: [PATCH 55/71] Update local_vars_medium.yml --- vars/local_vars_medium.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_medium.yml b/vars/local_vars_medium.yml index 8dedfe967..f7a7d77cb 100644 --- a/vars/local_vars_medium.yml +++ b/vars/local_vars_medium.yml @@ -133,6 +133,7 @@ iiab_usb_lib_show_all: True # 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. From 7c2ed2573e088cb67fe2b92d89d244aa27b54246 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:40:18 -0400 Subject: [PATCH 56/71] Update local_vars_big.yml --- vars/local_vars_big.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/vars/local_vars_big.yml b/vars/local_vars_big.yml index bc485de9d..15df85a56 100644 --- a/vars/local_vars_big.yml +++ b/vars/local_vars_big.yml @@ -133,6 +133,7 @@ iiab_usb_lib_show_all: True # 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. From 167ae23306f9680ccab502bede3e3d5391496c6b Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 22:53:45 -0400 Subject: [PATCH 57/71] Update main.yml --- roles/transmission/tasks/main.yml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/roles/transmission/tasks/main.yml b/roles/transmission/tasks/main.yml index c179317e6..6bb907551 100644 --- a/roles/transmission/tasks/main.yml +++ b/roles/transmission/tasks/main.yml @@ -37,7 +37,10 @@ when: transmission_enabled - name: Add KA Lite torrent(s) to transmission-daemon's queue - shell: /usr/bin/transmission-remote -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ item }}.torrent + shell: > + /usr/bin/transmission-remote + -n {{ transmission_username }}:{{ transmission_password }} + -a http://pantry.learningequality.org/downloads/ka-lite/{{ transmission_kalite_version }}/content/ka-lite-0.17-resized-videos-{{ item }}.torrent with_items: "{{ transmission_kalite_languages }}" ignore_errors: yes when: transmission_provision From c7570156247c4477fae10557bcc3c8bd25b59ea4 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 23:12:42 -0400 Subject: [PATCH 58/71] Update README.rst --- roles/transmission/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index f830a138b..2c4fb3d6e 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -6,7 +6,7 @@ Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon Transmission is intended to download KA Lite content to IIAB, from places like http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ — and also to seed content, assisting others. -Once the packages are downloaded, please verify the content before copying it (carefully!) into KA Lite content directory: ``/library/ka-lite/content`` +For example, once KA Lite videos and thumbnails are confirmed downloaded, copy them (carefully!) from ``/library/transmission`` into ``/library/ka-lite/content`` as outlined by "KA Lite Administration: What tips & tricks exist?" at http://FAQ.IIAB.IO Caution ------- From 31db43f0657f95add91e412ab409fe6d96a6bd04 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 23:25:53 -0400 Subject: [PATCH 59/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index 6addb5a18..5db9b8e9c 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -224,7 +224,7 @@ transmission_kalite_languages: #- spanish #- swahili # B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme -# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) +# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE assessment, locale, srt !) # D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" # E. READ "KA Lite Administration: What tips & tricks exist?" AT http://FAQ.IIAB.IO From 70ef4b58985480d479ede2c4b8fed40057969278 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 23:40:48 -0400 Subject: [PATCH 60/71] Update main.yml --- roles/transmission/defaults/main.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index fc6c9c83a..9e964accf 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -29,8 +29,11 @@ transmission_kalite_languages: #- spanish #- swahili # B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme -# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) -# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# until the download is confirmed complete (can take hours or days!) +# C. Carefully move all videos/thumbnails into /library/ka-lite/content +# (DO NOT OVERWRITE SUBFOLDERS assessment, locale, srt !) +# D. Log in to KA Lite at http://box:8008/updates/videos/ using Admin/changeme +# 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 # Transmission administrative account From 9863313489dff3b7f799c4f7386f446b4f6b033e Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 23:40:53 -0400 Subject: [PATCH 61/71] Update default_vars.yml --- vars/default_vars.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/vars/default_vars.yml b/vars/default_vars.yml index 368ad9e22..e2d00699c 100644 --- a/vars/default_vars.yml +++ b/vars/default_vars.yml @@ -389,8 +389,11 @@ transmission_kalite_languages: #- spanish #- swahili # B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme -# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) -# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# until the download is confirmed complete (can take hours or days!) +# C. Carefully move all videos/thumbnails into /library/ka-lite/content +# (DO NOT OVERWRITE SUBFOLDERS assessment, locale, srt !) +# D. Log in to KA Lite at http://box:8008/updates/videos/ using Admin/changeme +# 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 # Transmission administrative account From d9563830ee27e0fbb3c9337ec1206ff68a0b2eda Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 23:40:58 -0400 Subject: [PATCH 62/71] Update local_vars_min.yml --- vars/local_vars_min.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/vars/local_vars_min.yml b/vars/local_vars_min.yml index 5db9b8e9c..2ba4bdbc0 100644 --- a/vars/local_vars_min.yml +++ b/vars/local_vars_min.yml @@ -224,8 +224,11 @@ transmission_kalite_languages: #- spanish #- swahili # B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme -# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE assessment, locale, srt !) -# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# until the download is confirmed complete (can take hours or days!) +# C. Carefully move all videos/thumbnails into /library/ka-lite/content +# (DO NOT OVERWRITE SUBFOLDERS assessment, locale, srt !) +# D. Log in to KA Lite at http://box:8008/updates/videos/ using Admin/changeme +# 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 From 0d4f0f54192d172a926bf3280342e9fd41549586 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 23:41:02 -0400 Subject: [PATCH 63/71] Update local_vars_medium.yml --- vars/local_vars_medium.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/vars/local_vars_medium.yml b/vars/local_vars_medium.yml index f7a7d77cb..db8d3e62f 100644 --- a/vars/local_vars_medium.yml +++ b/vars/local_vars_medium.yml @@ -224,8 +224,11 @@ transmission_kalite_languages: #- spanish #- swahili # B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme -# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) -# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# until the download is confirmed complete (can take hours or days!) +# C. Carefully move all videos/thumbnails into /library/ka-lite/content +# (DO NOT OVERWRITE SUBFOLDERS assessment, locale, srt !) +# D. Log in to KA Lite at http://box:8008/updates/videos/ using Admin/changeme +# 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 From 78109a5bba7e4ffecd3d29880d9bcc04054f589a Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Tue, 28 Aug 2018 23:41:07 -0400 Subject: [PATCH 64/71] Update local_vars_big.yml --- vars/local_vars_big.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/vars/local_vars_big.yml b/vars/local_vars_big.yml index 15df85a56..cc755ef22 100644 --- a/vars/local_vars_big.yml +++ b/vars/local_vars_big.yml @@ -224,8 +224,11 @@ transmission_kalite_languages: #- spanish #- swahili # B. Monitor BitTorrent downloads at http://box:9091 using Admin/changeme -# C. Move videos/thumbnails into /library/ka-lite/content (DO NOT OVERWRITE overwrite assessment, locale, srt!) -# D. Log in to http://box:8008/updates/videos/ using Admin/changeme -> click "Scan content folder for videos" +# until the download is confirmed complete (can take hours or days!) +# C. Carefully move all videos/thumbnails into /library/ka-lite/content +# (DO NOT OVERWRITE SUBFOLDERS assessment, locale, srt !) +# D. Log in to KA Lite at http://box:8008/updates/videos/ using Admin/changeme +# 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 From 0d7fa626a4d6f0be048b17f9aaf545f2f9ee9f7b Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Wed, 29 Aug 2018 00:21:08 -0400 Subject: [PATCH 65/71] Update README.rst --- roles/transmission/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 2c4fb3d6e..d20e89282 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -2,7 +2,7 @@ Transmission README =================== -Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All these incarnations feature a very simple and intuitive interface, on top on an efficient, cross-platform backend. +Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All these incarnations feature a very simple and intuitive interface, on top on an efficient, cross-platform backend: https://transmissionbt.com Transmission is intended to download KA Lite content to IIAB, from places like http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ — and also to seed content, assisting others. From 3832a98f7f36733dedd21a1fa5ce7adcb3a7b44f Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Wed, 29 Aug 2018 00:47:03 -0400 Subject: [PATCH 66/71] Update README.rst --- roles/transmission/README.rst | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index d20e89282..df3a52150 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -4,7 +4,7 @@ Transmission README Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All these incarnations feature a very simple and intuitive interface, on top on an efficient, cross-platform backend: https://transmissionbt.com -Transmission is intended to download KA Lite content to IIAB, from places like http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ — and also to seed content, assisting others. +Transmission is intended to download KA Lite content to Internet-in-a-Box (IIAB) from places like http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ — and also to seed content, assisting others. For example, once KA Lite videos and thumbnails are confirmed downloaded, copy them (carefully!) from ``/library/transmission`` into ``/library/ka-lite/content`` as outlined by "KA Lite Administration: What tips & tricks exist?" at http://FAQ.IIAB.IO @@ -17,6 +17,16 @@ 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:: + + cd /opt/iiab/iiab + ./runrole transmission + +Or if you prefer a complete reinstall of IIAB:: + + cd /opt/iiab/iiab + ./iiab-install --reinstall + Login to Transmission's web interface http://box:9091 using administrative account:: Username: Admin @@ -29,7 +39,7 @@ Configuration Configure Transmission using its web interface: http://box:9091 -More settings can be edited within '/etc/transmission-daemon/settings.json' if you first ensure that the transmission-daemon.service is stopped:: +More settings can be changed within '/etc/transmission-daemon/settings.json' if you first ensure that the transmission-daemon.service is stopped:: systemctl stop transmission-daemon @@ -39,10 +49,16 @@ Then edit the file:: Here are some short explanations, as to what those 70+ variables mean: https://github.com/transmission/transmission/wiki/Editing-Configuration-Files -Adding torrents +After saving your changes in settings.json, restart Transmission by running:: + + systemctl restart transmission-daemon + +Adding Torrents --------------- -Transmission can facilitate provisioning content onto your IIAB, e.g. by adding KA Lite content from places like: http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ +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. You can also download other torrents using Transmission's web interface, or by typing 'transmission-remote' at the command-line:: @@ -62,6 +78,6 @@ Verify that transmission-daemon is running:: systemctl status transmission-daemon -Re-check that Transmission's settings are correct in:: +Re-check that Transmission's settings are correct, while following the instructions above, under 'Configuration':: /etc/transmission-daemon/settings.json From 33b18b1687be7729ecbf50dd591c5c7631d179bb Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Wed, 29 Aug 2018 01:01:24 -0400 Subject: [PATCH 67/71] Update README.rst --- roles/transmission/README.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index df3a52150..6e45c5d37 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -21,6 +21,7 @@ Install Transmission by setting 'transmission_install' and 'transmission_enabled cd /opt/iiab/iiab ./runrole transmission + ./iiab-network Or if you prefer a complete reinstall of IIAB:: From 70054c3cc8de9e2b56f409cbae2daaaf187c1365 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Wed, 29 Aug 2018 01:03:56 -0400 Subject: [PATCH 68/71] Update README.rst --- roles/transmission/README.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 6e45c5d37..62a449979 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -40,7 +40,7 @@ Configuration Configure Transmission using its web interface: http://box:9091 -More settings can be changed within '/etc/transmission-daemon/settings.json' if you first ensure that the transmission-daemon.service is stopped:: +More settings can be changed within /etc/transmission-daemon/settings.json if you first ensure that the transmission-daemon.service is stopped:: systemctl stop transmission-daemon @@ -50,7 +50,7 @@ Then edit the file:: Here are some short explanations, as to what those 70+ variables mean: https://github.com/transmission/transmission/wiki/Editing-Configuration-Files -After saving your changes in settings.json, restart Transmission by running:: +After saving your changes in 'settings.json' restart Transmission by running:: systemctl restart transmission-daemon @@ -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 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:: From 3ad3f1d563250e0e5f78a2768808361186e53f95 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Wed, 29 Aug 2018 01:11:18 -0400 Subject: [PATCH 69/71] Update README.rst --- roles/transmission/README.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index 62a449979..5f751a667 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -79,6 +79,8 @@ Verify that transmission-daemon is running:: systemctl status transmission-daemon -Re-check that Transmission's settings are correct, while following the instructions above, under 'Configuration':: +Re-check that Transmission's settings are correct here: (by following the instructions above, under 'Configuration') + +:: /etc/transmission-daemon/settings.json From d7f735f4766de0331f19ba959751b5643ce424d3 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Wed, 29 Aug 2018 01:31:25 -0400 Subject: [PATCH 70/71] Update main.yml --- roles/8-mgmt-tools/tasks/main.yml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/roles/8-mgmt-tools/tasks/main.yml b/roles/8-mgmt-tools/tasks/main.yml index 4668be835..3f2ba79ec 100644 --- a/roles/8-mgmt-tools/tasks/main.yml +++ b/roles/8-mgmt-tools/tasks/main.yml @@ -1,8 +1,14 @@ -# Assessment and Monitoring Tools +# Administration and Monitoring Tools - name: ...IS BEGINNING ====================================== command: echo +- name: TRANSMISSION + include_role: + name: transmission + when: transmission_install + tags: transmission + - name: AWSTATS include_role: name: awstats From b652dbe7ab25a86f31151f0da7c22e37fd870e38 Mon Sep 17 00:00:00 2001 From: A Holt <holta@users.noreply.github.com> Date: Wed, 29 Aug 2018 02:56:45 -0400 Subject: [PATCH 71/71] Update main.yml --- roles/8-mgmt-tools/tasks/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/8-mgmt-tools/tasks/main.yml b/roles/8-mgmt-tools/tasks/main.yml index 3f2ba79ec..b94404814 100644 --- a/roles/8-mgmt-tools/tasks/main.yml +++ b/roles/8-mgmt-tools/tasks/main.yml @@ -1,4 +1,4 @@ -# Administration and Monitoring Tools +# Administration and Monitoring/Assessment Tools - name: ...IS BEGINNING ====================================== command: echo