Technical documentation : Debian

Installer Etherpad Lite comme un service

Quentin Drouet — 2012-05-17T18:36:50Z

Etherpad Lite est un éditeur de texte collaboratif en temps réel permettant de partager un texte entre plusieurs auteurs et d'y contribuer en même temps. Ce tutoriel explique une manière de l'installer et de l'utiliser comme un service sur un serveur.

Préparation nécessaire avant l'installation proprement dite

Dans un premier temps, nous allons créer un utilisateur système "etherpad" qui sera utilisé pour lancer le service :

sudo adduser etherpad

Cet utilisateur dispose par défaut d'un répertoire personnel home/etherpad.

On installe ensuite les dépendances disponibles dans les dépots APT :

sudo apt-get install gzip git-core curl python libssl-dev pkg-config build-essential

Installation de node.js

node.js est le framework javascript avec lequel est programmé d'Etherpad-lite.

On va changer d'utilisateur tout d'abord pour tout lancer sous l'utilisateur etherpad et travailler dans son répertoire personnel :

sudo su etherpad
cd ~

Download

On récupère la dernière version disponible de node.js sur son site [1] : http://nodejs.org/#download

wget http://nodejs.org/dist/v0.6.18/node-v0.6.18.tar.gz

On le désarchive :

tar xvzf node-v0.6.18.tar.gz

On se rend ensuite dans le répertoire de l'archive :

cd node-v0.6.18

On configure et compile le logiciel :

./configure && make

Puis on l'installe :

sudo make install

Installation d'Etherpad-lite à proprement dit

Il est temps maintenant d'installer Etherpad-lite que l'on récupère tout d'abord via Git :

cd ~
git clone 'git://github.com/Pita/etherpad-lite.git'

Download

On se déplace ensuite dans le répertoire récupéré et on installe les dépendance node nécessaires :

cd etherpad-lite
bin/installDeps.sh

Download

Ceci fait, on peut alors lancer Etherpad-Lite avec la commande suivante :

bin/run.sh

Pour vérifier son fonctionnement, il faut se rendre à l'adresse : http://domaine.tld:9001

Si cela fonctionne, arrêtez le logiciel avec la commande clavier ctrl +c

Utiliser Etherpad comme un service

Cette étape permet d'installer Etherpad-lite comme un service afin qu'il soit démarré et éteint avec la machine sur laquelle il est installé.

On va créer tout d'abord un répertoire de logs dans /var/log et lui donner les bons droits afin que l'utilisateur idoine puisse y écrire :

sudo mkdir -p /var/log/etherpad/
sudo chown -Rvf etherpad:etherpad /var/log/etherpad

Download

On va ensuite créer le fichier /etc/init.d/etherpad-lite :

sudo nano /etc/init.d/etherpad-lite

Et on y colle le contenu suivant :

#!/bin/sh
### BEGIN INIT INFO
# Provides: etherpad-lite
# Required-Start: $local_fs $remote_fs $network $syslog
# Required-Stop: $local_fs $remote_fs $network $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: starts etherpad lite
# Description: starts etherpad lite using start-stop-daemon
### END INIT INFO
PATH="/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/opt/node/bin"
LOGFILE="/var/log/etherpad-lite/etherpad-lite.log"
EPLITE_DIR="/home/etherpad/etherpad-lite"
EPLITE_BIN="bin/safeRun.sh"
USER="etherpad"
GROUP="etherpad"
DESC="Etherpad Lite"
NAME="etherpad-lite"
set -e
. /lib/lsb/init-functions
start() {
echo "Starting $DESC... "
start-stop-daemon --start --chuid "$USER:$GROUP" --background --make-pidfile --pidfile /var/run/$NAME.pid --exec $EPLITE_DIR/$EPLITE_BIN -- $LOGFILE || true
echo "done"
}
#We need this function to ensure the whole process tree will be killed
killtree() {
local _pid=$1
local _sig=${2-TERM}
for _child in $(ps -o pid --no-headers --ppid ${_pid}); do
killtree ${_child} ${_sig}
done
kill -${_sig} ${_pid}
}
stop() {
echo "Stopping $DESC... "
while test -d /proc/$(cat /var/run/$NAME.pid); do
killtree $(cat /var/run/$NAME.pid) 15
sleep 0.5
done
rm /var/run/$NAME.pid
echo "done"
}
status() {
status_of_proc -p /var/run/$NAME.pid "" "etherpad-lite" && exit 0 || exit $?
}
case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
status)
status
;;
*)
echo "Usage: $NAME {start|stop|restart|status}" >&2
exit 1
;;
esac
exit 0

