✎ hellanzb [Wiki ubuntu-fr]

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

====== HELLANZB (Zussaweb et Hellahella) by Dedel, Ezteban, Placisfos======

===== I. Introduction =====

J'ai décidé, pour ceux qui n'ont jamais installé hellanzb sur leur machine de faire un petit tuto en Français.

Vous allez me dire : « Mais c'est quoi Hellanzb? A quoi çà sert? »

Hellanzb est un petit programme (sous linux bien entendu) qui permet de télécharger sur les serveurs Usenet binaires, plus connus sous le nom de Newsgroup. A partir d'un fichier NZB, que vous aurez au préalable téléchargé sur un site de référencement, il vous permettra d'importer le contenu de ce dernier pour le télécharger.

Mais ce n'est pas tout : Hellanzb ne fait pas que télécharger les fichiers, il les répare (si nécessaire) et les extrait pour vous. Vous n'avez rien à faire, hormis le graver. (ben oui, vous voulez pas non plus qu'il le regarde pour vous!!)

Bon, après cette brève introduction, passons aux choses sérieuses : l'Installation.

===== II. Installation =====

====Pour Feisty Fawn (et Debian Etch)====

Maintenant Hellanzb se trouve dans les dépôts, donc vous pouvez faire :
     sudo apt-get install hellanzb

====Pour les versions antérieures à Feisty Fawn (et Debian Etch)====

(Pour ceux que ça pourrait aider, voilà un lien avec des paquets ubuntu : http://mirror.linux.org.mt/mirror/ubuntu/pool/universe/h/hellanzb/)

Pour cette partie du tuto, j'ai en fait repris le tuto anglais officiel.

1. Ouvrir un terminal

2. Copier cela dans le terminal :
     sudo apt-get install python-dev python-twisted unrar par2

3. Télécharger Hellanzb à cette adresse :

http://www.hellanzb.com/distfiles/hellanzb-0.13.tar.gz

4. Extraire le fichier hellanzb-0.13.tar.gz :
     sudo tar -xzvf hellanzb-0.13.tar.gz

Ou bien faire un clic droit sur le fichier, puis faire « extraire ici »

5. Se placer dans le dossier à l'aide de cette commande :
     cd hellanzb-0.13

6. Lancer l'installation :
     sudo python setup.py install

===== III. Configuration =====

====Pour Feisty Fawn (et Debian Etch)====

Configurer le fichier :
     sudo gedit /etc/hellanzb.conf

====Pour les versions antérieures à Feisty Fawn (et Debian Etch)====

Copier les fichiers de configuration :
     sudo cp /usr/etc/hellanzb.conf.sample /usr/etc/hellanzb.conf

Configurer le fichier :
     sudo gedit /usr/etc/hellanzb.conf

===Configuration du fichier hellanzb.conf :===

- Aller à cette ligne pour modifier le prefix_dir :
   # Important locations
   Hellanzb.PREFIX_DIR = os.path.expanduser('~') + '/.hellanzb/'

Cette ligne veut dire que le dossier utilisé par hellanzb sera : /home/votre_identifiant_ubuntu/.hellanzb\\ 
Remplacez /.hellanzb/ par le chemin vers lequel vous voulez que hellanzb copie ses dossiers.

**1. __Chez un fournisseur payant de newsgroups__** :

Il vous faut vous procurer vos identifiants de connexion que vous avez reçu par votre fournisseur de newsgroups :

- Aller à la ligne : defineServer.
On trouve ceci :
        (id = 'votre_identifiant',
        hosts = [ 'votre_nom_de_serveur:119' ],
        #hosts = [ 'votre_nom_de_serveur', 'morenews.changeme.com:8000' ],

username = 'votre_identifiant',
        password = 'votre_mot_de_passe',
        #username = None,           # no auth
        #password = None,

**2. __Chez le FAI FREE__** :

(id = 'votre_identifiant',
        hosts = [ 'news.free.fr:119' ],
        #hosts = [ 'votre_nom_de_serveur', 'morenews.changeme.com:8000' ],

#username = 'votre_identifiant',
        #password = 'votre_mot_de_passe',
        username = None,           # no auth
        password = None,

Par défaut, Hellanzb répare automatiquement les fichiers .rar gràce aux fichiers .par2. Mais si vous souhaitez qu'il vous décompresse automatiquement les fichiers .rar il faudra encore configurer le fichier hellanzb.conf comme ceci :

<code>
     # Supply a path to the (un)rar command
     Hellanzb.UNRAR_CMD = '/usr/bin/unrar'

# Supply a path to the par2 command
     Hellanzb.PAR2_CMD = '/usr/bin/par2'

# Skip unraring during post processing
     #Hellanzb.SKIP_UNRAR = True
</code>

Vous pouvez maintenant exécuter le programme :

hellanzb.py
ou
     hellanzb

===== IV. Utilisation =====

Télécharger un fichier NZB, et le plaçer ici :

/home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue/

- Si vous voulez utilisez une interface web (hellahella ou zussaweb) pour gérer vos téléchargements, il se peut que vous n'ayez pas les droits pour copier un fichier dans ce dossier, alors faites un :

sudo chmod 775 /home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue
 et un:

sudo chown votre_identifiant_ubuntu:www-data /home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue

Une fois vos fichiers téléchargés et réparés, ils seront extrait ici :

/home/votre_identifiant_ubuntu/dossier_hellanzb/done/

Il ne vous reste plus qu'à graver le tout avec votre logiciel de gravure préféré.

===== V. Compléments =====

Si vous désirez que Hellanzb se lance automatiquement en démon au démarrage de votre machine, il va falloir créer un fichier "hellanzb" dans /etc/init.d/ avec les droits 755.\\ 
Voici ce que doit contenir ce fichier :

<code>
#!/bin/bash

case "$1" in
  start) 
	su -c 'hellanzb -D' votre_identifiant_ubuntu
	;;
  stop)
        su -c 'hellanzb shutdown' votre_identifiant_ubuntu
        ;;
  status)
	su -c 'hellanzb status' votre_identifiant_ubuntu
	;;
esac
</code>

ensuite dans un terminal tapez :

<code>
sudo update-rc.d hellanzb defaults 99
</code>

et voilà, le service Hellanzb se lancera en démon au démarrage de votre machine !

Vous pouvez donc par la suite démarrer, arrêter ou vérifier le status de votre service Hellanzb avec les commandes :

<code>
sudo /etc/init.d/hellanzb start
ou
sudo /etc/init.d/hellanzb stop
ou
sudo /etc/init.d/hellanzb status
</code>

Si jamais vous voulez enlever Hellanzb du démarrage de votre machine, il suffit de taper la commande suivante :
<code>
sudo update-rc.d -f hellanzb remove
</code>
Le script sera toujours présent dans /etc/init.d/ mais ne sera plus exécuté au redémarrage. Pour le réactiver il faudra refaire la commande //sudo update-rc.d hellanzb defaults 99//

====Script d'installation automatique posté par TuxCrafter sur UbuntuForum====

#!/bin/bash

#Author: 		Copyright Jelle de Jong <jelledejong@powercraft.nl>
#Note:			Please send me an email if you enhanced the script
#Version:		0.0.6
#Date:			20-07-06 / 17-11-06 / 15-12-06 / 04-03-07 / 17-03-07 / 01-04-07
#System:		Xubuntu 7.04
#Description:		Setting up hellanzb
#Information:		http://www.ubuntuforums.org/showthread.php?t=169749&highlight=hellanzb
#Information:		http://www.hellanzb.com/
#Command:		chmod +x hellanzb.sh; ./hellanzb.sh

# This program is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the
# Free Software Foundation; either version 2, or (at your option) any
# later version.
#
# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# General Public License for more details.

location="$PWD"

echo -n "install the necessary tools [Y/n]? "
read input
if [ "$input" != "n" ]
then
	sudo apt-get install python-dev python-twisted unrar par2 build-essential
fi

echo -n "install hellanzb[Y/n]? "
read input
if [ "$input" != "n" ]
then
	cd ~
	wget http://www.hellanzb.com/distfiles/hellanzb-0.13.tar.gz
	tar -xzvf hellanzb-0.13.tar.gz
	cd hellanzb-0.13/
	sudo python setup.py install

wget http://www.hellanzb.com/hellanzb-content/yenc-0.3.tar.gz
	tar xzfv yenc-0.3.tar.gz
	cd yenc-0.3
	python setup.py build
	sudo python setup.py install

cd ~
	rm hellanzb-0.13.tar.gz
	sudo rm -rf hellanzb-0.13
fi

echo -n "set-up personal configuration file for hellanzb[Y/n]? "
read input
if [ "$input" != "n" ]
then
	cd "$location"
	sudo cp hellanzb/hellanzb.conf /usr/etc/hellanzb.conf
	if [ -e /var/tmp/hellanzb.log ] 
	then
		sudo chmod 0666 /var/tmp/hellanzb.log
	fi
fi

#grep -n ^defineServer /usr/etc/hellanzb.conf | grep -o ^[[:digit:]]*
#grep -n ")" /usr/etc/hellanzb.conf | grep -o ^[[:digit:]]*

exit
</code>

==== Les interfaces web ====

== A quoi cela sert-il ? ==

Zussaweb et Hellahella sont des interfaces web pour Hellanzb. En effet, il peut apparaître fastidieux d'aller à chaque fois déposer les fichiers .nzb dans votre dossier nzb/daemon.queue/

Zussaweb et Hellahella sont là pour vous simplifier la vie et donner en prime un aspect un peu moins austère à Hellanzb.

Le point fort de ces interfaces web est de vous permettre de lancer un fichier .nzb de n'importe où dans le monde simplement avec un navigateur web.

== Configuration requise ==

Il faut bien entendu avoir déjà Apache et PHP installé sur sa machine.
http://doc.ubuntu-fr.org/lamp

=== Zussaweb ===

Pour télécharger Zussaweb : http://sourceforge.net/projects/zussaweb

Ensuite il faudra juste modifier dans le fichier settings.php de Zussaweb:

$disk = '/home/votre_identifiant_ubuntu/dossier_hellanzb';
     $download_nzb_path = '/home/votre_identifiant_ubuntu/dossier_hellanzb/nzb/daemon.queue';

<note important>Pour le bon fonctionnement, il est également nécessaire de modifier le fichier functions.php

1 - A la ligne 4 remplacez la variable $disk par ce que vous avez écrit plus haut

2 - A la ligne 77 remplacez : "/" par de simples guillemets : '/'</note>

Pour la mise en place de l'interface, je pars du principe que si vous utilisez Apache vous saurez mettre en place Zussaweb.

=== Hellahella ===

== Installation ==

* L'installation requiert l'installation d'un serveur web et de php. Pour l'installer rien de plus simple il suffit de suivre l'excellente contribution : [[http://doc.ubuntu-fr.org//serveur/lamp_bis]].
  * Ensuite il suffit d'installer subversion:
<code>sudo aptitude install subversion</code>
  * Puis vous pouvez maintenant installer hellahella:
[[http://www.hellanzb.com/trac/hellanzb/wiki/HellaHella]] à l'aide de ce fichier : [[http://peak.telecommunity.com/dist/ez_setup.py]] (enregistrer sous ez_setup.py)
  * Il faut maintenant ouvrir un terminal et vous rendre dans le répertoire ou vous avez téléchargé ce fichier. Puis lancer l'installation avec la commande: 
<code>sudo python ez_setup.py -U hellahella==dev</code>
  * Il vous faut enfin configurer correctement votre hellahella, en renseignant les repertoires adequat dans le fichier settings.php de Hellahella:
<code> gedit /var/www/zussaweb/settings.php </code>
  * Là vous pouvez vous rendre sur votre serveur web à http://localhost/zussaweb/ et O miracle ça ne fonctionne pas. En effet comme d'habitude avec un serveur web __Il y a des problèmes de droit d'acces avec votre repertoire daemon.queue__ , un petit
<code> chmod 775 /home/user/hellanzb/nzb/daemon.queue/ </code> devrait rectifier le tir.

* Logiquement ça fonctionne.

Merci de recopier le code ci-contre pour prouver que vous êtes humain : C A Y F K 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