1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-14 20:22:08 +00:00
iiab/roles/transmission/README.rst

68 lines
2.7 KiB
ReStructuredText
Raw Normal View History

===================
2018-08-16 09:36:45 +00:00
Transmission README
===================
2018-08-16 09:36:45 +00:00
2018-08-28 21:42:10 +00:00
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.
2018-08-28 21:42:10 +00:00
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.
2018-08-28 21:42:10 +00:00
Once the packages are downloaded, please verify the content before copying it (carefully!) into 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")
2018-08-16 09:36:45 +00:00
2018-08-28 21:42:10 +00:00
Using It
--------
2018-08-16 09:36:45 +00:00
2018-08-28 21:42:10 +00:00
Login to Transmission's web interface http://box:9091 using administrative account::
2018-08-16 09:36:45 +00:00
2018-08-28 21:42:10 +00:00
Username: Admin
Password: changeme
2018-08-16 09:36:45 +00:00
2018-08-28 21:42:10 +00:00
Alternatively, you can run ``transmission-remote`` at the command-line.
Configuration
-------------
2018-08-28 21:42:10 +00:00
Configure Transmission using its web interface: http://box:9091
2018-08-28 23:39:30 +00:00
More settings can be edited within '/etc/transmission-daemon/settings.json' if you first ensure that the transmission-daemon.service is stopped::
2018-08-28 21:42:10 +00:00
systemctl stop transmission-daemon
2018-08-28 23:39:30 +00:00
Then edit the file::
2018-08-28 21:42:10 +00:00
nano /etc/transmission-daemon/settings.json
2018-08-28 23:39:30 +00:00
Here are some short explanations, as to what those 70+ variables mean: https://github.com/transmission/transmission/wiki/Editing-Configuration-Files
2018-08-18 04:32:45 +00:00
Adding torrents
---------------
2018-08-28 21:42:10 +00:00
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/
2018-08-28 21:42:10 +00:00
You can also download other torrents using Transmission's web interface, or by typing 'transmission-remote' at the command-line::
2018-08-16 09:36:45 +00:00
2018-08-28 21:42:10 +00:00
transmission-remote -a <path_to_the.torrent>
2018-08-16 09:36:45 +00:00
Known Issues
------------
2018-08-28 22:16:46 +00:00
* 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').
2018-08-16 09:36:45 +00:00
* 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.
2018-08-16 09:36:45 +00:00
2018-08-18 04:32:45 +00:00
Troubleshooting
---------------
2018-08-28 21:42:10 +00:00
Verify that transmission-daemon is running::
systemctl status transmission-daemon
2018-08-28 23:39:30 +00:00
Re-check that Transmission's settings are correct in::
2018-08-28 21:42:10 +00:00
/etc/transmission-daemon/settings.json