Installation de Tiny Tiny RSS

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 :

apt-get install php5-mysql php5-xmlrpc mysql-client-5.0

Installation de Tiny Tiny RSS

La dernière version stable sera installée (1.4.2). si la version évolue, adapter les chemins suivants :

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
Noter comme d'habitude l'utilisation d'un lien symbolique pour permettre des futures mises à jour plus aisées

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 :
    mysql -u root -p
    mysql> create database ttrss ;
  • 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 :
    mysql> GRANT ALL on ttrss.* to 'ttrss'@'localhost' identified by 'monMot2passeDehouf';
    mysql> flush privileges;
    mysql> exit
  • Creation des tables (il faut entrer le mot de passe de l'utilisateur):
    /usr/bin/mysql --user=ttrss -p ttrss < schema/ttrss_schema_mysql.sql

Configuration

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

Création du virtualhost apache

  • créer le fichier /etc/apache2/sites-available/rss :
    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
  • Le rendre disponible pour apache :
    ln -s /etc/apache2/sites-available/rss /etc/apache2/sites-enabled/
  • Il ne reste plus qu'a recharger la configuration d'apache :
    /etc/init.d/apache2 reload
  • Puis aller admirer le resultat sur http://rss.mondomaine.com :-)
Nous avons configuré Tiny Tiny RSS en mode mono utilisateur et sans authentification/ protection particuliere

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 :
    •  sed -i -e &quot;s#define('ENABLE_UPDATE_DAEMON', false);#define('ENABLE_UPDATE_DAEMON', true);#&quot; /var/www/tt-rss/current/config.php
    • Créer et configurer le repertoire de lock :
      mkdir /var/www/tt-rss/lock && chown www-data:www-data /var/www/tt-rss/lock
    •  sed  -i -e &quot;s#define('LOCK_DIRECTORY', '.');#define('LOCK_DIRECTORY', '/var/www/tt-rss/lock');#&quot; /var/www/tt-rss/current/config.php
  • Récupérer le fichier de configuration :
    wget http://tt-rss.org/redmine/attachments/56/tt-rss.default --output-document=/etc/default/tt-rss
  • Si vous avez suivi le début de ce tuto, il faut adapter le chemin :
    sed -i -e 's,&quot;/var/www/tt-rss&quot;,&quot;/var/www/tt-rss/current&quot;,' /etc/default/tt-rss
  • Récupérer et rendre exécutable le script d'init :
    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
  • Le démon peut ensuite etre démarré manuellement via la commande
    /etc/init.d/tt-rss start
  • Si vous voulez démarrer/arrêter automatiquement ce démon avec l'ordinateur :
    update-rc.d tt-rss defaults
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

Vous pouvez trouver un script d'init lançant ce démon avec l'utilisateur www-data (qui doit faire tourner votre serveur web) 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 :

  • # 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
  • 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 :
    define('DB_TYPE', &quot;mysql&quot;); // pgsql or mysql
    define('DB_USER', &quot;ttrss&quot;);
    define('DB_NAME', &quot;ttrss&quot;);
    define('DB_PASS', &quot;monMot2passeDehouf&quot;);
    
    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);
  • créer les répertoires requis :
    # mkdir /var/tmp/ttrss-cache
    # mkdir /var/tmp/ttrss-cache/htmlpurifier
  • adapter les permissions nécessaires :
    # 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
  • une fois que tout est bon, vous pouvez changer le lien symbolique pour utiliser cette nouvelle version :
    # rm tt-rss-1.4.2
    # ln -s tt-rss-1.5.5 current
  • 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
sysadmin/tt-rss.txt · Dernière modification: 2013/11/20 18:05 par james
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0