[2012.05.14] How To Install Transmissin BT Client

夢

If we want to use the transmission, we must pre install some software.Like below command.
I suggest the people can install the rtorrent+rutorrent first, if  the transmission can't work fine, there are no cross-reference to let reader debug issue.

1. sudo apt-get install build-essential automake autoconf libtool pkg-config intltool libcurl4-openssl-dev libglib2.0-dev libevent-dev libminiupnpc-dev libminiupnpc5 libappindicator-dev

Copy the Code

Then, we must download the transmission source code.

1. http://www.transmissionbt.com/download/

Copy the Code

For example, we will install Transmission version 2.51

1. wget http://download.transmissionbt.com/files/transmission-2.51.tar.bz2
   
2. tar xvjf transmission-2.51.tar.bz2

Copy the Code

Then,we download and install the new version of libevent and intltool.

1. wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz
   
2. cd libevent-2.0.16-stable
   
3. ./configure&&make&&sudo make install
   
4. sudo apt-get install intltool
   
5. (The command can check the packet of intltool packet : sudo apt-cache show intltool)

Copy the Code

Then, we can complete to install transmission

1. ./configure -q && make -s
   
2. sudo make install

Copy the Code

After we install the transmission, we need to create the environment to let transmission work fine.

1. mkdir tm tm-temp tm-torrents
   
2. sudo ldconfig
   
3. transmission-daemon -f
   
4. ctrl^c

Copy the Code

People can refer the rtorrent installing tutorial to know why we create the folders - tm & tm-temp & tm-torrents.
Then we need write the script to control transmission state when we execute the transmission and restart the system.
First, we write the initial script can let transmission auto execute when we start the ubuntu system.

1. sudo vi /etc/init.d/transmission-daemon

Copy the Code

1. #! /bin/sh
   
2. ### BEGIN INIT INFO
   
3. # Provides:          transmission-daemon
   
4. # Required-Start:    networking
   
5. # Required-Stop:     networking
   
6. # Default-Start:     2 3 5
   
7. # Default-Stop:      0 1 6
   
8. # Short-Description: Start the transmission BitTorrent daemon client.
   
9. ### END INIT INFO
   
10. 
    
11. # Original Author: Lennart A. JÃŒtte, based on Rob Howell's script
    
12. # Modified by Maarten Van Coile & others (on IRC)
    
13. 
    
14. # Do NOT "set -e"
    
15. 
    
16. #
    
17. # ----- CONFIGURATION -----
    
18. #
    
19. # For the default location Transmission uses, visit:
    
20. # http://trac.transmissionbt.com/wiki/ConfigFiles
    
21. # For a guide on how set the preferences, visit:
    
22. # http://trac.transmissionbt.com/wiki/EditConfigFiles
    
23. # For the available environement variables, visit:
    
24. # http://trac.transmissionbt.com/wiki/EnvironmentVariables
    
25. #
    
26. # The name of the user that should run Transmission.
    
27. # It's RECOMENDED to run Transmission in it's own user,
    
28. # by default, this is set to 'transmission'.
    
29. # For the sake of security you shouldn't set a password
    
30. # on this user
    
31. USERNAME=*
    
32. 
    
33. 
    
34. # ----- *ADVANCED* CONFIGURATION -----
    
35. # Only change these options if you know what you are doing!
    
36. #
    
37. # The folder where Transmission stores the config & web files.
    
38. # ONLY change this you have it at a non-default location
    
39. #TRANSMISSION_HOME="/var/config/transmission-daemon"
    
40. #TRANSMISSION_WEB_HOME="/usr/share/transmission/web"
    
41. #
    
42. # The arguments passed on to transmission-daemon.
    
43. # ONLY change this you need to, otherwise use the
    
44. # settings file as per above.
    
45. #TRANSMISSION_ARGS=""
    
46. 
    
47. 
    
48. # ----- END OF CONFIGURATION -----
    
49. #
    
50. # PATH should only include /usr/* if it runs after the mountnfs.sh script.
    
51. PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    
52. DESC="bittorrent client"
    
53. NAME=transmission-daemon
    
54. DAEMON=$(which $NAME)
    
55. PIDFILE=/var/run/$NAME.pid
    
56. SCRIPTNAME=/etc/init.d/$NAME
    
57. 
    
58. # Exit if the package is not installed
    
59. [ -x "$DAEMON" ] || exit 0
    
60. 
    
61. # Read configuration variable file if it is present
    
62. [ -r /etc/default/$NAME ] && . /etc/default/$NAME
    
