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.

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

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

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 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 "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

• 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

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 "s#define('ENABLE_UPDATE_DAEMON', false);#define('ENABLE_UPDATE_DAEMON', true);#" /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 "s#define('LOCK_DIRECTORY', '.');#define('LOCK_DIRECTORY', '/var/www/tt-rss/lock');#" /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,"/var/www/tt-rss","/var/www/tt-rss/current",' /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

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.

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', "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);

• 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