Transmission

Languages:

English

Transmission for SME Server

	Skill level: Medium
	The instructions on this page require a basic knowledge of linux.

Maintainer

Stéphane de Labrusse AKA Stephdl

Description

This contribution for SME Server adds the ability to seed or to download SME Server CDROM ISO trough the Bit-torrent protocol.

Requirements

You need to activate two repositories, geekery which hosts Transmission binaries and stephdl.

Installation

This contrib is currently held in several repository, so the following commands will install on your smeserver.

yum --enablerepo=geekery,stephdl install smeserver-transmission

You will then need to activate the database changes etc. The 'official' way is to perform

signal-event post-upgrade;  signal-event reboot

or if you do NOT want to reboot your server

signal-event conf-transmission

Login to transmission

The url to reach the transmission is https://sme-ip-or-host/transmission

Just after the installation, only the admin user is allowed to perform a login with its SME Server credentials.

	Note:
	All users or groups need to be real users or groups in the server-manager with a password set

Add users

If you want to allow more users to transmission

config setprop transmission Transuser "admin user1 user2"
signal-event conf-transmission

All users need to be real users in the server-manager with a password set

Add groups

If you want to allow more groups to transmission

config setprop transmission Transgroup "group1 group2 group3"
signal-event conf-transmission

All groups need to be real groups in the server-manager with a password set

change the default url

By default transmission is reachable at https://sme-ip-or-host/transmission but if you want to change this

config setprop transmission Name XXXXX
signal-event conf-transmission

then you need to go to https://sme-ip-or-host/XXXXX

Disable the access (web/samba) to Transmission

If you want to close all your users access to the transmission contrib by web or by samba you can perform this. But this do not stop the transmission daemon

config setprop transmission status enabled
signal-event conf-transmission

Browse your download

You can browse all your downloads either by samba, or by your browser (by default only on your local network)

By samba

only the admin is allowed to browse your download with samba, if you want to add more users or groups

config setprop transmission Smbusers "admin user1 user2 @group1 @group2"
signal-event conf-transmission

In the smb.conf a group is called by "@", do not forget to add it if you want to allow group1 : @group1

Then you can browse all samba shares of your server, find the transmission share and perform a login with your credentials.

By your web browser

It is a nice feature if you can exchange downloads with your friends outside of your network, of course this could be forbidden in certain countries.

	Note:
	By default the web access to transmission downloads is only allowed on your local network.

go to https://sme-ip-host/dl-transmission

Access global-local-none

By default only IPs which are on your local network are allowed to reach the transmission download folder with a web browser, but this behaviour can be changed.

Only IPs of your local network

config setprop transmission Webdlaccess local

or All IPs

config setprop transmission Webdlaccess global

or No access

config setprop transmission Webdlaccess none

After that

signal-event conf-transmission

Add users

If you want to allow more users to the download transmission folder

config setprop transmission Webuser "admin user1 user2"
signal-event conf-transmission

All users need to be real users in the server-manager with a password set

Add groups

If you want to allow more groups to transmission

config setprop transmission Webgroup "group1 group2 group3"
signal-event conf-transmission

All groups need to be real groups in the server-manager with a password set

change the default url

By default the download transmission folder is reachable at https://sme-ip-or-host/dl-transmission but if you want to change this

config setprop transmission Webdlurl XXXXX
signal-event conf-transmission

then you need to go to https://sme-ip-or-host/XXXXX

Uninstall

yum remove smeserver-transmission transmission* libevent2
 signal-event post-upgrade;  signal-event reboot

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-foo component or use this link .

remove the nowiki tags from your page

<noinclude>[[Category: Contrib]]</noinclude>