Planet Libre
#Gnu/Linux, Planet Libre
Installation d'une solution de collaboration: Etherpad Lite
Installation d'une solution de collaboration Etherpad Lite
J'ai eut besoin récemment pour les associations pour lesquelles je suis un peu sysadmin, de mettre en place une solution de collaboration texte.
Bien sur il existe les Google Docs et autres mais je voulais un outil simple et hebergé par mes serveurs.
J'ai un peu cherché et je suis tombé sur Etherpad !

EtherPad est un éditeur de texte collaboratif en temps réel. Il permet par défaut à un maximum de seize personnes de partager un texte en cours d'élaboration. Les contributions de chacun apparaissent immédiatement sur l'écran de tous les participants et sont signalées par des couleurs différentes. Une fenêtre de messagerie instantanée est également disponible.
Le système ne requiert aucune installation, ni aucune inscription, il suffit d'avoir une connexion internet et un navigateur web. EtherPad est écrit en JavaScript.
Etherpad était un éditeur (de texte) en ligne permettant de travailler à plusieurs sur un document. Le code fut ouvert par Google quand ils en firent l'acquisition pour l'intégrer à Google Wave (il me semble, ou alors c'était dans Google Docs), dans la foulée une fondation fut créée pour continuer à le faire vivre, et des pads fleurirent un peu partout, malgré la gourmandise du logiciel (les mauvaises langues, dont je ne suis pas, attribueront cette lourdeur au fait que le logiciel ait été écrit en Scala, et donc dépende de Java). Mais il était hors de portée des serveurs dédiés virtuels (VPS) pas chers, et autres mini serveurs.C'est là qu'entre en scène Etherpad Lite,
nettement moins gourmand, il se base sur Node.js,
a moins de dépendances ésotériques que son ancêtre, et d'après les
développeurs, là où un Etherpad occupait 257 Mo de RAM juste après son
démarrage, Etherpad
Lite n'en occupe que 16 Mo. Il est disponible sous licence Apache 2.0.
(source :http://linuxfr.org/news/etherpad-lite)
Etherpad vs Etherpad Lite
Etherpad | Etherpad Lite | |
Size of the folder (without git history) | 30 MB | 1.5 MB |
Languages used server side | Javascript (Rhino), Java, Scala | Javascript (node.js) |
Lines of server side Javascript code | ~101k | ~9k |
RAM Usage immediately after start | 257 MB (grows to ~1GB) | 16 MB (grows to ~30MB) |
Plateforme Materielle :
Comme d'habitude, j'ai monté mon prototype sur ma plateforme de virtualisation:
- HP® Proliant DL120
- CPU: 1x Intel® Xeon® E3-1220
- RAM: 16 Go DDR3 ECC
- HDD: 2 x 2 To SATA2 Raid 0 / Raid 1 HARD (P410)
- LAN: 1 Gbit/sec
Plateforme logicielle hyperviseur:
- Dom0 Opensuse 12.1 X86_64 Xen 4.1
- DomU Xen Ubuntu 10.04 X86_64 Paravirtualisé
- 2 vcpus
- 512 Mo de Ram
- HDD 16GB
Installation:
Pour commencer j'ai mis à jour totalement mon DomU ubuntu 10.04; mon template avait quelques maj de retard :)
- Mise à niveau du DomU
root@ubuntults:/# apt-get update; apt-get upgrade
root@ubuntults:/# apt-get install linux-headers-server linux-image-server linux-server
root@ubuntults:/# reboot
- Installation des prérequis
root@antony-linux:/home/antony# apt-get install gzip git-core curl python libssl-dev pkg-config build-essential
- Installation de node.js
root@antony-linux:/home/antony# wget http://nodejs.org/dist/v0.6.15/node-v0.6.15.tar.gz
root@antony-linux:/home/antony# tar xvfz node-v0.6.15.tar.gz
root@antony-linux:/home/antony/# cd node-v0.6.15
root@antony-linux:/home/antony/#./configure; make; make install
- Installation de Etherpad lite
root@antony-linux:/home/antony# git clone 'git://github.com/Pita/etherpad-lite.git'
Initialized empty Git repository in /home/antony/etherpad-lite/.git/
remote: Counting objects: 8065, done.
remote: Compressing objects: 100% (2632/2632), done.
remote: Total 8065 (delta 5738), reused 7590 (delta 5318)
Receiving objects: 100% (8065/8065), 2.76 MiB | 626 KiB/s, done.
Resolving deltas: 100% (5738/5738), done.
Je déplace le tout ce /opt
root@antony-linux:/home/antony# mv etherpad-lite /opt/etherpad
On installe les dépendances
root@ubuntults:/opt/etherpad# /opt/etherpad/bin/installDeps.sh
A partir d'ici on peut déjà lancer Etherpad.
root@ubuntults:/opt/etherpad# /opt/etherpad/bin/run.sh
You shouldn't start Etherpad-Lite as root!
Please type 'Etherpad Lite rocks my socks' if you still want to start it as root
Etherpad Lite rocks my socks
Ensure that all dependencies are up to date...
Ensure jQuery is downloaded and up to date...
Ensure prefixfree is downloaded and up to date...
Clear minfified cache...
ensure custom css/js files are created...
start...
[2012-04-20 17:01:09.999] [INFO] console - Your Etherpad Lite git version is 309e3b0
[2012-04-20 17:01:10.002] [INFO] console - Report bugs at https://github.com/Pita/etherpad-lite/issues
[2012-04-20 17:01:10.124] [INFO] console - Server is listening at 0.0.0.0:9001
[2012-04-20 17:01:10.125] [INFO] console - info - 'socket.io started'
Accès à l'interface Web:
Si tout est bien installé démarré, on peut acceder à l'interface Web de etherpard sur le port 9001
http://votre_ip:9001
Bon on à installer Etherpad Lite et on l'a lancé.
C'est bien joli, mais déjà on le lance en root ce qui n'est pas jojo et on est obligé de lancer le script à la main...
C'est pas très optimisé...
Optimisations :
Afin de pouvoir bénéficier des fonctions d'import il faut installer abiword
root@ubuntults:~# apt-get install abiword
Il faut modifier le settings.json dans le dossier etherpad pour que ce soit pris en compte
root@ubuntults:~# vi /opt/etherpad/settings.json///////
Abiword is needed to enable the import/export of pads*/
"abiword" : "/usr/bin/abiword",
//////
On crée un user Etherpad et on donne les droits adéquats.
root@ubuntults:~# useradd etherpadOn crée maintenant un script d'init afin de pouvoir lancer Etherpad en tant que daemon
root@ubuntults:~# chown -R etherpad /opt/etherpad
Ce script nous permet de lancer etherpad en tant que etherpad et aussi de pouvoir la lancer au demmarage.
#!/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.log"
EPLITE_DIR="/opt/etherpad"
EPLITE_BIN="bin/run.sh"
USER="etherpad"
GROUP="etherpad"
DESC="Etherpad"
NAME="etherpad"
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" && 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
On le rend executable.
root@ubuntults:/var/log# chmod +x /etc/init.d/etherpad
On active le script au démmarage:
root@ubuntults:/var/log# update-rc.d etherpad defaults
Adding system startup for /etc/init.d/etherpad ...
/etc/rc0.d/K20etherpad -> ../init.d/etherpad
/etc/rc1.d/K20etherpad -> ../init.d/etherpad
/etc/rc6.d/K20etherpad -> ../init.d/etherpad
/etc/rc2.d/S20etherpad -> ../init.d/etherpad
/etc/rc3.d/S20etherpad -> ../init.d/etherpad
/etc/rc4.d/S20etherpad -> ../init.d/etherpad
/etc/rc5.d/S20etherpad -> ../init.d/etherpad
root@ubuntults:/var/log# /etc/init.d/etherpad start
Notre etherpad est bien lancé
root@ubuntults:/var/log# ps aux | grep etherpad
etherpad 15021 0.0 0.0 4096 628 ? S 21:39 0:00 /bin/sh /opt/etherpad/bin/run.sh /var/log/etherpad.log
etherpad 15049 1.5 1.2 717752 25192 ? Sl 21:39 0:09 node server.js /var/log/etherpad.log
L'interface:


- La fonction Chat

- Les options

- La fonction d'import

- La fonction partage avec QRcode !

- La fonction replay

Etherpad est un outil simple installer, léger, et agréable à utiliser.
Bien sur il n'a pas toutes les fonctionnalités de Google Docs ou autres, mais il suffit bien pour la majorité des usages
Surtout le plus important c'est qu'il est installé sur vos serveurs.
Optimisations :
Je repends cet article pour améliorer un peu le système.
De base, les pads dans etherpad-lite sont stockés dans un fichier appelé dirtydb
Il porte bien son nom puisque tout est écrit à la suite en dur, sans aucune optimisations...
Ca va bien pour tester, mais si le nombre de pads devient conséquents ca va vite devenir problématique...
C'est pourquoi j'ai préféré utiliser mysql pour stocker les données...
root@ubuntults#mysql -u root -p
create database `etherpad`;
grant all privileges on `etherpad`.* to 'etherpad'@'localhost' identified by 'etherpad';
root@ubuntults#ALTER DATABASE `etherpad` CHARACTER SET utf8 COLLATE utf8_bin;
USE `etherpad`;
ALTER TABLE `store` CONVERT TO CHARACTER SET utf8 COLLATE utf8_bin;
Modifier votre settings.json pour utiliser mysql// An Example of MySQL Configuration
"dbType" : "mysql",
"dbSettings" : {
"user" : "etherpad",
"host" : "localhost",
"password": "etherpad",
"database": "etherpad"
},
Relancer Etherpad et voilà il utilise mysql.
Interface Web :
L'interface web de base de Etherpad-lite est très basique.
Je recherche activement une interface complète qui perméttrait d'utiliser toutes les fonctions de etherpad-lite
En effet Etherpad-lite dispose dune api bien fournie et on peut aller très loin...
En attendant un developpeur motivé, j'ai du faire 2 ou 3 ligne de php pour avoir quelquechose d'utilisable...
Je ne suis pas du tout developpeur... alors j'ai un peu galéré..
L'interface de base permet juste de creer un pad, ce qui est l'essentiel, mais si on veut modifier un pad déjà crée il fallait connaitre son nom...
ce qui n'est pas très pratique...
Je voulais au moins pouvoir visualiser le nom des pad déjà crées.
Je suis arrivé en bricolant un peu de html, jquery, php à avoir ça...

Je ne mettrai pas le code sur le billet.
Si vous etes interessé par cette petite page web contactez moi.
#Gnu/Linux, Planet Libre
Boot d'un kernel bzImage sur les anciennes versions de Xen < 3.4
Juste un petit arcticle, qui me sert d'aide mémoire.
Je suis tombé sur un problème:
J'ai voulut booter un DomU à base de Ubuntu 10.04LTS sur un système de virtualisation Xen 3.1
En l'ocurence il s'agissait d'une Distri SLES10SP4 + Xen 3.1
Je pensais que cela ne poserai aucun problème, j'utilise mon template DomU Ubuntu10.04LTS depuis un petit moment déjà sur des Xen plus récent.
En voulant booter ce fameux domU j'ai eut droit à l'erreur suivante:
Error: (2, 'Invalid kernel', 'xc_dom_find_loaderJ'ai cherché un bon moment, c'est comme si le Kernel n'était pas reconnu.
Et en fait je suis tombé sur cette page: https://www.globalways.net/blog/archives/76-Extracting-bzImage-from-vmlinuz.html
Il explique que Les anciennes versions de Xen ne supporte pas les nouveaux formats d'image du noyau. Wikipedia affirme que "Aucun outil spécifique existe pour décompresser le fichier bzImage».
En effet sous Ubuntu depuis la 9.10, le kernel n'est plus un simple fichier gzipé mais un bzImage.
root@ubuntults:/boot# file vmlinuz-2.6.32-37-server
vmlinuz-2.6.32-37-server: Linux kernel x86 boot executable bzImage, version 2.6.32-37-server (buildd@allspi, RO-rootFS, root_dev 0x6801, swap_dev 0x3, Normal VGA
On voit bien que le Kernel est un bzImage.
On sait que ce fameux bzimage commence par une entête spécifique. et que après il y a l'entête de gzip qui est:
ID1 0x1f
ID2 0x8b
CM 0x08 (Compression Method deflate=)
FLG 0x00 (no extra fields)
Le but: supprimer tout ce qui se trouve avant cette entête afin d'avoir un kernel basique.
Pour cela, 2 méthodes:
Celle décrite dans la page web, grace à binoffset::
L'auteur à développer une commande qui permet de trouver ce fameux offset et d'en donner son emplacement en octet
La commande est présente ici:
http://svn.opentom.org/opentom/trunk/linux-2.6/scripts/binoffset.c
Après l'avoir compilé.
gcc -o binoffset binoffset.cOn peut utiliser la commande dd:
root@ubuntults:/boot# dd if=vmlinuz-2.6.32-37-server bs=1 skip=$(/root/binoffset vmlinuz-2.6.32-37-server 0x1f 0x8b 0x08 0x0) of=vmlinuz-2.6.32-37-server-UNPACK.gzOn lit le kernel en bs de 1octet on skeep 14441 octets ( qui correspondent au debut du fichier jusqu'a ce fameux offset ) autrement dit on aura supprimer tout l'entete du bzimage et on aura un kernel gzip classique.
filesize: 4110432
number of pattern matches = 1
14441
4095991+0 records in
4095991+0 records out
4095991 bytes (4.1 MB) copied, 15.2127 s, 269 kB/s
Une fois dézippé on voit bien qu'on a kernel classique.
root@ubuntults:/boot# file vmlinuz-2.6.32-37-server-UNPACK.gz
vmlinuz-2.6.32-37-server-UNPACK.gz: gzip compressed data, from Unix,
last modified: Fri Dec 2 22:02:53 2011, max compression
root@ubuntults:/boot# gunzip vmlinuz-2.6.32-37-server-UNPACK.gz
gzip: vmlinuz-2.6.32-37-server-UNPACK.gz: decompression OK, trailing
garbage ignored
root@ubuntults:/boot# file vmlinuz-2.6.32-37-server-UNPACK
vmlinuz-2.6.32-37-server-UNPACK: ELF 64-bit LSB executable, x86-64,
version 1 (SYSV), statically linked, stripped
D'ailleurs ce kernel est reconnu aussi bien gzipé ou pas.
Méthode en bash (moins sure):
J'aurais aimé faire cela avec des commandes système basiques sans rien avoir à installer...
Après maintes commande j'ai fait ce que je voulais avec la commande suivante...
root@ubuntults:/boot# a=$(cat vmlinuz-2.6.32-37-server | xxd -g1 | grep "1f 8b 08 00" | awk -F":" '{print $1}' | sed 's/^[0\t]*//'); b=$(cat vmlinuz-2.6.32-37-server | xxd -g1 | grep "1f 8b 08 00" | awk -F":" '{print $2}' | awk -F"1f 8b 08 00" '{print $1}'| awk '{x=x+NF}END{print x}'); c=$(( $a + $b )); echo Hexa=$c ; echo Decimal=$((0x$c))
Hexa=3869
Decimal=14441
le même dd:
dd if=vmlinuz-2.6.32-37-server bs=1 skip=14441 of=vmlinuz-2.6.32-37-server-UNPACK2.gzJe n'ai as testé en profondeur, cette commande ne fonctionne pas forcément partout à mon avis.