Ce guide est obsolète. Utilisez la nouvelle version sur le Help Desk Biapy:

Installer le lecteur de flux Tiny Tiny RSS sur Debian

Ce guide a été testé avec les distributions suivantes :

• Debian 5.0 Lenny
• Debian 6.0 Squeeze

Pré-requis

Ce guide nécessite un serveur MySQL disposant du script mysql-tools disponible dans le guide Installer et configurer MySQL sur Debian.

Ce guide nécessite un serveur HTTP avec support du PHP disposant au choix d'un des scripts suivant :

• Le script a2tools disponible dans mon guide Installer Apache 2 sur Debian.
  
• Le script lighty-tools disponible dans mon guide Installer Lighttpd et PHP 5 sur Debian.

Paramètres

Renseignez le nom de domaine ou sera disponible l'application :

DOMAIN="rss.domaine-exemple.fr"

Renseignez le nom d'hôte de votre serveur MySQL (si vous ne savez pas de quoi il s'agit, ne modifiez pas cette valeur) :

MYSQL_HOST="localhost"

Si votre serveur MySQL n'est pas local, ce guide effectuera une connexion SSH pour y créer la base de données.

Installation

Installez les modules PHP nécessaires au bon fonctionnement de l'application :

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

Redémarrez votre serveur HTTP pour prendre en compte les modifications :

test -x /etc/init.d/apache2 && /etc/init.d/apache2 force-reload
test -x /etc/init.d/lighttpd && /etc/init.d/lighttpd force-reload

Récupérez l'URL de la dernière version de l'application :

TTRSS_URL=$(command wget --quiet --output-document=- "http://tt-rss.org/redmine/" \
    | command grep -e "http://tt-rss.org/download/tt-rss-.*.tar.gz" \
    | command sed -e 's|.*"\(http://tt-rss.org/download/tt-rss-.*.tar.gz\)".*|\1|')
VERSION=$(command echo "${TTRSS_URL}" | command sed -e 's/.*tt-rss-\(.*\).tar.gz/\1/')

Téléchargez les sources de l'application :

command wget "${TTRSS_URL}" \
    --output-document="/tmp/tt-rss-${VERSION}.tar.gz"

Décompressez l'archive :

command tar --directory="/tmp" -xzf "/tmp/tt-rss-${VERSION}.tar.gz"

Déplacez le dossier de l'application vers son emplacement final :

command mv "/tmp/tt-rss-${VERSION}" "/opt/${DOMAIN}"

Supprimez l'archive téléchargée :

command rm "/tmp/tt-rss-${VERSION}.tar.gz"

Configuration

Créez le fichier de configuration à partir du modèle :

command cp "/opt/${DOMAIN}/config.php-dist" "/opt/${DOMAIN}/config.php"

Créez la base de données :

if [ "${MYSQL_HOST}" = "localhost" ]; then
  MYSQL_PARAMS=$(command mysql-tools create-domain-db "${DOMAIN}")
else
  command echo "Saisissez le mot de passe de l'utilisateur root MySQL :"
  command read PASSWORD
  MYSQL_PARAMS=$(command ssh "root@${MYSQL_HOST}" "command mysql-tools create-domain-db '${DOMAIN}' '$(command cat /etc/mailname)' '${PASSWORD}'")
fi

Récupérez les paramètres de la nouvelle base de données :

MYSQL_DB="$(echo "${MYSQL_PARAMS}" | command grep -e "^MYSQL_DB" \
    | cut --delimiter="=" --fields="2-")"
MYSQL_USER="$(echo "${MYSQL_PARAMS}" | command grep -e "^MYSQL_USER" \
    | cut --delimiter="=" --fields="2-")"
MYSQL_PASSWORD="$(echo "${MYSQL_PARAMS}" | command grep -e "^MYSQL_PASSWORD" \
    | cut --delimiter="=" --fields="2-")"
echo "${MYSQL_PARAMS}"

Initialisez le contenu de la base de données :

command mysql --user="${MYSQL_USER}" --password="${MYSQL_PASSWORD}" \
    --host="${MYSQL_HOST}" "${MYSQL_DB}" \
      < "/opt/${DOMAIN}/schema/ttrss_schema_mysql.sql"

Il vous faut maintenant modifier la configuration de Tiny Tiny RSS. Cela se fait par les lignes de commandes suivantes :

