Compiler rTorrent depuis SVN sur Ubuntu

TL;DR

Installer rTorrent depuis le SVN permet d’obtenir la version la plus récente. Ce guide montre pas à pas l’installation de libtorrent puis rTorrent depuis le dépôt SVN, avec les commandes à exécuter, les vérifications post-installation et des conseils de dépannage.

Auteur et méta

Auteur : Stephan Jau
Révision : v1.0
Dernière modification : 19 octobre 2007

Introduction

Les torrents sont un moyen efficace pour transférer de gros fichiers. Beaucoup de clients ont une interface graphique et consomment des ressources (par exemple Azureus). rTorrent est un client léger qui fonctionne en ligne de commande. Il s’exécute bien dans une session screen, et peut donc être contrôlé à distance ou lancé au démarrage.

Utilisation, support et aide

La page d’accueil de rTorrent se trouve sur le site officiel.
Un guide basique d’utilisation de rTorrent est disponible en ligne.
Il existe un canal IRC d’entraide sur irc.freenode.org #rtorrent et un canal officiel sur irc.worldforgenet.org #libtorrent.

Hypothèses

Ce tutoriel utilise le répertoire home par défaut. Les fichiers SVN seront téléchargés dans ~/rtorrent. Vous devez être connecté comme utilisateur normal, pas comme root.

Prérequis (paquets requis)

Installez les paquets nécessaires :

sudo apt-get install subversion build-essential libtool automake1.9 openssl libcurl3 libcurl3-dev libsigc++-2.0-0c2a libsigc++-2.0-dev libncurses5 libncurses5-dev

Important : Automake doit être une version plus récente que 1.4. D’autres versions récentes fonctionnent également ; 1.9 est utilisée ici parce qu’elle est disponible et utile pour d’autres outils.

Méthodologie rapide

Créer un dossier de téléchargement ~/rtorrent.
Récupérer le trunk SVN.
Compiler et installer libtorrent.
Compiler et installer rTorrent.
Mettre à jour au besoin en relançant svn up.

Étapes détaillées

1. Créer le dossier de téléchargement

mkdir ~/rtorrent

2. Aller dans le dossier

cd ~/rtorrent

Emplacement actuel : /home/USER/rtorrent

3. Récupérer la dernière version trunk

svn co svn://rakshasa.no/libtorrent/trunk

4. Entrer dans le dossier trunk

cd trunk

Emplacement actuel : /home/USER/rtorrent/trunk

5. Mettre à jour rTorrent vers la dernière version SVN

svn up

6. Aller dans le dossier libtorrent

cd libtorrent

Emplacement actuel : /home/USER/rtorrent/trunk/libtorrent

7. Lancer le script autogen

./autogen.sh

8. Configurer la compilation

./configure

9. Compiler libtorrent

make

10. Installer libtorrent sur le système

sudo make install

11. Ajouter /usr/local/lib au chargement des bibliothèques

echo "include /usr/local/lib" | sudo tee -a /etc/ld.so.conf

12. Reconstruire le cache ld.so

sudo ldconfig

13. Aller dans le dossier rTorrent

cd ../rtorrent

Emplacement actuel : /home/USER/rtorrent/trunk/rtorrent

14. Lancer autogen pour rTorrent

./autogen.sh

15. Configurer rTorrent

./configure

16. Compiler rTorrent

make

17. Installer rTorrent sur le système

sudo make install

18. Lancer rTorrent

rtorrent

C’est terminé — profitez-en !

Mettre à jour vers la version la plus récente

Pour mettre à jour rTorrent plus tard vers la dernière version, recommencez à l’étape 5 (svn up) et ré-exécutez les étapes de compilation et d’installation (build & install).

Vérifications post-installation

Exécutez rtorrent et vérifiez qu’il démarre sans erreur.
Tapez l commande ldd $(which rtorrent) pour s’assurer que les bibliothèques dynamiques sont résolues.
Vérifiez la présence de libtorrent dans /usr/local/lib si vous avez gardé l’emplacement par défaut.

Dépannage courant

Erreur “configure: error” : installez les paquets de développement manquants (libcurl3-dev, libsigc++-dev, etc.).
Problèmes de bibliothèques non trouvées : assurez-vous d’avoir ajouté /usr/local/lib à /etc/ld.so.conf et exécuté sudo ldconfig.
Conflits de versions d’automake : installez une version récente d’automake via les dépôts ou compilez automake séparément.

Alternatives

Utiliser les paquets officiels Ubuntu (apt-get install rtorrent) si vous ne nécessitez pas la dernière version SVN.
Utiliser des backports ou PPA pour obtenir des versions plus récentes sans compiler.
Employer un conteneur (Docker) pour isoler l’installation et éviter de modifier le système hôte.

Checklist par rôle

Administrateur système : vérifier dépendances, ldconfig, permissions, cron/systemd pour démarrage automatique.
Utilisateur avancé : sauvegarder ~/.rtorrent.rc avant mise à jour ; tester dans une machine virtuelle si possible.
Développeur : garder un build propre (make clean) et documenter les patches appliqués au trunk.

Mini-méthodologie (bonnes pratiques)

Toujours compiler dans le répertoire utilisateur pour éviter d’écraser des fichiers système.
Utiliser des sessions screen/tmux pour exécuter rtorrent en arrière-plan.
Conserver un journal des commandes exécutées pour pouvoir reproduire l’installation.

1-ligne glossaire

SVN : système de gestion de versions Subversion.
trunk : branche principale de développement dans SVN.
ldconfig : met à jour le cache des bibliothèques partagées.

Quand cette méthode échoue (contre-exemples)

Si vous avez des politiques d’entreprise interdisant la compilation locale.
Si des dépendances manquent dans des versions compatibles avec Gutsy (distribution très ancienne).
Si vous avez besoin d’une distribution packagée pour gestion centralisée (préférez un paquet .deb).

Notes importantes

Important : Ubuntu Gutsy Gibbon est une version ancienne. Si possible, privilégiez une distribution supportée pour des raisons de sécurité et compatibilité.

Résumé

Téléchargez le trunk SVN.
Compilez et installez d’abord libtorrent, puis rTorrent.
Ajoutez /usr/local/lib à ld.so.conf et exécutez ldconfig.
Pour mettre à jour, relancez svn up puis recompilez.

Merci et bonne utilisation de rTorrent !

Compiler rTorrent depuis le SVN sur Ubuntu Gutsy Gibbon