63. 
    
64. # Load the VERBOSE setting and other rcS variables
    
65. [ -f /etc/default/rcS ] && . /etc/default/rcS
    
66. 
    
67. #
    
68. # Function that starts the daemon/service
    
69. #
    
70. 
    
71. do_start()
    
72. {
    
73.     # Export the configuration/web directory, if set
    
74.     if [ -n "$TRANSMISSION_HOME" ]; then
    
75.           export TRANSMISSION_HOME
    
76.     fi
    
77.     if [ -n "$TRANSMISSION_WEB_HOME" ]; then
    
78.           export TRANSMISSION_WEB_HOME
    
79.     fi
    
80. 
    
81.     # Return
    
82.     #   0 if daemon has been started
    
83.     #   1 if daemon was already running
    
84.     #   2 if daemon could not be started
    
85.     start-stop-daemon --chuid $USERNAME --start --pidfile $PIDFILE --make-pidfile \
    
86.             --exec $DAEMON --background --test -- -f $TRANSMISSION_ARGS > /dev/null \
    
87.             || return 1
    
88.     start-stop-daemon --chuid $USERNAME --start --pidfile $PIDFILE --make-pidfile \
    
89.             --exec $DAEMON --background -- -f $TRANSMISSION_ARGS \
    
90.             || return 2
    
91. }
    
92. 
    
93. #
    
94. # Function that stops the daemon/service
    
95. #
    
96. do_stop()
    
97. {
    
98.         # Return
    
99.         #   0 if daemon has been stopped
    
100.         #   1 if daemon was already stopped
     
101.         #   2 if daemon could not be stopped
     
102.         #   other if a failure occurred
     
103.         
     
104.     start-stop-daemon --stop --quiet --retry=TERM/10/KILL/5 --pidfile $PIDFILE --exec $DAEMON
     
105.     RETVAL="$?"
     
106.         [ "$RETVAL" = 2 ] && return 2
     
107. 
     
108.         # Wait for children to finish too if this is a daemon that forks
     
109.         # and if the daemon is only ever run from this initscript.
     
110.         # If the above conditions are not satisfied then add some other code
     
111.         # that waits for the process to drop all resources that could be
     
112.         # needed by services started subsequently.  A last resort is to
     
113.         # sleep for some time.
     
114. 
     
115.         start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
     
116.         [ "$?" = 2 ] && return 2
     
117. 
     
118.         # Many daemons don't delete their pidfiles when they exit.
     
119.         rm -f $PIDFILE
     
120. 
     
121.         return "$RETVAL"
     
122. }
     
123. 
     
124. case "$1" in
     
125.   start)
     
126.         echo "Starting $DESC" "$NAME..."
     
127.         do_start
     
128.         case "$?" in
     
129.                 0|1) echo "   Starting $DESC $NAME succeeded" ;;
     
130.                 *)   echo "   Starting $DESC $NAME failed" ;;
     
131.         esac
     
132.         ;;
     
133.   stop)
     
134.         echo "Stopping $DESC $NAME..."
     
135.         do_stop
     
136.         case "$?" in
     
137.                 0|1) echo "   Stopping $DESC $NAME succeeded" ;;
     
138.                 *)   echo "   Stopping $DESC $NAME failed" ;;
     
139.         esac
     
140.         ;;
     
141.   restart|force-reload)
     
142.         #
     
143.         # If the "reload" option is implemented then remove the
     
144.         # 'force-reload' alias
     
145.         #
     
146.         echo "Restarting $DESC $NAME..."
     
147.         do_stop
     
148.         case "$?" in
     
149.           0|1)
     
150.                 do_start
     
151.                 case "$?" in
     
152.                     0|1) echo "   Restarting $DESC $NAME succeeded" ;;
     
153.                     *)   echo "   Restarting $DESC $NAME failed: couldn't start $NAME" ;;
     
154.                 esac
     
155.                 ;;
     
156.           *)
     
157.                 echo "   Restarting $DESC $NAME failed: couldn't stop $NAME" ;;
     
158.         esac
     
159.         ;;
     
160.   *)
     
161.         echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
     
162.         exit 3
     
163.         ;;
     
164. esac

Copy the Code

People must pay attenttion that the content of the script is different with the official provide, please use the script I provide.
And, people need change the content of * in line 31 to your real username, you can refer the home directory.

Second, we want to edit the configuration file.

1. vi ~/.config/transmission-daemon/settings.json

Copy the Code