Download

On le rend ensuite exécutable et on l'active dans les bon runlevels :

sudo chmod +x /etc/init.d/etherpad-lite
sudo update-rc.d etherpad-lite defaults

Download

On peut ensuite lancer le service avec la commande :

sudo /etc/init.d/etherpad-lite start

Et vérifier son fonctionnement à la même adresse qu'auparavant : http://domaine.tld:9001

[1] À l'heure où ce tutoriel est écrit, on utilise la version 0.6.18

mod_proxy : rediriger en tout transparence Apache vers un port spécifique

Quentin Drouet — 2012-05-09T11:04:33Z

Il peut être utile de rediriger certaines requêtes pointant normalement sur le serveur Apache (utilisant le port 80) par exemple vers un autre port du serveur afin d'utiliser d'autres services comme icecast ou shoutcast par exemple. On appelle cela du Reverse Proxy.

Activation des modules nécessaires

Pour ce faire, nous avons besoin de deux modules Apache non activés par défaut, proxy et proxy_http, on les active de la sorte :

sudo a2enmod proxy proxy_http

On n'oublie pas de redémarrer le serveur Apache pour les prendre en compte :

sudo /etc/init.d/apache2 restart

Exemple d'utilisation avec Icecast et Shoutcast

Le serveur de streaming Icecast ou Shoutcast écoute en général le port 8000. Si par exemple vous souhaitez afficher le serveur en question sur un sous-domaine du type http://streaming.domaine.tld et éviter que les utilisateurs, sans spécifier le port :8000 à la fin de l'adresse, tombent sur la page par défaut d'Apache, il suffit de créer un VirtualHost spécifique.

Un exemple de VirtualHost de base serait :

<VirtualHost *:80>
ServerAdmin postmaster@domaine.tld
ServerName streaming.domaine.tld
DocumentRoot /var/www/
VirtualHost>

Download

Dès lors, le visiteur utilisant l'adresse http://streaming.domaine.tld devrait voir la page de base "It works" d'Apache. Nous souhaitons qu'il voie l'interface du serveur de streaming qui elle est accessible sur le port :8000.

Pour ce faire nous allons supprimer la ligne DocumentRoot qui ne sert plus à rien et ajouter ces trois lignes à notre VirtualHost :

ProxyPass / http://localhost:8000/
ProxyPassReverse / http://localhost:8000/
ProxyPreserveHost On

Download

On recharge la configuration d'Apache :

/etc/init.d/apache2 reload

Dès lors, en utilisant la même adresse, le visiteur sera redirigé de manière transparente vers l'interface souhaitée.

Le fichier du VirtualHost final ressemblera donc à :

<VirtualHost *:80>
ServerAdmin postmaster@domaine.tld
ServerName streaming.domaine.tld
ProxyPass / http://localhost:8000/
ProxyPassReverse / http://localhost:8000/
ProxyPreserveHost
VirtualHost>

Download

Apache et un petit peu de sécurité

Quentin Drouet — 2012-05-03T21:19:53Z

Ne pas afficher les informations de version

La première chose à faire lors de la mise en production d'un serveur Apache est de faire en sorte qu'il n'affiche pas l'ensemble de ses informations de versions afin d'éviter à tout attaquant potentiel de connaitre trop d'informations sur sa machine cible.

Pour cela deux directives sont à modifier.

ServerTokens, dont les informations sont visibles dans les entêtes des requètes, qui peut prendre comme valeur :

Prod : la plus restrictive, Apache ne devrait afficher que Apache;
Major : le serveur affichera Apache et son numéro de version majeur Apache/2;
Minor : le serveur affichera Apache et ses numéros de version majeur et mineur Apache/2.0;
Min : le serveur affichera Apache et son numéro de version complet Apache/2.0.55;
Os (par défaut en général) : le serveur affichera Apache, son numéro de version complet et son système d'exploitation Apache/2.0.55 (Debian);
Full : le serveur affichera Apache, son numéro de version complet, son système d'exploitation et les informations des modules supplémentaires Apache/2.0.55 (Debian) PHP/5.1.4-1 mod1/X.Y mod2/W.Z;

