external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00
Code Issues Releases Wiki Activity

Update roles/transmission/README.rst

Browse source
This commit is contained in:
A Holt 2021-03-13 19:41:17 -05:00 • committed by GitHub
parent 4496989846
commit 2f246e80ac
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

22
roles/transmission/README.rst
View file

@ -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 <http://wiki.laptop.org/go/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 <http://wiki.laptop.org/go/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 <https://linux.die.net/man/1/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 <https://github.com/holta/iiab/blob/transmission-settings/roles/transmission/templates/settings.json.j2>`_ if you first ensure that the transmission-daemon.service is stopped::
systemctl stop transmission-daemon
@ -61,7 +55,7 @@ Then edit the file::
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 <http://wiki.laptop.org/go/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 <https://linux.die.net/man/1/transmission-remote>`_ at the command-line::
transmission-remote -n Admin:changeme -a <path_to_the.torrent>
transmission-remote -n Admin:changeme -a <URL-or-local-path.torrent>
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 <https://github.com/iiab/iiab/pull/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 <https://github.com/iiab/iiab/wiki/IIAB-Networking#firewall-iptables>`_.
Troubleshooting
---------------