{{tag>howto installation rss ttrss tiny_tiny_rss}}
====== Installation de Tiny Tiny RSS ======

[[http://tt-rss.org/|Tiny Tiny RSS]] est un agrégateur de news (RSS/Atom) open source en mode Web. Il permet d'avoir accès à ses news depuis n'importe quel navigateur web.


Voici donc un tutorial sur l'installation de ce logiciel, qui sera effectuée sur la Debian Stable du moment (lenny).
Il nécessite une base de donnée MySQL / PostgreSQL, nous allons utiliser ici MySQL.

===== Installation des prérequis =====
On va supposer que vous disposez déja d'un serveur MySQL.

Si vous n'avez pas déja php5-mysql, php5-xmlrpc et mysql-client-5.0 il faut les installer :<code>apt-get install php5-mysql php5-xmlrpc mysql-client-5.0</code>




===== Installation de Tiny Tiny RSS =====

La dernière version stable sera installée (1.4.2). si la version évolue, adapter les chemins suivants : <code>
mkdir /var/www/tt-rss
cd /var/www/tt-rss
wget http://tt-rss.org/download/tt-rss-1.4.2.tar.gz
tar xvzf tt-rss-1.4.2.tar.gz
ln -s tt-rss-1.4.2 current
cd current
</code>
<note>Noter comme d'habitude l'utilisation d'un lien symbolique pour permettre des futures mises à jour plus aisées</note>

===== Création de la base de données =====
Nous allons créer une BD nommee ttrss qui sera accédée par l'utilisateur ttrss avec le mot de passe "monMot2passeDehouf" sur le serveur localhost.
  * Créer la BD, connecté en root sur votre serveur mysql :<code>
mysql -u root -p
mysql> create database ttrss ;</code>
  * Choisir un mot de passe pour le compte MySQL (comme toujours l'utilitaire pwgen peut vous aider).
  * Créer l'utilisateur MySQL pour tt-rss et lui donner les droits qui-vont-bien :<code>
mysql> GRANT ALL on ttrss.* to 'ttrss'@'localhost' identified by 'monMot2passeDehouf';
mysql> flush privileges;
mysql> exit</code>
  * Creation des tables (il faut entrer le mot de passe de l'utilisateur):<code>
/usr/bin/mysql --user=ttrss -p ttrss < schema/ttrss_schema_mysql.sql</code>


===== Configuration =====
  * Configuration de l'acces BD pour tt-rss :<code>
mv config.php-dist config.php
chown root:www-data config.php
chmod 640 config.php
sed -i -e "s/\(define('DB_TYPE', \).*/\1'mysql');/" config.php
sed -i -e "s/\(define('DB_USER', \).*/\1'ttrss');/" config.php
sed -i -e "s/\(define('DB_NAME', \).*/\1'ttrss');/" config.php
sed -i -e "s/\(define('DB_PASS', \).*/\1'monMot2passeDehouf');/" config.php
</code>

===== Création du virtualhost apache =====
  * créer le fichier /etc/apache2/sites-available/rss :<code>
cat << EOF > /etc/apache2/sites-available/rss
######################################
#
# VirtualHost pour le rss Tiny Tiny RSS
#
######################################
<VirtualHost *:80>
	ServerName      rss.mondomaine.com
	
	DocumentRoot	/var/www/tt-rss/current

        ErrorLog /var/log/apache2/rss_mondomaine_com_error.log
	CustomLog /var/log/apache2/rss_mondomaine_com_access.log combined

	<Directory /var/www/tt-rss/current>
                order allow,deny
                allow from all
        </Directory>

	ServerSignature off
</Virtualhost>
EOF</code>
  * Le rendre disponible pour apache : <code>
ln -s /etc/apache2/sites-available/rss /etc/apache2/sites-enabled/</code>
  * Il ne reste plus qu'a recharger la configuration d'apache :<code>/etc/init.d/apache2 reload</code>
  * Puis aller admirer le resultat sur http://rss.mondomaine.com :-)

<note important>Nous avons configuré Tiny Tiny RSS en mode mono utilisateur et sans authentification/ protection particuliere</note>

===== Mise à jour automatique des flux RSS =====
Il est possible mais pas obligatoire de mettre à jour les flux de manière automatique.

La méthode à privilégier pour cela est l'utilisation d'un démon lancé via les scripts init.d.
  * Configurer tt-rss pour utiliser le demon :
    * <code> sed -i -e "s#define('ENABLE_UPDATE_DAEMON', false);#define('ENABLE_UPDATE_DAEMON', true);#" /var/www/tt-rss/current/config.php</code>
    * Créer et configurer le repertoire de lock :<code>mkdir /var/www/tt-rss/lock && chown www-data:www-data /var/www/tt-rss/lock</code>
    * <code> sed  -i -e "s#define('LOCK_DIRECTORY', '.');#define('LOCK_DIRECTORY', '/var/www/tt-rss/lock');#" /var/www/tt-rss/current/config.php</code>

  * Récupérer le fichier de configuration :<code>wget http://tt-rss.org/redmine/attachments/56/tt-rss.default --output-document=/etc/default/tt-rss</code>
  * Si vous avez suivi le début de ce tuto, il faut adapter le chemin :<code>
sed -i -e 's,"/var/www/tt-rss","/var/www/tt-rss/current",' /etc/default/tt-rss</code>
  * Récupérer et rendre exécutable le script d'init : <code>
wget http://tt-rss.org/redmine/attachments/57/tt-rss.initd --output-document=/etc/init.d/tt-rss
chmod +x /etc/init.d/tt-rss</code>
  * Le démon peut ensuite etre démarré manuellement via la commande <code>/etc/init.d/tt-rss start</code>
  * Si vous voulez démarrer/arrêter automatiquement ce démon avec l'ordinateur :<code>update-rc.d tt-rss defaults</code>
<note important>Attention le script d'init fait tourner le demon en root, ce qui est non seulement tres sale, mais aussi préjudiciable à la sécurité de votyre systeme</note>
Vous pouvez trouver un script d'init lançant ce démon avec l'utilisateur www-data (qui doit faire tourner votre serveur web) {{:sysadmin:tt-rss.sh|ici}}. Il faut placer ce fichier en le renommant en /etc/init.d/tt-rss.

===== Mise a jour =====

La version 1.5.5 a de tt-rss est sortie. Voici la procédure de mise à jour suivie :
  * <code># cd /var/www/tt-rss
# wget http://tt-rss.org/download/tt-rss-1.5.5.tar.gz
# tar xfvz tt-rss-1.5.5.tar.gz
# cp tt-rss-1.5.5/config.php-dist tt-rss-1.5.5/config.php</code>
  * regarder les differences entre les fichiers tt-rss-1.4.2/config.php et le fichier tt-rss-1.5.5/config.php et adapter selon vos besoins. Dans mon cas les valeurs a modifier sont les suivantes :<code>define('DB_TYPE', "mysql"); // pgsql or mysql
define('DB_USER', "ttrss");
define('DB_NAME', "ttrss");
define('DB_PASS', "monMot2passeDehouf");

define('SELF_URL_PATH', 'http://rss.mondomaine.com');
define('CACHE_DIR', '/var/tmp/ttrss-cache');

define('LOCK_DIRECTORY', '/var/www/tt-rss/lock');

define('PUBSUBHUBBUB_ENABLED', false);
define('ISCONFIGURED', true);
</code>
  * créer les répertoires requis :<code>
# mkdir /var/tmp/ttrss-cache
# mkdir /var/tmp/ttrss-cache/htmlpurifier</code>
  * adapter les permissions nécessaires :<code>
# chown root:www-data tt-rss-1.5.5/config.php
# chgrp www-data tt-rss-1.5.5/icons
# chown -R www-data:www-data /var/tmp/ttrss-cache</code>
  * une fois que tout est bon, vous pouvez changer le lien symbolique pour utiliser cette nouvelle version :<code>
# rm tt-rss-1.4.2
# ln -s tt-rss-1.5.5 current
</code>
  * Il faut ensuite vous rendre sur http://rss.mondomaine.com/ avec votre navigateur préféré. Vous serez invité à mettre à jour la base de donnée après avoir effectué une sauvegarde de celle ci.
  * Pour la sauvegarde je vous laisse faire, vous devez savoir comment faire.
  * Pour la mise à jour il suffit de cliquer. Si tout se passe bien vous devez avoir du vert partout, et vous pouvez ensuite aller sur la page d'accueil de votre tt-rss