command sed -i \
    -e "s/\(define('DB_TYPE', \).*/\1'mysql');/" \
    -e "s/\(define('DB_HOST', \).*/\1'${MYSQL_HOST}');/" \
    -e "s/\(define('DB_NAME', \).*/\1'${MYSQL_DB}');/" \
    -e "s/\(define('DB_USER', \).*/\1'${MYSQL_USER}');/" \
    -e "s/\(define('DB_PASS', \).*/\1'${MYSQL_PASSWORD}');/" \
    "/opt/${DOMAIN}/config.php"

Mettez en place le dossier cache :

command mkdir --parent "/var/cache/tt-rss"
command mv "/opt/${DOMAIN}/cache" "/var/cache/tt-rss/${DOMAIN}"
command ln -s "/var/cache/tt-rss/${DOMAIN}" "/opt/${DOMAIN}/cache"
command mv "/opt/${DOMAIN}/lib/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer" "/var/cache/tt-rss/${DOMAIN}/Serializer"
command ln -s "/var/cache/tt-rss/${DOMAIN}/Serializer" "/opt/${DOMAIN}/lib/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer"
command chown -R www-data:www-data "/var/cache/tt-rss/${DOMAIN}"

Mettez en place le dossier lock :

command mkdir --parent "/var/lock/tt-rss"
command mv "/opt/${DOMAIN}/lock" "/var/lock/tt-rss/${DOMAIN}"
command ln -s "/var/lock/tt-rss/${DOMAIN}" "/opt/${DOMAIN}/lock"
command chown -R www-data:www-data "/var/lock/tt-rss/${DOMAIN}"

Créez la configuration du serveur HTTP pour votre domaine :

if [ -x "/usr/bin/a2tools" ]; then
  command a2tools add-vhost "${DOMAIN}" "/opt/${DOMAIN}/"
fi
if [ -x "/usr/bin/lighty-tools" ]; then
  command lighty-tools add-vhost "${DOMAIN}" "/opt/${DOMAIN}/"
fi

Votre installation de Tiny Tiny RSS devrait maintenant être disponible sur votre nom de domaine.

Mise en place d'une page d'identification

Pour mettre en place une page d'identification, en premier lieu, activez le mode multi-utilisateurs :

command sed -i \
    -e "s/\(define('SINGLE_USER_MODE', \).*/\1false);/" \
    "/opt/${DOMAIN}/config.php"

Vous pouvez alors utiliser les informations suivantes pour vous connecter à Tiny Tiny RSS :

• Identifiant : admin
• Mot de passe : password

Utiliser SimplePie à la place de Magpie pour parser les fichiers RSS

SimplePie est un parseur de flux RSS plus puissant que Magpie. Cependant il lui faut utiliser curl afin de pouvoir lire les flux en HTTPS ou ceux nécessitant un mot de passe.

Commencez par installer l'extension curl de php :

command apt-get install php5-curl

Et configurez Tiny Tiny RSS pour utiliser SimplePie :

command sed -i \
    -e "s/\(define('DEFAULT_UPDATE_METHOD', \).*/\11);/" \
    "/opt/${DOMAIN}/config.php"

Mise à jour régulière des flux

Il est souhaitable que vos flux soient mis à jour même si vous ne vous connectez pas régulièrement à Tiny Tiny RSS. Pour ce faire, installez la ligne de commande PHP :

command apt-get install php5-cli

Modifiez la configuration de façon à ce que la mise à jour des flux par un démon soit possible :

command sed -i \
    -e "s/\(define('ENABLE_UPDATE_DAEMON', \).*/\1true);/" \
    "/opt/${DOMAIN}/config.php"

Et changez l'emplacement des fichiers verrou :

command sed -i \
    -e 's|\(define('LOCK_DIRECTORY', \).*|\1'/var/run/tt-rss');|' \
    "/opt/${DOMAIN}/config.php"

Créez le dossier destiné à contenir les fichiers lock :

command mkdir --parent "/var/run/tt-rss"

Téléchargez le fichier de configuration du script init.d de Tiny Tiny RSS :

command wget "http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-tiny-tiny-rss-sur-debian-4-0-etch/tt-rss-default" \
    --output-document="/etc/default/tt-rss-${DOMAIN}"
command sed -i -e "s|^TTRSS_PATH=.*|TTRSS_PATH=\"/opt/${DOMAIN}\"|" "/etc/default/tt-rss-${DOMAIN}"