1. {
   
2.     "alt-speed-down": 7000,
   
3.     "alt-speed-enabled": false,
   
4.     "alt-speed-time-begin": 540,
   
5.     "alt-speed-time-day": 217,
   
6.     "alt-speed-time-enabled": false,
   
7.     "alt-speed-time-end": 1020,
   
8.     "alt-speed-up": 15000,
   
9.     "bind-address-ipv4": "***",
   
10.     "bind-address-ipv6": "***",
    
11.     "blocklist-enabled": false,
    
12.     "blocklist-url": "http://www.example.com/blocklist",
    
13.     "cache-size-mb": 15,
    
14.     "dht-enabled": true,
    
15.     "download-dir": "/home/***/tm",
    
16.     "download-queue-enabled": true,
    
17.     "download-queue-size": 15,
    
18.     "encryption": 1,
    
19.     "idle-seeding-limit": 30,
    
20.     "idle-seeding-limit-enabled": false,
    
21.     "incomplete-dir": "/home/***/tm-temp",
    
22.     "incomplete-dir-enabled": true,
    
23.     "lazy-bitfield-enabled": true,
    
24.     "lpd-enabled": false,
    
25.     "message-level": 2,
    
26.     "peer-congestion-algorithm": "",
    
27.     "peer-limit-global": 1000,
    
28.     "peer-limit-per-torrent": 100,
    
29.     "peer-port": 35770,
    
30.     "peer-port-random-high": 42424,
    
31.     "peer-port-random-low": 4242,
    
32.     "peer-port-random-on-start": true,
    
33.     "peer-socket-tos": "default",
    
34.     "pex-enabled": true,
    
35.     "port-forwarding-enabled": true,
    
36.     "preallocation": 1,
    
37.     "prefetch-enabled": 1,
    
38.     "queue-stalled-enabled": true,
    
39.     "queue-stalled-minutes": 60,
    
40.     "ratio-limit": 10,
    
41.     "ratio-limit-enabled": false,
    
42.     "rename-partial-files": true,
    
43.     "rpc-authentication-required": true,
    
44.     "rpc-bind-address": "***",
    
45.     "rpc-enabled": true,
    
46.     "rpc-password": "***",
    
47.     "rpc-port": 4242,
    
48.     "rpc-url": "/***/",
    
49.     "rpc-username": "goddesschi",
    
50.     "rpc-whitelist": "***",
    
51.     "rpc-whitelist-enabled": false,
    
52.     "scrape-paused-torrents-enabled": true,
    
53.     "script-torrent-done-enabled": false,
    
54.     "script-torrent-done-filename": "",
    
55.     "seed-queue-enabled": true,
    
56.     "seed-queue-size": 15,
    
57.     "speed-limit-down": 7000,
    
58.     "speed-limit-down-enabled": true,
    
59.     "speed-limit-up": 15000,
    
60.     "speed-limit-up-enabled": false,
    
61.     "start-added-torrents": true,
    
62.     "trash-original-torrent-files": false,
    
63.     "umask": 22,
    
64.     "upload-slots-per-torrent": 5,
    
65.     "utp-enabled": true,
    
66.     "watch-dir": "/home/***/tm-torrents",
    
67.     "watch-dir-enabled": true
    
68. }

Copy the Code

About the above script, search *** and change the content to fit your environment or your like.
People can refer the official website to get explaination of the parameter.

BTW, when people change password can reload the setting by this caomand.

1. pkill -HUP transmission-da

Copy the Code

Then, we execute the command and we can use thetransmission

1. transmission-daemon

Copy the Code

or

1. sudo /etc/init.d/transmission-daemon restart

Copy the Code

if you want to see the web ui, put the internet site in your web browser and enter.
See your script setting to get informationrpc-bind-address、rpc-port and rpc-url.

1. http://rpc-bind-address:rpc-port/rpc-url

Copy the Code

Final, if you want to upgrade the transmission,  I suggest you remove the old transmission and install new version source code again.
For example, I remove the 2.42 version and install the 2.5 version

1. cd transmission-2.42
   
2. sudo make uninstall
   
3. sudo make clean
   
4. cd ..
   
5. wget http://download.transmissionbt.com/files/transmission-2.51.tar.bz2
   
6. tar xvjf transmission-2.51.tar.bz2
   
7. cd transmission-2.51
   
8. ./configure -q && make -s
   
9. sudo make install
   
10. transmission-daemon

Copy the Code

So,  after you install the software finished, remember don't remove the complier source code.
When you wnat to upgrade the transmission and you want make uninstall, you need to use the source code.