external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-14 20:22:08 +00:00
Code Issues Releases Wiki Activity

Update README.rst

Browse source
This commit is contained in:
A Holt 2018-08-28 17:42:10 -04:00 committed by GitHub
parent 11c2441059
commit 28827d8ded
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 22 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

44
roles/transmission/README.rst
View file

@ -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 <path_to_the.torrent>
transmission-remote -a <path_to_the.torrent>
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