Téléchargez le script init.d de Tiny Tiny RSS :

command wget "http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-tiny-tiny-rss-sur-debian-4-0-etch/tt-rss-initd" \
    --output-document="/etc/init.d/tt-rss-${DOMAIN}"
command sed -i -e "s/DOMAIN/${DOMAIN}/g" "/etc/init.d/tt-rss-${DOMAIN}"
command chmod +x "/etc/init.d/tt-rss-${DOMAIN}"

Vous pouvez maintenant lancer le script de mise à jour avec la commande :

/etc/init.d/tt-rss-${DOMAIN} start

et l'arrêter avec :

/etc/init.d/tt-rss-${DOMAIN} stop

Si vous souhaitez que cette commande soit lancée au démarrage de votre ordinateur, exécutez la commande :

command update-rc.d "tt-rss-${DOMAIN}" defaults

De plus, le démon de mise à jour n'étant pas très stable et ayant tendance à planter régulièrement, il est recommandé de créer un script cron pour le redémarrer si nécessaire :

command echo "#\!/bin/sh
# Start tt-rss-${DOMAIN} udpate daemon if necessary :

if [ -x '/etc/init.d/tt-rss-${DOMAIN}' ]; then
        /etc/init.d/tt-rss-${DOMAIN} start
fi" > "/etc/cron.hourly/tt-rss-${DOMAIN}"
command chmod +x "/etc/cron.hourly/tt-rss-${DOMAIN}"

Le démon ne sera lancé que s'il n'est pas démarrer, grâce à la vérification de la présence d'un fichier verrou. Ce script cron ne pose donc aucun problème.

Modifier l'emplacement de stockage des icônes des flux

Par défaut, les icônes des flux sont cachées dans le dossier icons. Si vous souhaitez modifier ce comportement (par exemple parceque Tiny Tiny RSS est installé sur une partition en lecture seule), voici la procédure à suivre.

En premier lieu, créez le dossier destiné à contenir les icônes :

command mkdir --parent "/var/lib/tt-rss/${DOMAIN}/icons"

Modifiez ses permissions :

command chown -R www-data:www-data "/var/lib/tt-rss/${DOMAIN}/icons"

Ensuite, supprimez dossier icons de Tiny Tiny RSS :

command rm -r "/opt/${DOMAIN}/icons"

Et remplacez le par un lien symbolique vers votre nouveau dossier d'icônes :

command ln -s "/var/lib/tt-rss/${DOMAIN}/icons" "/opt/${DOMAIN}/feeds-icons"

Si vous le souhaitez, vous pouvez aussi modifier la configuration de Tiny Tiny RSS :

command sed -i \
    -e "s|\(define('ICONS_DIR', \).*|\1'/var/lib/tt-rss/${DOMAIN}/icons');|" \
    -e "s|\(define('ICONS_URL', \).*|\1'feeds-icons');|" \
    "/opt/${DOMAIN}/config.php"

Sauvegardes

Pour sauvegarder votre installation, je vous propose d'utiliser Backup Manager. Pour l'installer, vous pouvez suivre mon guide:

Installer et configurer Backup Manager sur Debian

Une fois Backup Manager installé, configurer la sauvegarde des fichiers de l'application :

command update-bm-folders add "/opt/${DOMAIN}"
command update-bm-folders add "/var/lib/tt-rss/${DOMAIN}"

Important: Sauvegarder les fichiers ne suffit pas ! Il faut aussi sauvegarder la base de données. La procédure pour ce faire est disponible dans mon article MySQL sur Debian.

Utilisation quotidienne

Paramétrer votre compte utilisateur

Voici les options que j'ai activé pour avoir un compte utilisateur adapté à mes besoins :