ServerSignature, moins importante sur ServerTokens est correctement configurée, cette directive affiche le contenu de ServerTokens, le nom de domaine et le port utilisé pour la connexion sur les pages auto-générées par Apache. Trois valeurs sont possibles :

Off n'affichera pas ces informations du tout;
On affichera ces informations;
Email affichera ces informations en y ajoutant l'email du ServerAdmin du Virtualhost;

Ces deux directives se trouvent dans le fichier /etc/apache2/conf.d/security, que l'on édite :

sudo nano /etc/apache2/conf.d/security

On y recherche nos directives que l'on modifie ainsi :

#....
ServerTokens Prod
#....
ServerSignature Off

Download

On n'oublie pas de recharger la configuration d'Apache :

/etc/init.d/apache2 reload

Monitorer sympa

Quentin Drouet — 2012-05-03T12:27:56Z

Monitorer sympa a l'aide de Munin demande l'utilisation de deux plugin tiers dont le code est visible ici.

On décide, comme pour fail2ban de placer les plugins supplémentaires pour munin dans le répertoire /opt/share/munin/plugins :

#Créer le répertoire des plugins dans le cas ou il n'existe pas déjà
sudo mkdir -p /opt/share/munin/plugins
cd /opt/share/munin/plugins
# Récupérer les script
sudo wget http://svn.aires-de-confluxence.info/export/6415/Serveur/munin/sympa4munin/sympa_spool
sudo wget http://svn.aires-de-confluxence.info/export/6415/Serveur/munin/sympa4munin/sympa_stats
# Rendre exécutable les script
sudo chmod +x sympa_*

Download

Il est nécessaire de modifier au moins une valeur de configuration car sympa_stats a besoin de lire le fichier de log de sympa. On modifie donc le fichier de configuration de munin :

sudo nano /etc/munin/plugin-conf.d/munin-node

Dans lequel on ajoute les lignes suivantes :

[sympa_stats]
user root

Download

D'autres options sont possibles, si vous avez une installation non conventionnelle de sympa, elles sont expliquées dans ce fichier de description d'installation.

Ces plugin gèrent l'autodétection donc on va utiliser la commande munin-node-configure pour voir ce que l'on peut faire :

sudo munin-node-configure --libdir /opt/share/munin/plugins --shell

La commande devrait afficher deux lignes à copier/coller :

ln -s '/opt/share/munin/plugins/sympa_spool' '/etc/munin/plugins/sympa_spool'
ln -s '/opt/share/munin/plugins/sympa_stats' '/etc/munin/plugins/sympa_stats'

Download

On peut ensuite tester le plugin :

sudo munin-run sympa_stats
sudo munin-run sympa_spool

Download

Ces commandes doivent retourner plusieurs lignes du type clé.value nombre comme :

#Pour sympa_stats
badFiles.value 0
oldFiles.value 0
senderNotAllowed.value 0
keyToEditors.value 1
msgAccepted.value 4
msgArchived.value 4
#Pour sympa_spool
auth.value 0
bounce.value 7
digest.value 1
distribute.value 0
expire.value 0
moderation.value 21
msg.value 0
outgoing.value 0
subscribe.value 0
task.value 22
tmp.value 43
topic.value 0
msg_bad.value 4
distribute_bad.value 0

Download

Bien entendu, dernière étape, redémarrer le service munin-node :

sudo /etc/init.d/munin-node restart

Déplacer un serveur Sympa sur une autre machine

Quentin Drouet — 2012-05-02T14:06:19Z

Avant toute chose, on considère que le serveur Sympa est déjà installé comme indiqué dans l'article "Installation et configuration".

Ce que l'on a besoin de récupérer et de modifier depuis le serveur d'origine :

