external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-15 04:32:11 +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 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 Caution
------- -------
@ -14,49 +14,49 @@ Caution
Usage of Transmission consumes significant Internet data and system resources. Usage of Transmission consumes significant Internet data and system resources.
Caveat emptor! (That's Latin for "Buyer Beware") 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 Username: Admin
Password: changeme Password: changeme
Alternatively, you can type 'transmission-remote' at the command-line. Alternatively, you can run ``transmission-remote`` at the command-line.
Configuration 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 You can also edit Transmission settings in '/etc/transmission-daemon/settings.json'. Before you edit this file, ensure that transmission-daemon.service is stopped::
'settings.json' file, please ensure that transmission-daemon.service is stopped:
$ sudo systemctl stop transmission-daemon.service systemctl stop transmission-daemon
nano /etc/transmission-daemon/settings.json
$ sudo nano /etc/transmission-daemon/settings.json
Adding torrents 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 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. * 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 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