• Purger les articles plus vieux que le nombre de jours donné (0 pour ne jamais purger) : 0 (je désactive la suppression des articles trop vieux)
• Utiliser les catégories de flux : Yes (J'active la gestion des flux par catégories)
• Activer la barre de recherche : Yes (J'active la possibilité de rechercher dans le contenu des flux)
• Demander confirmation pour marquer un flux comme lu : No (Je désactive la confirmation lorsque je veux marquer l'ensemble d'un flux comme lu)
• Éliminer les étiquettes non sûres des articles : No (Je désactive la simplification du code source HTML des articles des flux. C'est moins sécurisé, mais ca permet de conserver les balises <code>)
  

Intégration dans Mozilla Firefox

Tiny Tiny RSS s'intègre facilement dans Mozilla Firefox. Et ceci de 2 manières :

• Vous pouvez utiliser Tiny Tiny RSS comme gestionnaire de flux dans Mozilla Firefox. Cela se configure à partir de vos préférences de flux.
• Vous pouvez installer un plugin qui vérifie la présence de nouveaux articles régulièrement : Tiny Tiny RSS Notifier.

Mise à jour de Tiny Tiny RSS

Si une nouvelle version est sortie, et que vous souhaitez mettre à jour votre installation de Tiny Tiny RSS, voici la procédure à suivre. En premier lieu, installez les outils nécessaires :

command apt-get install patch

Renseignez le domaine de votre installation :

DOMAIN="rss.domaine-exemple.fr"

Placez-vous dans le répertoire de votre installation de Tiny Tiny RSS :

cd "/opt/${DOMAIN}"

Créez un fichier de différence pour préserver votre configuration :

command diff -Nru config.php-dist config.php > "/tmp/tt-rss-config-diff.patch"

Récupérez le numéro de la nouvelle version de Tiny Tiny RSS :

TTRSS_URL=$(command wget --quiet --output-document=- "http://tt-rss.org/redmine/" \
    | command grep -e "http://tt-rss.org/download/tt-rss-.*.tar.gz" \
    | command sed -e 's|.*"\(http://tt-rss.org/download/tt-rss-.*.tar.gz\)".*|\1|')
VERSION=$(command echo "${TTRSS_URL}" | command sed -e 's/.*tt-rss-\(.*\).tar.gz/\1/')

Et lancez le téléchargement :

command wget "${TTRSS_URL}" \
    --output-document="/tmp/tt-rss-${VERSION}.tar.gz"

Une fois le téléchargement terminé, décompressez le fichier à l'emplacement adéquat :

command tar --directory='/tmp' -xzf "/tmp/tt-rss-${VERSION}.tar.gz"

Créez le fichier de configuration :

command cp "/tmp/tt-rss-${VERSION}/config.php-dist" "/tmp/tt-rss-${VERSION}/config.php"

Et patchez le afin de récupèrer votre configuration :

command patch --directory="/tmp/tt-rss-${VERSION}" --strip=0 < "/tmp/tt-rss-config-diff.patch"

Sauvegardez votre ancienne installation de Tiny Tiny RSS :

command mv "/opt/${DOMAIN}" "/opt/${DOMAIN}.old"

Et mettez en place la nouvelle version :

command mv "/tmp/tt-rss-${VERSION}" "/opt/${DOMAIN}"

Enfin, nous récupérons le dossier icons de notre installation précédente:

command cp -a "/opt/${DOMAIN}.old/feeds-icons" "/opt/${DOMAIN}"
command rm -r "/opt/${DOMAIN}/cache"
command cp -a "/opt/${DOMAIN}.old/cache" "/opt/${DOMAIN}"
command rm -r "/opt/${DOMAIN}/lock"
command cp -a "/opt/${DOMAIN}.old/lock" "/opt/${DOMAIN}"
command rm -r "/opt/${DOMAIN}/feed-icons"
command cp -a "/opt/${DOMAIN}.old/feeds-icons" "/opt/${DOMAIN}"
command rm -r "/opt/${DOMAIN}/lib/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer"
command cp -a "/opt/${DOMAIN}.old/lib/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer" "/opt/${DOMAIN}/lib/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer"

Identifiez-vous en tant qu'admin pour mettre à jour la base de données si nécessaire. Vérifiez que tout fonctionne correctement. Une fois ceci fait, redémarrez le démon de mise à jour des flux:

/etc/init.d/tt-rss-${DOMAIN} restart

Vous pouvez supprimer l'archive téléchargée et la sauvegarde de l'ancienne installation :

command rm "/tmp/tt-rss-${VERSION}.tar.gz"
command rm -r "/opt/${DOMAIN}.old"

Remerciements

• Merci aux développeurs de Tiny Tiny RSS (tout particulièrement à fox qui porte ce projet à bout de bras).
• Merci à Mdrolo qui a inscrit le flux de ce site dans son Tiny Tiny RSS et me l'a ainsi fait découvrir.