La base de donnée;
La définition des listes;
La définition des topics (s'ils ont été modifié)
La définition des robots;
Les alias de mail des listes;
Les DNS qui pointent sur le serveur de listes;

Ce que l'on va recréer sur le nouveau serveur :

Les différents virtualhosts;
Modifier la configuration de Postfix pour prendre en charge les listes;

Exporter la base de donnée

On utilise l'outil mysqldump pour ce faire :

mysqldump --databases sympa -u root --password=mot_de_passe_root > sympa_old.sql

Copie des données de Sympa

Sur le serveur d'origine :

On envoie le contenu du répertoire home de Sympa sur le nouveau serveur:

scp -r /home/sympa/ user@server_2:sympa_old/

On envoie aussi ses fichiers de configuration :

scp -r /etc/sympa.conf user@server_2:sympa_old/

scp -r /etc/wwsympa.conf user@server_2:sympa_old/

On envoie aussi le contenu de son ou ses virtualhosts :

scp -r /etc/apache2/sites-available/sympa user@server_2:sympa_old/

On envoie les aliases d'emails :

scp -r /etc/mail/sympa_aliases user@server_2:sympa_old/

Si vous utilisez les robots de Sympa :

scp -r /etc/mail/sympa_virtual_regexp user@server_2:sympa_old/

On envoie finalement la base de donnée :

scp -r sympa_old.sql user@server_2:sympa_old/

Sur le serveur distant, tous les fichiers ne sont pas à conserver :

On commence par copier les configuration du serveur :

sudo cp -Rvf sympa_old/sympa.conf /etc/

sudo cp -Rvf sympa_old/wwsympa.conf /etc/

On copie les archives :

sudo cp -Rvf sympa_old/arc/* /home/sympa/arc/

On copie les bounce :

sudo cp -Rvf sympa_old/bounce/* /home/sympa/bounce/

On copie les données des listes :

sudo cp -Rvf sympa_old/list_data/* /home/sympa/list_data/
sudo cp -Rvf sympa_old/etc/* /home/sympa/etc/

Download

On copie les données des robots (ce répertoire n'est pas sensé exister) :

sudo cp -Rvf sympa_old/expl/ /home/sympa/

On copie les spool :

sudo cp -Rvf sympa_old/spool/* /home/sympa/spool/

Application des modifications et redémarrage

On restaure l'ancienne base de donnée :

mysql -u root -p sympa < sympa_old.sql

Assurez vous bien que les droits d'utilisation sur cette table sont bien les mêmes que sur l'ancien serveur, sinon modifiez la configuration d'accès mysql dans /etc/sympa.conf

On donne les bons droits aux fichiers que l'on vient de copier coller :

sudo chown -Rvf sympa:sympa /home/sympa/

On relance la configuration de sympa en laissant les informations par défaut (celles du fichier actuel /etc/sympa.conf) qui donnera les bons droits au fichier de conf

sudo /home/sympa/bin/sympa_wizard.pl

On upgrade la structure des données si les serveurs n'ont pas tout à fait la même version :

sudo /home/sympa/bin/sympa.pl --upgrade

Modification des DNS et de la configuration de Postfix

Il est nécessaire que Postfix puisse acheminer le courier.

On copie les aliases de mails :

sudo cp sympa_old/sympa_aliases /etc/mail/

Si vous utilisez les robots de sympa, il vous faudra également copier les alias virtuels :

sudo cp sympa_old/sympa_virtual_regexp /etc/mail/sympa_virtual_regexp

On s'assure qu'ils ont les bons droits :

sudo chown -Rvf sympa:sympa /etc/mail/

On regénère la base de donnée des aliases :

sudo newaliases

Il est également nécessaire de vérifier la configuration de Postfix /etc/postfix/main.cf :

sudo nano /etc/postfix/main.cf

Principalement les directives :

alias_maps

qui doit être :

alias_maps = hash:/etc/aliases,hash:/etc/mail/sympa_aliases

alias_database

qui doit être :

alias_database = hash:/etc/aliases, hash:/etc/mail/sympa_aliases

Si vous utilisez les robots de sympa, virtual_alias_maps qui doit être :

virtual_alias_maps = regexp:/etc/mail/sympa_virtual_regexp

et mydestination qui doit comprendre tous les robots de mailing lists du serveur sympa.

Il ne vous reste plus qu'à modifier les DNS de vos domaines pointant sur le serveur.

Redémarrage des services

Vous devrez redémarrer les différents services qui ont été modifiés, Postfix, Apache, Sympa :

sudo /etc/init.d/postfix restart
sudo /etc/init.d/sympa restart
sudo /etc/init.d/apache2 restart

Download

Récupérer le mot de passe du listmaster

Quentin Drouet — 2012-04-30T11:56:53Z

La première chose à faire après l'installation et le premier démarrage de Sympa est de récupérer le mot de passe du Listmaster.

Pour cela, on doit se rendre avec notre navigateur sur le serveur Sympa, dans notre exemple à l'adresse : http://lists.domaine.tld

En haut à gauche de l'interface, vous devriez avoir un lien Première connexion sur lequel vous devez cliquer.

Un formulaire apparait, mettez l'adresse email que vous avez configuré comme étant celle du Listmaster lors de la configuration du serveur, dans notre cas postmaster@domaine.tld, puis cliquez sur Créer un mot de passe.

Vous devriez avoir reçu un email de la part du serveur sympa à l'adresse indiquée qui ressemble à :

Quelqu'un - sans doute vous - a demandé d'allouer ou de renouveler votre mot de passe associé à votre compte sur le serveur lists.domaine.tld. (Cette requête a été effectuée depuis l'hôte xx.xxx.xxx.xxx). Vous pouvez ignorer cette requête ou bien cliquer sur le lien suivant pour choisir votre mot de passe.: http://lists.domaine.tld/sympa/tick...

En cliquant sur le lien, vous pourrez choisir le mot de passe du Listmaster, afin de vous identifier avec le formulaire en haut à droite des pages du serveur.

Déplacer un serveur Munin sur une autre machine

Quentin Drouet — 2012-04-27T11:05:00Z

Il est très symple de déplacer un serveur munin sur une autre machine.

Pour ce faire, il est nécessaire d'installer le serveur sur la nouvelle machine comme décrit dans cet article.

On copiera sur le nouveau serveur les mêmes fichiers de configurations à savoir (si vous avez installé le serveur en suivant cette documentation) :

/etc/munin/munin.conf;
/etc/apache2/sites-available/munin;
/etc/apache2/conf.d/munin;

Il est également important que chaque noeud autorise le nouveau serveur à collecter les données, il faudra donc modifier leur configuration à ce sujet comme décrit ici.

Vous pouvez temporairement laisser l'accès aux 2 serveur afin d'éviter de perdre des données en cours.

Les seuls fichiers nécessaires au rétablissement des données par la suite est le contenu du répertoire des données collectées par munin sur l'ancien serveur /var/lib/munin.

A partir de ces données collectées que l'on aura transféré sur le nouveau serveur, Munin recréera automatiquement les fichiers html de cache.

Pour les transférer on peut par exemple utiliser scp depuis l'ancien serveur :

sudo scp -r -p /var/lib/munin/ user_distant@serveur_distant:munin/

Sur le nouveau serveur, on aura donc un répertoire /home/user_distant/munin/ dont on copiera le contenu dans le répertoire de libdir de Munin :

sudo cp -Rvf /home/user_distant/munin/* /var/lib/munin/

Puis on leur donner les bons droits :

sudo chown munin:munin -Rvf /var/lib/munin/

Après quelques minutes, les graphiques doivent avoir été mis à jour avec les anciennes données.

Utiliser FFmpeg

Quentin Drouet — 2012-02-12T13:09:43Z

Ces commandes sont testées avec la version 0.7.11 de FFmpeg.

On utilise une une vidéo appelée test.mp4 pour chacun de nos tests.

Rappel des options de base de ligne de commande de FFmpeg

Au préalable, il est nécessaire de connaitre la ligne de commande de base de FFmpeg qui est celle-ci (on utilise l'abbréviation ext pour "extension") :

ffmpeg -y entree.ext sortie.ext

Les éléments de cette commande sont :

ffmpeg : la commande ffmpeg qui appelle le logiciel;
-y entree.ext : qui spécifie que le fichier source à utiliser est entree.ext;
sortie.ext : qui spécifie le fichier de sortie qui sera sortie.txt;

Créer une capture d'une vidéo

L'objectif est de créer une vignette d'une vidéo pour par exemple l'utiliser sur un site Internet.

ffmpeg -i test.mp4 -vframes 1 vignette.jpg

Cette commande crée un fichier vignette.jpg de la première frame de la vidéo. Elle conserve la taille d'image du fichier vidéo original.

Il est également possible de générer un fichier png en modifiant l'extension du fichier de sortie [1]

Si l'on souhaite générer une capture à un moment donné d'une vidéo, il faut utiliser l'option -ss qui accepte comme valeur soit un nombre entier soit une donnée de position sous la forme hh:mm:ss.

Par exemple, la commande suivant est sensée capturer 1 frame de la video test.mp4 à partir de la 183ème seconde et l'enregistrer dans le fichier vignette.jpg :

ffmpeg -i test.mp4 -vframes 1 -ss 183 vignette.jpg

[1] La création de fichier png aura comme résultat des fichiers plus gros. Il faut éviter le format de fichier image gif qui lui génèrera des fichiers de qualité moindre.

Add / delete a moderator for a list

Quentin Drouet — 2011-10-18T17:47:48Z

If you have the administrator rights for a mailing list and this list is moderated, you can add other users as moderator in order to share the tasks on the mailing list you manage.

Add a moderator

To do that, simply go to the web interface manager list and identify you.

Then select the list to which you want to add the moderator, for example via the tab "List of Lists" or via the list in the left column if you are subscribed to this list.

On the list page, click on "Admin" in the navigation column and then on the "Edit List Config" tab.

Il suffit ensuite de cliquer sur le lien "Définition de la liste".

Sur cette page, rendez vous au niveau du cadre "Modérateurs".

Indiquez au moins l'adresse email et le nom du nouveau modérateur dans les chams vide de ce bloc et validez le formulaire en bas de la page.

Le nom du nouveau modérateur devrait apparaître dans le premier bloc de la navigation de la liste.

Then just click on the "List definition" link

On this page, scroll until the box "Moderators".

Enter at least the email address and name of the new moderator in the empty fields of this block and submit the form at the bottom of the page.

The name of the new moderator should appear in the first block of navigation in the list.

NB : if you wish to add more moderators, you have to perform the same action several times.

Remove a moderator

To remove a moderator, just go to the same configuration page and then delete the information fields for the moderator you want to delete.

The name of the former moderator should disappear from the list in the first block of the navigation.

You can delete several moderators at the same time.

Note following the addition of moderator

After adding a moderator to a mailing list, the administrators of the list (owners) do not receive emails notifying the arrival of new emails to moderate.

A user can be both administrator and moderator of the list, to do that, simply add the email of the administrator in both cases.

Trac and Piwik: traffic analysis of Trac

Quentin Drouet — 2011-01-22T16:39:31Z

Quote from the author :

This article is a translation of Trac et Piwik : analyse des statistiques de fréquentation de Trac published in french. We translated it following the request of Matt from the Piwik team.

All comment on any mistakes are welcome.

Trac is simply a website like any other, it is frequented by visitors. It may therefore be interesting to analyze visitor statistics of Trac instances on the server.

To do this we will use a third party software called Piwik. Piwik is an open source software that provides all necessary functionalities to analyze traffic statistics and can easily be compared to other tools (proprietary or not) such as Google Analytics.

To do this we created a plugin Piwik4Trac for Trac inspired by the plugin TracGoogleAnalytics developed by Pedro Algarvio.

Prerequisites

At first, you must have previously installed a Piwik server (we will not see the setup here) and at least one instance of Trac version 0.11 or more.

As you already have a functional Trac instance, many needed dependencies are already operational (Python, setuptools etc ...).

Common installation

The following command is the easiest way to install the plugin:

sudo easy_install Piwik4Trac

Then, we reload the configuration of the web server that Trac uses (Apache in our case):

sudo /etc/init.d/apache2 force-reload

After these commands, you can go to the plugin setup.

Compilation and installation from source

The source code of the Piwik4Trac plugin is available for consultation here : http://svn.aires-de-confluxence.inf...

At first, we'll get the sources via SVN [1] :

svn co http://svn.aires-de-confluxence.info/svn/Serveur/trac/Piwik4Trac/

Trac requires Python-eggs package for the plugins, we'll create one with the following commands :

# We go first in the newly created directory
cd Piwik4Trac
# We create the egg package
python setup.py bdist_egg

Download

Then, you should have a file named dist/Piwik4Trac-0.0.2-py2.5.egg if you use Python version 2.5. This name may be different depending on the version of Python installed on your server.

To install it on your trac instance, it's then necessary to copy this file into the plugins/ of your trac instance with a command that looks like the following (change the name of the file and copy the path to your Trac installation where needed) :

sudo cp dist/Piwik4Trac-0.0.2-py2.5.egg /var/trac/nom_de_l_instance/plugins/

It is then necessary to give the rights to the web server on this file. In case you use Apache, the following command will be enough:

sudo chown www-data:www-data /var/trac/nom_de_l_instance/plugins/*

Then you reload the configuration of the web server that Trac uses. In the case of Apache, the following command :

sudo /etc/init.d/apache2 force-reload

Setup of the Piwik4Trac plugin for Trac

To enable the plugin in Trac, you must add these lines in the trac.ini file of your Trac instance. As this example:

sudo nano /var/trac/nom_de_l_instance/conf/trac.ini

Add these lines (the first is not necessary if you already have a [components] in the configuration file:

[components]
tracext.piwik.* = enabled

Download

Then, if you log in as administrator in your Trac instance [2], you should see the administration panel link Piwik > Analytics in the left side.

If you go to this page, two informations are requested:

Tracking server : corresponds to the address (URL) of the Piwik server which will record the data. This information must be filled in without the "http://" or "https: / /" or final slash (eg : piwik.mydomain.com);
Tracked Site : corresponds to the numerical identifier defined by the server Piwik used for the site analyzed (your current instance of Trac);

If this informations are correct, you should see your statistics in your Piwik server for the Trac instance.

External links

Trac
Piwik
TracGoogleAnalytics, Google analytics plugin for Trac from which the Piwik4Trac plugin has been developped.

[1] If Subversion is not installed on your server, you can install it this way:

sudo apt-get install subversion

[2] If after logging on, you can not access the administration panel, it means you are not considered as admin.

To correct this, it is necessary to run the following command:

trac-admin /var/trac/nom_de_l_instance/ permission add login_utilisateur TRAC_ADMIN

Technical documentation : Debian

Installer Etherpad Lite comme un service

Préparation nécessaire avant l'installation proprement dite

Installation de node.js

Installation d'Etherpad-lite à proprement dit

Utiliser Etherpad comme un service

mod_proxy : rediriger en tout transparence Apache vers un port spécifique

Activation des modules nécessaires

Exemple d'utilisation avec Icecast et Shoutcast

Apache et un petit peu de sécurité

Ne pas afficher les informations de version

Monitorer sympa

Déplacer un serveur Sympa sur une autre machine

Exporter la base de donnée

Copie des données de Sympa

Application des modifications et redémarrage

Modification des DNS et de la configuration de Postfix

Redémarrage des services

Récupérer le mot de passe du listmaster

Déplacer un serveur Munin sur une autre machine

Utiliser FFmpeg

Rappel des options de base de ligne de commande de FFmpeg

Créer une capture d'une vidéo

Add / delete a moderator for a list

Add a moderator

Remove a moderator

Note following the addition of moderator

Trac and Piwik: traffic analysis of Trac

Prerequisites

Common installation

Compilation and installation from source

Setup of the Piwik4Trac plugin for Trac

External links

Préparation nécessaire avant l'installation proprement dite

Installation de node.js

Installation d'Etherpad-lite à proprement dit

Utiliser Etherpad comme un service

Activation des modules nécessaires

Exemple d'utilisation avec Icecast et Shoutcast

Ne pas afficher les informations de version

Exporter la base de donnée

Copie des données de Sympa

Application des modifications et redémarrage

Modification des DNS et de la configuration de Postfix

Redémarrage des services

Rappel des options de base de ligne de commande de FFmpeg

Créer une capture d'une vidéo

Add a moderator

Remove a moderator

Note following the addition of moderator

Prerequisites

Common installation

Compilation and installation from source

Setup of the Piwik4Trac plugin for Trac

External links