✎ clutch [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Clutch ======

**Clutch** est une interface Web pour le client BitTorrent [[Transmission]]. Elle permet de gérer vos torrents depuis n'importe quel poste connecté à Internet.

Clutch est écrit en PHP, HTML et Javascript (AJAX).

<note important>Depuis **[[intrepid|Ubuntu 8.10]]**, Clutch est intégré à [[Transmission]]: plus besoin d'installer Apache et autres, il suffit de l'activer à partir des préférences de [[Transmission]].  Voir [[transmission#web-ui_clutch|web ui clutch]]</note>

===== Pré-requis =====

* Il faut au préalable avoir installé un serveur web [[apache2|Apache]].
  * L'installation d'une solution [[LAMP]] est toute indiquée.

===== Installation =====

====Depuis les dépôts officiels====

[[:tutoriel:comment_installer_un_paquet|Installer le paquet]] **[[apt://clutch|clutch]].**

Clutch sera alors installé dans le répertoire « /usr/share/clutch/www ».

===== Utilisation =====

L'interface Clutch est visible à l'adresse [[http://localhost/clutch]].

===== Les problèmes =====

==== Problème : Connection Failed ====

En allant à l'adresse [[http://localhost/clutch]], un message dit :

> Connection Failed
> Could not connect to the server. You may need to reload the page to reconnect.

En cliquant sur Details, on obtient les avertissements suivants :

> Warning:  touch() [function.touch]: Unable to create file data/prefs.txt because Permission denied in /usr/share/clutch/www/remote/lib/Preferences.class.php on line 19
>
> Warning:  file_get_contents(data/prefs.txt) [function.file-get-contents]: failed to open stream: No such file or directory in /usr/share/clutch/www/remote/lib/Preferences.class.php on line 24
>
>Warning:  file_put_contents(data/prefs.txt) [function.file-put-contents]: failed to open stream: Permission denied in /usr/share/clutch/www/remote/lib/Preferences.class.php on line 37
>
>Warning:  Cannot modify header information - headers already sent by (output started at /usr/share/clutch/www/remote/lib/Preferences.class.php:19) in /usr/share/clutch/www/remote/index.php on line 227
> transmission.initializeSettings({"auto_start":1,"download_location":"\/var\/cache\/clutch\/downloads\/","port":51413,"encryption":"preferred","filter":"all","sort_method":"queue_order","sort_direction":"ascending","show_inspector":false,"show_filter":true,"limit_download":false,"limit_upload":false,"download_rate":10,"upload_rate":10,"refresh_rate":5});

==== Résolution ====

Il suffit de changer les [[droits|droits d'accès]] du répertoire **remote/data** et de son contenu (''-R'') afin que tous les utilisateurs y ait tous les droits (''777'') :

sudo chmod -R 777 /usr/share/clutch/www/remote/data

Il faut également [[:tutoriel:comment_editer_un_fichier|modifier le fichier]] **/etc/init.d/clutch** tel qu'indiqué ci-dessous.

* Repérez la ligne (ligne 201) : <code>

case "1" in 
start
</code>
  * Juste avant la ligne <code>;;</code>
  * Rajoutez : <code>chmod -R 777 /var/cache/clutch/daemon</code>
  * Vous obtenez ainsi :<code>
case "$1" in
  start)
	log_daemon_msg "Starting $DESC " "$NAME"
	
        # Check if it's running first
        if running ;  then
            log_progress_msg "apparently already running"
            log_end_msg 0
            exit 0
        fi
        if start_server && running ;  then
            # It's ok, the server started and is running
            log_end_msg 0
        else
            # Either we could not start it or it is not running
            # after we did
            # NOTE: Some servers might die some time after they start,
            # this code does not try to detect this and might give
            # a false positive (use 'status' for that)
            log_end_msg 1	
        fi
        chmod -R 777 /var/cache/clutch/daemon
	;;
</code>
  * Répétez la procédure pour l'instruction (ligne 246) :<code>restart|force-reload</code>
  * Vous obtenez alors : <code>
 restart|force-reload)
        log_daemon_msg "Restarting $DESC" "$NAME"
        stop_server
        start_server
        running
        log_end_msg $?
	chmod -R 777 /var/cache/clutch/daemon
	;;
</code>
  * Enfin redémarrez Clutch : <code>sudo /etc/init.d/clutch restart</code>

===== Sécurité =====

Pour le moment, l'accès à l'interface Clutch n'est pas protégé. Nous allons le sécuriser grâce à un [[wpfr>.htaccess|fichier « .htaccess »]].

On crée un fichier .htpasswd (veillez à bien remplacer **nomUtilisateur** par votre un identifiant de votre choix).

<code>sudo htpasswd -c /usr/share/clutch/www/.htpasswd nomUtilisateur</code>

[[:tutoriel:comment_editer_un_fichier|Créez le fichier]] **/usr/share/clutch/www/.htaccess** et collez-y ceci :

<file>
AuthUserFile /usr/share/clutch/www/.htpasswd
AuthName "Acces Clutch"
AuthType Basic

<Limit GET POST>
Require valid-user
</Limit>
</file>

[[:tutoriel:comment_editer_un_fichier|Ouvrez ensuite le fichier]] **/etc/clutch/clutch.conf** et modifiez-le comme ceci :

<file>
Alias /clutch /usr/share/clutch/www

<Directory /usr/share/clutch/www>
 Options FollowSymLinks  MultiViews
 AllowOverride All
 Order allow,deny
 Allow from all
</Directory>
</file>

Redémarrez le serveur Apache :

sudo /etc/init.d/apache2 restart

Voilà, en allant à l'adresse [[http://localhost/clutch]], votre login et votre mot de passe devraient vous être demandé.

Note : Il y a plus simple et plus propre (enfin je trouve) en [[:tutoriel:comment_editer_un_fichier|modifiant le fichier]] **/etc/apache2/conf.d/clutch.conf**. Il faut décommenter les dernières lignes(celles avec AuthType...). Pour donner :

<code>
## You shoud probably set up authentication to keep others from messing with
## your torrents.
## Uncomment this section to set up HTTP Basic authentication.
## Use htpasswd from apache2-utils to generate the password file
##  /etc/clutch/htpasswd. Refer to its manpage for relevant examples.
  AuthType Basic
  AuthName "Torrent server"
  AuthUserFile /etc/clutch/htpasswd
  Require valid-user
</Directory>
</code>

Puis on creer le fichier « .htpasswd » :

<code>sudo htpasswd -c /etc/clutch/htpasswd username</code>

Et on redemarre le tout :

<code>
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/clutch restart
</code>

===== Désinstallation =====

[[:tutoriel:comment_supprimer_un_paquet|Supprimez le paquet]] **clutch**.

===== Liens =====

* [[http://clutchbt.com/|Site officiel]]

----

//Contributeur principal : [[:utilisateurs:misteraph]].//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : Y H Z W X Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported