diff --git a/roles/transmission/README.rst b/roles/transmission/README.rst index e9e2952dd..cce77b949 100644 --- a/roles/transmission/README.rst +++ b/roles/transmission/README.rst @@ -28,30 +28,24 @@ 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 `_ — carefully choosing language(s) for KA Lite videos you want to download — and then run:: +Install Transmission by setting 'transmission_install' and 'transmission_enabled' to True in `/etc/iiab/local_vars.yml `_ — carefully choosing language(s) for KA Lite videos you want to download — and then install IIAB. Or, if IIAB is already installed, run as root:: cd /opt/iiab/iiab ./runrole transmission - ./iiab-network - -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:: +Log in to Transmission's web interface http://box:9091 using administrative account:: Username: Admin Password: changeme -Alternatively, you can run ``transmission-remote`` at the command-line. +If you prefer the command-line, you can instead run `transmission-remote `_ commands. 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 @@ -59,9 +53,9 @@ 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 +Here are some short explanations, as to what those ~68 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 @@ -72,16 +66,16 @@ Transmission can facilitate provisioning content onto your IIAB, e.g. by adding 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:: +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 -n Admin:changeme -a Known Issues ------------ * |ss| Default Transmission user/group may need fixing (https://github.com/transmission/transmission/issues/537) in some circumstances. You can set Ansible variables 'transmission_user' and 'transmission_group' e.g. in /opt/iiab/iiab/roles/transmission/defaults/main.yml (you might need 'User=' and 'Group=' in systemd unit file /lib/systemd/system/transmission-daemon.service — e.g. both might need to be set to 'debian-transmission' — if so then run 'systemctl daemon-reload' and 'systemctl restart transmission-daemon'). |se| |nbsp| `PR #2703 `_ -* 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. +* 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 --------------- @@ -95,3 +89,14 @@ Re-check that Transmission's settings are correct here: (by following the instru :: /etc/transmission-daemon/settings.json + +More advanced configuration and status are in directory ``/var/lib/transmission-daemon/info/`` here:: + + blocklists/ + dht.dat + resume/ + settings.json -> /etc/transmission-daemon/settings.json + stats.json + torrents/ + +These are further explained in https://github.com/transmission/transmission/wiki/Configuration-Files (to correspond with the above path, apt package transmission-daemon sets user debian-transmission's home directory to /var/lib/transmission-daemon in /etc/passwd). diff --git a/roles/transmission/defaults/main.yml b/roles/transmission/defaults/main.yml index ae49da71b..70f155c63 100644 --- a/roles/transmission/defaults/main.yml +++ b/roles/transmission/defaults/main.yml @@ -12,6 +12,8 @@ # Monitor downloads at http://box:9091 or http://box:9091/transmission using Admin/changeme # transmission_http_port: 9091 # transmission_url: /transmission/ +# transmission_whitelist: 127.0.0.1,192.168.*.*,172.18.96.*,10.8.0.* +# transmission_whitelist_enabled: false # Use lowercase # transmission_peer_port: 51413 # Provision Transmission with torrent(s) from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/ diff --git a/roles/transmission/tasks/enable-or-disable.yml b/roles/transmission/tasks/enable-or-disable.yml index 16bb091de..8804c5b17 100644 --- a/roles/transmission/tasks/enable-or-disable.yml +++ b/roles/transmission/tasks/enable-or-disable.yml @@ -6,6 +6,9 @@ state: restarted when: transmission_enabled +- debug: + var: transmission_kalite_languages + - name: Add PAUSED KA Lite torrent(s) to transmission-daemon's queue shell: > /usr/bin/transmission-remote diff --git a/roles/transmission/templates/settings.json.j2 b/roles/transmission/templates/settings.json.j2 index 8e62d0e6f..a88b478b5 100644 --- a/roles/transmission/templates/settings.json.j2 +++ b/roles/transmission/templates/settings.json.j2 @@ -13,34 +13,31 @@ "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": "/var/lib/transmission-daemon/downloads", "incomplete-dir-enabled": false, "lpd-enabled": false, - "max-peers-global": 200, - "message-level": 1, + "message-level": 2, "peer-congestion-algorithm": "", "peer-id-ttl-hours": 6, - "peer-limit-global": 200, - "peer-limit-per-torrent": 50, + "peer-limit-global": 240, + "peer-limit-per-torrent": 60, "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, + "port-forwarding-enabled": true, "preallocation": 1, "prefetch-enabled": true, "queue-stalled-enabled": true, "queue-stalled-minutes": 30, - "ratio-limit": 2, + "ratio-limit": 2.0, "ratio-limit-enabled": false, "rename-partial-files": true, "rpc-authentication-required": true, @@ -52,8 +49,8 @@ "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": false, + "rpc-whitelist": "{{ transmission_whitelist }}", + "rpc-whitelist-enabled": "{{ transmission_whitelist_enabled }}", "scrape-paused-torrents-enabled": true, "script-torrent-done-enabled": false, "script-torrent-done-filename": "", @@ -66,8 +63,8 @@ "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 + "utp-enabled": true, + "watch-dir": "", + "watch-dir-enabled": false } diff --git a/vars/default_vars.yml b/vars/default_vars.yml index b85cea197..25860b3e9 100644 --- a/vars/default_vars.yml +++ b/vars/default_vars.yml @@ -512,6 +512,8 @@ transmission_group: debian-transmission # Monitor downloads at http://box:9091 or http://box:9091/transmission using Admin/changeme transmission_http_port: 9091 transmission_url: /transmission/ +transmission_whitelist: 127.0.0.1,192.168.*.*,172.18.96.*,10.8.0.* +transmission_whitelist_enabled: false # Use lowercase transmission_peer_port: 51413 # Provision Transmission with torrent(s) from http://pantry.learningequality.org/downloads/ka-lite/0.17/content/