Ce tutoriel a pour but de donner des pistes vous permettant d'optimiser au mieux, en comprenant à peu près ce que vous faites, un serveur rencontré classiquement : Apache dans sa version 2, tournant bien évidemment sur un système GNU/Linux, dans le but de servir des pages générées à l'aide de PHP.

Attention : même si ces optimisations peuvent vous faire gagner pas mal de points sur PageSpeed ou YSlow, ce tutoriel a pour unique sujet l'optimisation d'Apache. De même, il ne sera pas question ici de discuter de l'utilisation d'un autre serveur pour servir les contenus statiques voire de comparer les performances d'Apache avec d'autres serveurs web comme Lighttpd ou NGInx

Si votre serveur est déjà en production, il peut être intéressent d'effectuer un test de performances, par exemple à l'aide d'un outil en ligne, comme GTMetrix (créez un compte, vous pourrez ainsi accéder à plus d'options, et avoir un joli graphe de l'évolution des performances, c'est évidement gratuit) dès maintenant, et après chaque optimisation.

Prefork ou Worker ?

Il convient de choisir quelle « mouture » d'Apache utiliser. Ces moutures se choisissent en installant l'un des modules « core » déterminant le comportement d'Apache vis à vis des requêtes multiples et concurrentes. Sous GNU/Linux, Apache dispose de deux modules stables pour la production : MPM Prefork et MPM Worker. Les modules MPM dupliquent Apache afin de lui permettre de répondre à plusieurs requêtes simultanément.

La différence entre les deux est que là où MPM Prefork utilise uniquement des processus multiples pour prendre en charge les requêtes concurrentes, MPM Worker utilise des threads pour paralléliser les requêtes au sein même des processus multiples, offrant donc de meilleures performances mais imposant d'utiliser uniquement des module Apache supportant eux même les threads, interdisant donc l'utilisation du module mod_php, permettant à Apache d'interprêter les scripts PHP.

La configuration que nous utiliserons sera donc Apache 2 MPM Prefork avec PHP installé en tant que module (mod_php)

Certains objecterons qu'on aurait très bien pu utiliser MPM Worker et exécuter les scripts PHP via une interface CGI (mod_cgi, mod_fastcgi voire mod_speedycgi) et ils auront raion… cependant, même avec des optimisations, cette solution sera toujours moins performante que MPM Prefok avec mod_php, et l'utilisation d'accélérateurs de scripts PHP comme la mise en cache d'op-code est impossible en dehors de mod_php : lorsqu'on utilise PHP avec Apache pour un site nécessitant de la performance, mod_php est un choix plus que judicieux.

Points à améliorer

« Qu'est-ce qui pourrait bien ralentir un serveur Apache ? » Est la question à laquelle nous allons répondre afin de déterminer les points à améliorer pour permettre à Apache de servir les pages plus vite.

Accès disque

Un accès disque est toujours coûteux en temps, malgré les optimisations effectuées par le système d'exploitation. À chaque requête d'une page web, outre les accès disques effectués pour récupérer les données des fichiers à servir, d'autres accès disque sont effectués, comme par exemple l'inscription des évènements dans les fichiers log, le calcul de l'ETag mais aussi la lecture d'un fichier .htaccess ou la recherche d'un fichier d'index !

Requêtes DNS

Des requêtes DNS peuvent être effectuées par Apache lorsque, par exemple, il est configuré pour afficher les noms d'hôtes correspondant à l'adresse IP des visiteurs dans les fichiers logs. Certains modules, comme mod_defensible ou mod_rbl peuvent effectuer plusieurs requêtes DNS afin de vérifier si l'adresse IP et/ou le nom d'hôte de la connexion à Internet du visiteur fait partie ou non d'une ou plusieurs listes noires.

Taille des fichiers

Chaque octet compte : chaque octet servi par votre serveur aura un impact direct sur le temps qu'il mettra a finir de servir la ressource demandée, et la compression est non seulement très efficace sur les fichiers texte, mais elle est aussi supportée par de plus en plus de navigateurs tels que Firefox ou Safari ; ça tombe bien, Apache sais compresser à la volée les contenus à servir lorsque le navigateur le supporte.

Nombre de requêtes

Chaque connexion est coûteuse en temps et en ressources : il serait formidable de pouvoir signifier au navigateur des visiteurs que certains fichiers ne sont modifier peu souvent et qu'il peut les mettre en cache et les afficher directement au lieu d'effectuer une requête pour chacun d'eux… heureusement, Apache possède un module qui permet de gérer la manière de signifier aux navigateurs les modalités de mise en cache des fichiers selon leur type.

Configuration d'Apache

Apache a besoin d'indications pour savoir comment réagir lors des pics de charge et être suffisamment réactif. La configuration idéale pour votre serveur sera déterminée en fonction de la RAM disponible, de celle consumée par la génération des pages, du type de documents servis, mais aussi de la fréquence et du nombre des visites et du trafic. Cette configuration doit être mûrement réfléchie, certaines valeurs, choisies avec discernement peuvent sauver Apache de crash fâcheux lors de pics de visite, ou tout simplement lui permettre d'utiliser au mieux les ressources nécessaires à son fonctionnement.

Que faire ?

Maintenant que nous avons vu les éléments clés, établissons un plan d'action, le détail des actions sera vu dans la deuxième partie. Bien évidemment, tout cela est à ajuster au cas par cas, selon les besoins réels de votre serveur.

Accès disque

Afin de limiter les accès disque au strict nécessaire (la récupération des données à envoyer au client), nous allons :

• Désactiver l'utilisation des ETags
  Ce système, en plus d'être obsolète est inutile lorsqu'on active le module de gestion du cache d'Apache.
• Ne pas autoriser l'usage des fichiers .htaccess et rapatrier le contenu de ces fichiers dans les fichiers de définition des vhosts
• Réduire, vhost par vhost, le nombre de possibilités concernant le fichier d'index
• Désactiver l'option Multiview afin de gagner du temps
• Réduire le niveau d'inscription des évènements dans les fichiers logs à ce qui est réellement utile, vhost par vhost

Requêtes DNS

Afin de supprimer les requêtes DNS, nous allons :

• Faire en sorte de n'afficher que les adresses IP dans les fichiers log
• Désactiver les modules de vérification de RBL

Taille des fichiers

Afin de réduire la taille des fichiers, nous allons activer la compression dynamique en fonction du navigateur.

Nombre de requêtes

Pour diminuer le nombre de requêtes, nous allons activer et configurer le module de mise en cache pour le serveur entier et chaque vhost si besoin, en fonction du contenu, des fichiers à servir et de la fréquence de rafraichissement des données.

Configuration d'Apache

Nous allons configurer Apache à partir de données que nous allons récolter :

• La mémoire allouée à Apache
  Si le serveur héberge un serveur de bases de données comme MySQL ou d'autres services : il conviendra de déterminer quelle quantité de RAM leur réserver et de laisser le reste à Apache.
• La mémoire consommée par un processus d'Apache
  Pour déterminer la taille de cette mémoire, il faudra exécuter une série de requête (à l'aide d'un ab -n 1000 -c 10 http://votre.url par exemple) tout en exécutant un top ou htop en même temps sur le serveur.
• La durée de chargement maximal de vos pages
  À l'aide du plugin PageSpeed pour le plugin FireBug pour Firefox par exemple.

Il peut paraître curieux de se baser sur une mesure de vitesse de chargement de page, ou de mesurer la RAM utilisée par des processus afin de permettre d'accélérer Apache, mais c'est la seule manière de déterminer, par itérations successives et tâtonnements, les bonnes valeurs pour votre Apache. Il conviendra d'effectuer ces réglages après avoir effectué les autres optimisations, mais aussi après chaque modification majeure de vos scripts PHP car chaque modification modifie aussi la quantité de RAM dont ils ont besoin, donc celle nécessaire à Apache, donc ses paramètres.

Articles apparentés

• Créer un fichier PID pour Funambol sous GNU/Linux
• Quelques scripts pour profiter de son scanner sous GNU/Linux
• Configurer vsftpd pour mettre à jour automatiquement Wordpress
• Inclure ses machines virtuelles à son réseau avec VirtualBox
• Installation de Funambol couplé à Zimbra sur un serveur GNU/Linux
• Pour des sessions SSH qui durent

À l'aide d'un script bash, nous allons permettre cette création de fichier PID.

Fonctionnement du script

Rien de bien sorcier, juste une recherche des PID des différents composants du serveur Funambol à l'aide d'un bon vieux ps couplé à une paire de grep associés à un petit awk suivi d'un head... autrement dit "on recherche les processus des composants de funambol dans la liste des processus, et on récupère leurs PID".

Le script

Il y a certainement plus élégant mais l'essentiel c'est qu'il fasse ce qu'on lui demande et qu'il remplisse sa fonction didactique.

#!/bin/bash
 
# Check the script is being run by root, or die.
ROOT_UID=0
if [ "$UID" -ne "$ROOT_UID" ]
then
	echo "Run script as "root"."
	echo
	exit 1
fi
 
DS_SERVER=`ps -ef | grep ds-server | grep -v grep`
 
HYPERSONIC=`ps -ef | grep hypersonic | grep -v grep`
 
CTP_SERVER=`ps -ef | grep com.funambol.ctp.server.CTPServer | grep -v grep`
 
INBOX_LISTENER=`ps -ef | grep inbox-listener | grep -v grep`
 
PIM_LISTENER=`ps -ef | grep pimlistener | grep -v grep`
 
if [ -z "$DS_SERVER" ]
then
	if [ -e /opt/funambol/ds-server.pid ]; then
		rm /opt/Funambol/ds-server.pid
	fi
else
	ps -ef | grep ds-server | grep -v grep | awk '{print $2}' | head -n 1 > /opt/Funambol/ds-server.pid
fi
 
if [ -z "$HYPERSONIC" ]
then
        if [ -e /opt/funambol/hypersonic.pid ]; then
                rm /opt/Funambol/hypersonic.pid
        fi
else
        ps -ef | grep hypersonic | grep -v grep | awk '{print $2}' | head -n 1 > /opt/Funambol/hypersonic.pid
fi
 
if [ -z "$CTP_SERVER" ]
then
        if [ -e /opt/funambol/ctp-server.pid ]; then
                rm /opt/Funambol/ctp-server.pid
        fi
else
        ps -ef | grep com.funambol.ctp.server.CTPServer | grep -v grep | awk '{print $2}' | head -n 1 > /opt/Funambol/ctp-server.pid
fi
 
if [ -z "$INBOX_LISTENER" ]
then
        if [ -e /opt/funambol/inbox-listener.pid ]; then
                rm /opt/Funambol/inbox-listener.pid
        fi
else
        ps -ef | grep inbox-listener | grep -v grep | awk '{print $2}' | head -n 1 > /opt/Funambol/inbox-listener.pid
fi
 
if [ -z "$PIM_LISTENER" ]
then
        if [ -e /opt/funambol/pim-listener.pid ]; then
                rm /opt/Funambol/pim-listener.pid
        fi
else
        ps -ef | grep pimlistener | grep -v grep | awk '{print $2}' | head -n 1 > /opt/Funambol/pim-listener.pid
fi

Utilisation

En appelant ce script via une tache cron, par exemple, vous permettrez aux système de monitoring d'avoir un pid à jour en cas de redémarrage.

Il est aussi possible de créer un script de commande pour (re)lancer/arrêter Funambol afin de créer/détruire ces fichiers PID au démarrage/arrêt de Funambol. Voici un exemple d'un tel script, où le script précédent (celui qui crée les PID) est dans /opt/controls/mk-funambol-pid-file :

#!/bin/bash
 
# Check the script is being run by root, or die.
ROOT_UID=0
if [ "$UID" -ne "$ROOT_UID" ]
then
	echo "Run script as "root"."
	echo
	exit 1
fi
 
FUNAMBOL=`ps -ef | grep /opt/Funambol | grep -v grep`
 
if [ -z "$FUNAMBOL" ]
then
	FUNAMBOL_ON=0
else
	FUNAMBOL_ON=1
fi
 
case $1 in
start)
	if [ $FUNAMBOL_ON -eq 1 ]
	then
		echo "Funambol is already started : use $0 restart option to restart."
		echo
		exit 1
	else
		echo "Starting Funambol..."
		/opt/Funambol/bin/funambol start
		echo "done."
		echo
		echo "Creating PID files..."
		/opt/controls/mk-funambol-pid-file
		echo "done."
		echo
	fi
	;;
stop)
        if [ $FUNAMBOL_ON -eq 0 ]
	then
                echo "Funambol is already stopped."
                echo
                exit 1
        else
                echo "Stopping Funambol..."
                /opt/Funambol/bin/funambol stop
                echo "done."
		echo
                echo "Deleting PID files..."
                /opt/controls/mk-funambol-pid-file
                echo "done."
                echo
        fi
	;;
restart)
        if [ $FUNAMBOL_ON -eq 0 ]
	then
		echo "Funambol was already stopped !"
		echo
                echo "Starting Funambol..."
                /opt/Funambol/bin/funambol start
                echo "done."
		echo
                echo "Creating PID files..."
                /opt/controls/mk-funambol-pid-file
                echo "done."
                echo
	else
                echo "Stopping Funambol..."
                /opt/Funambol/bin/funambol stop
                echo "done."
		echo
                echo "Deleting PID files..."
                /opt/controls/mk-funambol-pid-file
                echo "done."
		echo
		echo
                echo "Starting Funambol..."
                /opt/Funambol/bin/funambol start
                echo "done."
		echo
                echo "Creating PID files..."
                /opt/controls/mk-funambol-pid-file
                echo "done."
                echo
        fi
	;;
status)
        if [ $FUNAMBOL_ON -eq 0 ]
        then
                echo "Funambol is curently stopped."
                echo
        else
                echo "Funambol is curently started."
                echo
        fi
        ;;
*)
	echo "Usage $0 [start|stop|restart|status]"
	;;
esac

Ce script permet, en outre, de permettre un redémarrage direct de Funambol.

Exemple d'application : configuration de Monit pour Funambol

Considérant que nous avons les 2 scripts précédent, l'un dans /opt/controls/mk-funambol-pid-file et l'autre dans /opt/controls/funambol, on pourra utiliser, par exemple, la configuration suivante pour Monit :

# Funambol
check process ds-server with pidfile /opt/Funambol/ds-server.pid
        group funambol
        start program "/opt/controls/funambol start"
        stop program "/opt/controls/funambol stop"
        if failed port 8443 for 3 times within 3 cycles then restart
        if 2 restart within 10 cycles then timeout
check process hypersonic with pidfile /opt/Funambol/hypersonic.pid
        group funambol
check process ctp-server with pidfile /opt/Funambol/ctp-server.pid
        group funambol
check process inbox-listener with pidfile /opt/Funambol/inbox-listener.pid
        group funambol
check process pim-listener with pidfile /opt/Funambol/pim-listener.pid
        group funambol

Ici funambol utilise une connexion sécurisée sur le port 8443 comme indiqué dans le tutoriel d'installation de Funambol, nous monitorons donc ce port.

Grâce aux pid, nous pourrons voir sur l'interface web de Monit les ressources consommées par les composants de Funambol, et éventuellement créer des règles dans le cas où cette consommation deviendrait excessive.

Articles apparentés

• Quelques scripts pour profiter de son scanner sous GNU/Linux
• Installation de Funambol couplé à Zimbra sur un serveur GNU/Linux
• Optimiser Apache – Partie 1
• Configurer vsftpd pour mettre à jour automatiquement Wordpress
• Inclure ses machines virtuelles à son réseau avec VirtualBox
• Pour des sessions SSH qui durent

Le problème c'est qu'autant les scanners sont bien supportés en tant que tels, autant leurs boutons sont excessivement peu souvent supportés.

Certains, comme moi, seront certainement très frustrés de ne pas pouvoir utiliser les très utiles boutons de leur appareil, et je me suis dit que quelques petits scripts seraient certainement utiles à d'autres.

Attention : j'utilise Gnome, et les scripts suivants utilisent zenity. Si vous êtes sous KDE, mieux vaut utiliser kommander (je vous laisse le soin d'adapter les scripts), mais vous pouvez très bien utiliser zenity… ça sera moins bien intégré, c'est tout.

Un préalable au bon fonctionnement de ces scripts est, bien entendu, qu'un scanner soit déjà connecté à la machine, et que se scanner soit reconnu et configuré… en plus, pour le premier, d'avoir une imprimante connectée, allumée, et configurée.

Comme d'habitude, un petit tour dans le man ne fera de mal à personne.

Photocopie

Dépendances : tiff2ps (paquet libtiff-tools), zenity (ou kommander)
Ce que fait le script : scanne vers un fichier TIFF, le convertit en PostScript et imprime le résultat.

#!/bin/bash
if `zenity --question --text="Assurez-vous d'avoir aligné le document sur le bord DROIT de la fenêtre puis cliquez sur «Valider»" --title="Photocopier un document"`
then
	scanimage --format tiff --mode Gray --resolution 300 -l 0 -t 0 -x 210mm -y 297mm -p > tmp.tiff
	tiff2ps -z -w 8.27 -h 11.69 tmp.tiff | lpr
	rm -f tmp.tif
else
	zenity --info --text="Photocopie annulée"
fi

Scan2PDF

Dépendances : tiff2pdf (paquet libtiff-tools), zenity (ou kommander), evince (kpdf sous kde)
Ce que fait le scritpt : scanne vers un fichier TIFF, le convertit en PDF et l'enregistre là où l'a indiqué l'utilisateur. Si l'utilisateur le souhaite, l'affiche à l'écran.

#!/bin/bash
 
if `zenity --question --text="Assurez-vous d'avoir aligné le document sur le bord DROIT de la fenêtre puis cliquez sur «Valider»" --title="Scanner un document vers PDF"`
then
    pdf=$(zenity --file-selection --save --confirm-overwrite --filename="$HOME/Desktop/scan.pdf")
    if [[ -n $pdf ]]
    then
        scanimage --format tiff --mode Gray --resolution 300 -l 0 -t 0 -x 210mm -y 297mm -p > tmp.tiff
        tiff2pdf -o $pdf -z -p A4 -r d -c scan2pdf -a $(whoami) ./tmp.tiff
        rm -f tmp.tiff
        if `zenity --question --text="Le document va s'ouvrir" --title="Scan terminé"`
        then
            evince $pdf
        fi
    else
        zenity --info --text="Copie annulée"
    fi
else
    zenity --info --text="Copie annulée"
fi

Scan2Gimp

Dépendances : zenity (ou kommander),tempfile gimp
Ce que fait le scritpt : scanne vers un fichier TIFF sauvegardé sur le bureau avec un nom unique et l'ouvre avec Gimp.

#!/bin/bash
 
if `zenity --question --text="Assurez-vous d'avoir aligné le document sur le bord DROIT de la fenêtre puis cliquez sur «Valider»" --title="Scan vers Gimp"`
then
    tmp="$(tempfile -d "$HOMEDesktop" -p "scan-" -s ".tiff")"
    scanimage --format tiff --mode Gray --resolution 300 -l 0 -t 0 -x 210mm -y 297mm -p > $tmp
    gimp $tmp
else
    zenity --info --text="Scan annulé"
fi

Articles apparentés

• Créer un fichier PID pour Funambol sous GNU/Linux
• Optimiser Apache – Partie 1
• Ressources graphiques
• Configurer vsftpd pour mettre à jour automatiquement Wordpress
• Inclure ses machines virtuelles à son réseau avec VirtualBox
• Un nuancier Pantone® en ligne
• Installation de Funambol couplé à Zimbra sur un serveur GNU/Linux
• Pour des sessions SSH qui durent

WordPress, intègre des possibilités de mise à jour automatique des plugins en utilisant le protocole FTP. Certains se poseront la question du pourquoi de l'utilisation de FTP pour cela alors que PHP est très à même de télécharger des fichiers depuis l'internet et lancer des commandes shell pour décompresser les archives, sans parler de la gestion des fichiers, mais ça n'est pas l'objet de cet article.

Afin de pouvoir utiliser cette fonctionnalité de mise à jour de WordPress, il vous faut un serveur FTP sur votre serveur. Je vais vous proposer vsftpd (pour Very Secure File Transfert Protocol Deamon : Service de Transfert de Fichiers Trés Sécurisé) alors que d'autres sont de fervents adeptes de Proftp. Ce choix s'explique par deux arguments, le premier étant la sécurité qu'il apporte (RedHat, OpenBSD et SuSE, notamment, l'utilisent pour leurs serveurs FTP publics), le deuxième étant sa simplicité de configuration.

Vsftpd permet de créer des utilisateurs virtuels Ces utilisateurs virtuels utilisent sur le système l'identité de l'utilisateur “ftp” pour effectuer les opérations sur le système de fichiers. Vsftpd permet aussi de n'écouter que certaines interfaces, ce qui nous permettra de sécuriser totalement notre serveur.

Comme d'habitude, nous allons prendre l'exemple d'une distribution basée sur Debian (Debian, Ubuntu et dérivés…) la première chose à faire étant d'installer vsftpd via un sudo apt-get install vsftpd (ou autre, selon votre distribution).

En suite, trois choses à configurer : PAM pour permettre l'utilisation des utilisateurs virtuels, vsftpd lui même par le biais de son fichier de configuration et les utilisateurs virtuels.

Enfin il conviendra de modifier quelque peu les droits d'écriture de certains répertoires et fichiers.

1. Configuration de PAM

Il faut, si ces bibliothèques ne sont pas déja présentes, installer le support des bases de données Berkeley : libdbX et dbX-util où X = la version, 4.4, 4.6 ou 4.7 soit, par exemple, sudo apt-get install libdb4.6 db4.6-util.

En suite, configurer PAM pour lui dire où chercher les informations de connexion : éditer le fichier /etc/pam.d/vsftpd (le créer si besoin, le vider si déjà présent) et y mettre :

auth required /lib/security/pam_userdb.so db=/etc/vsftpd/login
account required /lib/security/pam_userdb.so db=/etc/vsftpd/login

Si vous êtes en 64 bits, il conviendra peut être de remplacer lib par lib64.

Aller dans le répertoire /etc/vsftpd (le créer si besoin), et créer un fichier “login.txt” qui contiendra, en clair, les login et mots de passe de tous les utilisateurs virtuels. Ce fichier est de la forme :

login1
mot de passe de login1
login2
mot de passe de login2
…

Pour WordPress, on va y mettre, par exemple :

wordpress
wp-pass

Il faut en suite convertir ce fichier en base de données Berkeley à l'aide de la commande :

sudo db4.6_load -T -t hash -f /etc/vsftpd/login.txt /etc/vsftpd/login.db

Remarque : il conviendra de remplacer db4.6_load par db4.4_load ou db4.7_load selon la version disponnible.

Note: certains se demandent pourquoi faire ça (écrire les mots de passe dans un fichier en clair et le convertir en db) et ne pas directement utiliser le fichier en clair : c'est simplement qu'il sera, par la suite, plus simple pour ouvrir le serveur ftp au public. Il suffira de faire un chmod à 600 sur ces fichiers et/ou de supprimer la version en clair.

2. Configuration de vsftpd

Sauvegarder /etc/vsftpd.conf (par, par exemple un petit sudo cp /etc/vsftpd.conf /etc/vsftpd.conf.bak), l'éditer, le vider et y mettre :

# Lancement de vsftpd en standalone
listen=YES
# vsftpd ne va accepter les connexion uniquement depuis le serveur lui même
listen_address=127.0.0.1
# activation des utilisateurs locaux (permet d'utiliser les utilisateurs virtuels)
local_enable=YES
# Afin de permettre la mise à jour, il *faut* permettre l'écriture
write_enable=YES
# activation explicite des utilisateurs virtuels
guest_enable=YES
# force les utilisateurs virtuels d'agir vis à vis du système comme l'utilisateur
guest_username=ftp
# force les utilisateurs à rester dans le ~ de l'utilisateur guest (spacifié juste au dessus soit '/home/ftp/')
chroot_local_user=YES
# active la configuration 'per user" permettant, de créer plusieurs utilisateurs virtuels si besoin par la suite, pour un autre WordPress par exemple
user_config_dir=/etc/vsftpd/users

Attention : si vous souhaitez, par la suite, ouvrir votre serveur ftp au public, veuillez ré-utiliser le fichier de configuration initial et le compléter avec les éléments de cet exemple. En effet, étant donné que notre WordPress est sur le même serveur que le serveur FTP, on n'a pas besoin de restreindre la sécurité outre mesure, ce qui ne convient évidement pas à une utilisation “publique”

3. Configuration des utilisateurs

On va utiliser ici une configuration “per user” qui permet de modifier la configuration pour chaque utilisateur virtuel (cas où on utilise plusieurs installations de WordPress sur le même serveur). Pour se faire, il nous faut simplement créer un fichier pour chaque utilisateur dans /etc/vsftpd/users (qu'il faudra créer via sudo mkdir /etc/vsftpd/users)

Nous avons créé plus haut un utilisateur nommé “wordpress”, créons donc ce fichier en le nommant “wordpress” : sudo nano /etc/vsftpd/users/wordpress et mettons ce qui suit dedans :

# l'utilisateur doit être enfermé dans un dossier contenu dans /home/ftp
# ce dossier sera un lien symbolique vers la racine (contenant le dossier wp-content)
# de votre installation de WordPress
local_root=/home/ftp/wordpress
# droit d'écriture
write_enable=YES
anon_upload_enable=YES
# droit créer des dossiers
anon_mkdir_write_enable=YES
# droit de renommer, supprimer...
anon_other_write_enable=YES
# signifie que l'utilisateur virtuel à les mêmes droits que l'utilisateur réel (ici ftp)
virtual_use_local_privs=YES
# définit l'umask pour les fichiers
local_umask=022

En suite il faut créer le lien symbolique dans /home/ftp, dans le fichier de configuration, nous avons spécifié “/home/ftp/wordpress”. Ce lien symbolique va devoir pointer vers le dossier racine de votre installation de WordPress (contenant wp-content) mettons /home/www/blog/, ce qui donne : sudo ln -s /home/www/blog /home/ftp/wordpress

4. Droits utilisateur

Il faut permettre à l'utilisateur ftp de créer des dossiers et des fichiers dans le dossier wp-content/upgrade (qu'il faudra créer, car il n'existe pas par défaut à moins que vous ne donniez ces droits au dossier wp-content). Même chose à tous les dossiers/fichiers contenus dans le dossier wp-content/plugins
Je vous laisse faire, après tout, si vous êtes arrivés jusqu'ici c'est que vous en êtes capable normalement.

5. Redémarrage de vsftpd et tests

Redémarrer vsftpd via sudo /etc/init.d/vsftpd restart et tester la mise à jour des plugins de WordPress : pour se faire, si vous n'avez pas de plugin à mettre à jour, vous pouvez toujours télécharger une ancienne version d'un plugin et chercher à le mettre à jour.

Dans WordPress, allez dans le menu “Extentions”, et cliquez sur “mise à jour automatique” sur la ligne d'un plugin à mettre à jour. Un formulaire apparaît, entrez-y “127.0.0.1” comme hôte, “wordpress” comme login, “wp-pass» comme mot de passe, et cochez “FTP” puis "mettre à jour". Si vous voyez une erreur lors de la mise à jour, lisez bien le message renvoyé par WordPress : il vous renseignera exactement sur ce qui ne va pas. Si WordPress n'arrive pas à créer ou supprimer un fichier/dossier dans un répertoire, vérifiez les droits, le plus souvent les problèmes viennent de là.

Si les droits s'emblent ok, vérifiez le fonctionnement du serveur directement avec le client ftp en ssh : une session "réussie" devrait ressembler à ça :

$ ftp 127.0.0.1
Connected to 127.0.0.1.
220 (vsFTPd 2.0.6)
Name (127.0.0.1:modulaweb): wordpress
331 Please specify the password.
Password:
230 Login successful.
Remote system type is UNIX.
Using binary mode to transfer files.
ftp> ls
200 PORT command successful. Consider using PASV.
150 Here comes the directory listing.
-rwxrwxr-x    1 1002     33            397 May 25  2008 index.php
-rwxrwxr-x    1 1002     33          15410 Dec 06 07:47 license.txt
-rwxrwxr-x    1 1002     33           7638 Oct 29  2008 readme.html
drwxrwxrwx    3 1002     33           4096 May 17 13:20 upgrade
drwxrwxr-x    2 1002     33           4096 Apr 30 10:33 util
drwxrwxr-x    8 1002     33           4096 Apr 15 03:36 wp-admin
-rwxrwxr-x    1 1002     33          40271 Nov 28 21:04 wp-app.php
-rwxrwxr-x    1 1002     33            220 Oct 14  2008 wp-atom.php
-rwxrwxr-x    1 1002     33            274 May 25  2008 wp-blog-header.php
-rwxrwxr-x    1 1002     33           3483 Apr 16 23:27 wp-comments-post.php
-rwxrwxr-x    1 1002     33            238 Oct 14  2008 wp-commentsrss2.php
-rwxrwxr-x    1 1002     33           2497 Dec 16 08:33 wp-config-sample.php
-rwxrwxr-x    1 1002     33           2702 May 02 02:47 wp-config.php
drwxrwxr-x    7 1002     33           4096 May 17 13:39 wp-content
-rwxrwxr-x    1 1002     33           1242 Sep 18  2008 wp-cron.php
-rwxrwxr-x    1 1002     33            220 Oct 14  2008 wp-feed.php
drwxrwxr-x    6 1002     33           4096 May 01 16:19 wp-includes
-rwxrwxr-x    1 1002     33           1986 May 25  2008 wp-links-opml.php
-rwxrwxr-x    1 1002     33           2004 Oct 31  2008 wp-load.php
-rwxrwxr-x    1 1002     33          19738 Dec 03 19:04 wp-login.php
-rwxrwxr-x    1 1002     33           6932 Dec 09 18:03 wp-mail.php
-rwxrwxr-x    1 1002     33            487 May 25  2008 wp-pass.php
-rwxrwxr-x    1 1002     33            218 Oct 14  2008 wp-rdf.php
-rwxrwxr-x    1 1002     33            316 May 25  2008 wp-register.php
-rwxrwxr-x    1 1002     33            218 Oct 14  2008 wp-rss.php
-rwxrwxr-x    1 1002     33            220 Oct 14  2008 wp-rss2.php
-rwxrwxr-x    1 1002     33          18695 Jan 24 13:21 wp-settings.php
-rwxrwxr-x    1 1002     33           3434 May 25  2008 wp-trackback.php
-rwxrwxr-x    1 1002     33          92428 Jan 19 18:47 xmlrpc.php
226 Directory send OK.
ftp> exit
221 Goodbye.

N'hésitez pas à faire des suggestions ou remarques en commentaire.

Articles apparentés

• Créer un «dummy-package» sous Debian ou Ubuntu
• Pour des sessions SSH qui durent
• Optimiser Apache – Partie 1
• Créer un fichier PID pour Funambol sous GNU/Linux
• Quelques scripts pour profiter de son scanner sous GNU/Linux
• Inclure ses machines virtuelles à son réseau avec VirtualBox
• Installation de Funambol couplé à Zimbra sur un serveur GNU/Linux
• Lancer Ubuntu dans VirtualBox

L'exemple ici fonctionne sous une Debian (ou Ubuntu), adaptez-le selon votre propre système.

La méthode présentée ici est la méthode statique... on aurait pu utiliser une méthode qui crée/détruit les interfaces de manière dynamique, mais le but ici est de faire en sorte de comprendre un minimum ce qui est fait, et le succès de la méthode statique conditionne celui de la méthode dynamique... qui fera (peut être) l'objet d'un prochain article)

Voici la marche à suivre :

→ installer le paquet "bridge-utils"

→ éditer /etc/network/interfaces et y créer une nouvelle interface (le bridge) qui sera rattachée à une interface physique existante :

auto eth0
iface eth0 inet dhcp # ici eth0 obtient son adresse IP via DHCP
# Création du pont :
auto br0
iface br0 inet dhcp # br0 permettra à la machine virtuelle de d'obtenir son adresse IP via DHCP
        bridge_ports eth0
        bridge_fd 2

bridge_ports permet de lier la connexion en pont sur l'interface eth0 qui a été configurée en dhcp
bridge_fd correspond au temps d'apprentissage de l'adresse ip de l'interface (entre le learning et le forwarding state)
D'autres options existent, mail elles dépassent largement le cadre de cet article.

→ Redémarrer le réseau pour prendre en compte le pont via :

sudo /etc/init.d/networking restart

La chose intéressante, c'est que, comme tout a été configuré via DHCP, on peut ajouter autant de ponts que nécessaire, et laisser le serveur dhcp (celui du routeur par exemple) attribuer les adresses IP en fonction des règles qu'on y aura défini (selon l'adresse MAC par exemple).

→ Faire en sorte que l'utilisateur qui lancera les VM possède les droits suffisants sur le TUNnel :

sudo chown [votre utilisateur] /dev/net/tu

→ Il faut désormais créer l'interface dans VirtualBox (on le fait ici de manière statique) via la commande suivante :

VBoxAddIF vbox0 [votre utilisateur] br0

L'interface est stockée dans le fichier /etc/vbox/interfaces, et se ra pérenne entre un lancement de VM et un autre.
→ Il faut maintenant paramétrer correctement notre VM en spécifiant :

→ attaché à "Adaptateur réseau hôte"

→ Nom de l'interface "vbox0"

Au démarrage de la VM, le server DHCP attribuera une adresse IP à cette interface et vous pourrez accéder à votre VM, non seulement via la machine hôte, mais depuis tout le réseau, et, éventuellement, router certains ports vers la VM.
Notez qu'on aurait très bien pu fixer une adresse IP dans le fichier /etc/network/interfaces

Articles apparentés

• Optimiser Apache – Partie 1
• Créer un fichier PID pour Funambol sous GNU/Linux
• Quelques scripts pour profiter de son scanner sous GNU/Linux
• Configurer vsftpd pour mettre à jour automatiquement Wordpress
• Installation de Funambol couplé à Zimbra sur un serveur GNU/Linux
• Lancer Ubuntu dans VirtualBox
• Pour des sessions SSH qui durent
• Cloner un disque VirtualBox

La version open-source de Zimbra ne comprend pas de modules de synchronisation, il est cependant possible de synchroniser son PDA ou son smartphone avec cette version de Zimbra en utilisant un autre logiciel libre : Funambol.

L'installation du serveur Funambol n'est pas compliquée en elle même, mais les paramétrages nécessaires à son couplage à Zimbra ne sont pas très évidents.

Ce tutoriel s'adresse à celles et ceux qui viennent d'installer un serveur Zimbra fonctionnel et qui souhaitent lui ajouter des fonctionnalités de synchronisation de contacts et d'agendas.

Le serveur Funambol, est une suite logicielle (comme Zimbra) écrite en Java permettant la synchronisation de données (agendas, carnet d'adresses, tâches...) comprenant :

→ un serveur de synchronisation de données (ou ds-server pour Data Syncronization Server)

→ un serveur de gestion des périphériques (ou dm-server pour Device Manager Server)

→ un serveur de connecteurs permettant à Funambol de dialoguer avec d'autres serveurs, comme Zimbra

Concrètement, il se place entre un client compatible avec Funambol (un client SyncML traditionnellement ou un client Funambol) et un serveur (ici Zimbra) et dialogue avec ce dernier grâce à un "connecteur" qui lui est spécifique.

Il existe des clients Funambol rendant la synchronisation aisée avec le serveur pour (presque ?) tous les terminaux mobiles (smartphones, pda, blackberry, iPhone...), clients logiciels (Thunderbird, Outlook) et serveurs (OpenExchange, Exchange). Il faut noter que les smartphone sous SymbianOS sont nativement compatibles (car utilisant SyncML).

Il conviendra donc d'installer le serveur Funambol dans un premier temps, puis d'y installer le connecteur lui permettant de dialoguer avec Zimbra, puis de paramétrer Funambol pour accepter le certificat auto-signé du Zimbra (si le certificat émane d'une "Autorité de Certification", ça ne sera pas nécessaire), enfin de configurer le serveur Funambol pour récupérer les bonnes données et les servir correctement.

Bien évidement la connexion finale entre le client et Funambol devra se faire via le protocole HTTPS, et utilisera un login et un mot de passe : la sécurité passe avant tout.

Note : On utilise ici les versions open-sources de Zimbra et Funambol. On considèrera, que les seux suites sont installées sur le même serveur (ce qui est le cas le plus pratique et le plus logique).

Note : à l'heure où est écrit ce tutoriel, Zimbra en est à la version 5, Funambol à la version 7 et le connecteur Zimbra pour Funabol à la version 5.1. Nous nous baserons sur ces versions, bien que des conseils puissent être donnés pour d'autres versions de ces serveurs.

1. Téléchargement du binaire d'installation

Se rendre sur la page suivante, https://www.forge.funambol.org/download/ et vérifier la version actuelle de Funambol, si elle diffère de 8.0 GA, veuillez modifier l'URL de téléchargement en fonction (choisir "Linux Server", cliquer sur "no thanks..." puis faire un [click-droit] et choisir "Copier l'adresse du lien") pour récupérer cette URL

Dans la console, taper :

cd /usr/src
sudo wget http://download.forge.objectweb.org/sync4j/funambol-8.0.0.bin -O ./funambol.bin

sudo chmod a+x funambol.bin
sudo ./funambol.bin

Placer les fichiers téléchargés et les sources dans /usr/src est toujours une bonne idée, car ça permet de garder les sources fraîches en cas de besoins.

2. Installation du serveur Funambol

Le processus d'installation commence par la lecture de la licence :

→ presser [espace] plusieurs fois pour faire défiler, puis à la question "Do you agree to the above license terms? [yes or no]" répondre "yes[entrée]",

→ presser [entrée] une nouvelle fois pour répondre à la question "Directory to extract Funambol [/opt] ?"

Le dépaquetage des fichiers du serveur funambol débute et est assez longue (dépend de la puissance du serveur, peut durer plus de 5 minutes par étape) ; vont apparaître, l'un après l'autre les messages "Unpacking..." puis "Checksumming..." puis "Extracting... to /opt/Funambol"

→ Le programme d'installation demande si on souhaite démarrer le serveur ("Do you want to start the server? [yes or no]") répondre par l'affirmative ("yes[entrée]") : l'installation du serveur proprement dit est terminée.

Il faut continuer en installant le connecteur Zimbra qui permettra à Funambol de dialoguer directement avec Zimbra.

Note : dans la suite de ce document, sera noté [funambol] le dossier d'installation du serveur Funambol, traditionnellement : /opt/Funambol

3. Téléchargement du connecteur Zimbra

Télécharger la dernière version du connecteur Zimbra pour Funambol à cette adresse :

http://sourceforge.net/projects/zimbrafunambol/

Pour récupérer l'adresse du fichier :

→ cliquer sur "View all files"

→cliquez sur le lien pointant vers le fichier .s4j

→ Annuler le téléchargement, et repérer le lien "direct link" : y vaire un [click-droit] et choisir "Copier l'adresse du lien"

Dans la console taper : (normalement on est toujours dans /usr/src)

sudo wget [adresse du fichier .s4j] -O ZimbraConnector.s4j

4. Installation du connecteur Zimbra

→ copier le connecteur dans le dossier des modules du serveur Funambol :

sudo cp ./ZimbraConnector.s4j [funambol]/ds-server/modules/

→ au delà de la version 0.4.65 de ce connecteur (à l'heure ou ce tutoriel est écrit, la version du connecteur est 0.5.02), il faudra créer un fichier de configuration.

Pour la version 6.5 de Funambol, le fichier de configuration se trouvera dans [funambol]/ds-server/config/connector (créer le dossier s'il n'existe pas).

Pour la version 7 et 8 de Funambol, le fichier de configuration se trouvera dans [funambol]/config/connector (créer le dossier s'il n'existe pas).

Le fichier de configuration aura pour nom "ZimbraConnector.xml" et devra avoir le contenu suivant :

<?xml version="1.0" encoding="UTF-8"?>
<java version="1.5.0" class="java.beans.XMLDecoder">
<object class="ru.korusconsulting.connector.config.ConnectorConfig">
  <void property="dataSource">
    <string>jdbc/fnblds</string> <!--La source de données pour Funambol-->
  </void>
</object>
</java>

→ Ajout du connecteur à la liste des connecteurs utilisables par le serveur Funambol :

Il faut éditer le fichier "install.properties" se trouvant dans [funambol]/ds-server (avec nano par exemple) et rechercher la ligne commençant par "modules-to-install" (traditionnellement la dernière) et ajouter le connecteur Zimbra (ZimbraConnector) à la liste (sans oublier la virgule), cela devrait ressembler à :

#
# Modules definitions
#
modules-to-install=content-provider-8.0.0,email-connector-8.0.0,foundation-8.0.0,phones-support-8.0.0,webdemo-8.0.0,ZimbraConnector

→ Activation du connecteur : (Attention, serveur Funambol version 7 et supérieures seulement, pour le 6.5, vérifier la présence des fichiers, s'ils ne sont pas à l'endroit décrit, vérifier leur présence dans [funambol]/ds-server, et la présence éventuelle d'une extension ".sh" ; le install-modules.cmd est fait pour Windows...)

Taper simplement les commandes suivantes :

cd [funambol]
sudo bin/install-modules

Après quelques secondes, les messages suivants apparaîtrons (peut varier selon les versions) :

[echo] Funambol Data Synchronization Server will be installed on the Tomcat 6.0.x application server

[echo] Undeploying funambol...
[echo] Pre installation for modules content-provider-8.0.0,email-connector-8.0.0,foundation-8.0.0,phones-support-8.0.0,webdemo-8.0.0,ZimbraConnector
[echo] content-provider-8.0.0 pre-installation...
[echo] content-provider-8.0.0 pre-installation successfully completed

[...]

[echo] ZimbraConnector pre-installation...
[echo] ZimbraConnector pre-installation successfully completed

[echo] Copying configuration files

S'en suit une série de question vous demandant, pour chaque connecteur, si vous souhaitez re-créer la base de données, répondre "y" écrasera l'éventuelle configuration existante : sur un serveur fraîchement installé, répondre "y" permet de s'assurer que tout est en ordre, sur un serveur déjà en production, il convient de répondre "n" à tous les connecteurs, sauf le dernier : celui pour Zimbra, pour lequel s'affichera le message suivant, en toute fin de processus :

[echo] ZimbraConnector installation...
[echo] Database installation for module ZimbraConnector on hypersonic (/opt/Funambol/ds-server)

[iterate] The Funambol Data Synchronization Server installation program can now create
[iterate] the database required by the module ZimbraConnector (if any is needed).

[iterate] You can skip this step if you have already a valid database created
[iterate] or the module does not require a database.

[iterate] If you choose 'y' your existing data will be deleted.

[iterate] Do you want to recreate the database?
[iterate]       (y,n)

Répondre "y", le processus se termine ainsi :

[echo] ZimbraConnector installation successfully completed

[war] Warning: selected war files include a WEB-INF/web.xml which will be ignored (please use webxml attribute to war task)
[echo] Remove output dir

BUILD SUCCESSFUL
Total time: 4 minutes 48 seconds

Ne pas tenir compte du "Warning"... le serveur Funambol est maintenant installé, mais pas encore configuré... et oui, le processus prend moins de 5 minutes

Re-lancer le serveur Funambol via

sudo [funambol]/bin/funambol start

5. Configuration du serveur Funambol

Pour configurer le serveur Funambol, il existe un outil dédié : l'Administration Tool (Outils d'Administration graphique)

Sous GNU/Linux

→ Se rendre sur : https://www.forge.funambol.org/servlets/OCNDirector?id=V8FUNADMLIN, cliquer sur «No thanks - please take me straight to the downloads!», ça se télécharge tout seul

→ Décompresser l'archive où vous voulez

→ Si un environement Java est présent, lancer directement [répertoire où a été décompressé l'archive]/admin/bin/funamboladmin, si non, installer un environnement Java avant...

Sous Windows™

Testé avec succès sous XP SP2+. (merci de vous signaler si vous utilisez Vista ou Seven)

Même chose qu'au dessus mais avec l'adresse suivante : https://www.forge.funambol.org/servlets/OCNDirector?id=V8FUNADMWIN,

→ Lancer l'outil d'administration en cliquant sur ton icône dans le menu Démarrer » Programmes

Sous Mac™ OS X 10.5 (Leopard)

Non testé : merci de vous signaler si vous utilisez cette version

Même chose qu'au dessus mais avec l'adresse suivante : https://www.forge.funambol.org/servlets/OCNDirector?id=V8FUNADMOSX,

→ Lancer l'outil d'administration via le "Finder"

Tous OS : configuration

→ double-cliquer sur "Funambol Administration Tool" dans la zone de gauche et entrer les informations :

par défaut, le domaine de votre propre machine est spécifié dans le champ Hostname/IP. Si vous utilsez un serveur dédié (vous devriez), placer ici son nom d'hôte ou son adresse IP puis connectez-vous... ça prend quelques secondes (Le login et mot de passe sont pré-replis et bons)

Si le serveur renvoit une erreur à ce moment là, veuillez vérifier que le serveur Funambol est lancé et actif sur le serveur en vérifiant ce que retourne la commande :

sudo ps aux | grep funambol

qui doit retourner une liste de processus (au moins 6) indiquant que le serveur Funambol est lancé ; si le serveur n'est pas lancé, effectuez un

sudo [funambol]/bin/funambol start

Vérifiez aussi le nom d'hôte entré ou l'adresse IP (faites un ping sur le nom ou l'adresse depuis la machine qui lance l'Administration Tool)

→ double-cliquer sur le nom d'hôte/ip qui viens de s'afficher : vous verrez un arbre avec comme entrées :

→ Server settings

→ Users

→ Devices

→ Principals

→ Modules

→ Double-cliquer sur "Modules", puis "foundation", puis "FunambolFoundationConnector" puis,

→ dans "Pim Calendar SyncSource", faire un click-droit et choisissez "delete" sur :

→ "cal", "event", "scal", "stask" et "task"

→ dans "Pim Contact SyncSource", faire un click-droit et choisissez "delete" sur :

→ "card" et "scard"

→ Il faut maintenant ajouter les sources de données dans le connecteur Zimbra :

double-cliquer sur "zimbra" puis "FunambolZimbraConnector" puis faire un clic droit sur "CalendarSyncSource" et choisir "Add sync source" : un formulaire apparaît dans la zone de droite vous permettant d'ajouter une source d'informations pour la synchronisation.
Ce formulaire est composé de 3 champs (“source URI”, “Name” et ”Zimbra URL”) une case à cocher (“is Task”) et un bouton "Add" (ou “Save” lors de l'édition).
Il faut créer 5 sources de destination (“cal”, “scal”, “task”, “stask” et “event”).

À ce stade, il est important de connaître le comportement du serveur Zimbra : soit vous vous y connectez en http, soit en https, soit les 2 (http ou https indifféremment) ou redirection (lorsque vous vous y connectez en http, il vous reconnecte en https). Cela est vraiment important si vous utilisez un certificat auto-signé (ce qui est le cas la plus part du temps), et ça vous permettra de savoir ce qu'il convient de renseigner dans le champ "Zimbra URL" du formulaire.

Si votre serveur Zimbra est configuré pour accepter les connexions en http non sécurisé et que le serveur Funambol est sur la même machine que le serveur Zimbra, il est plus simple de spécifier le protocole http. Par défaut "Zimbra URL" est renseigné avec "https://[hôte]/service/soap/", remplacez [hôte] par le nom d'hôte de la machine ou son adresse ip. Ce nom devra correspondre à l'éventuel certificat du serveur Zimbra pour éviter de futurs tracas.

Laisser "is Task" décoché (sauf pour "stask" et "task", et cliquer sur "Add" pour ajouter la source, et recommencer l'opératoin pour event, scal, stask et task. Notez que ça prend quelques secondes pour que la source soit ajoutée et que, si vous avez fait une erreur, vous pourrez la corriger immédiatement puis cliquer sur "Save".

Saisissez la même chose dans les champs “Source URI” et “Name”, renseignez le champ “Zimbra URL” cochez éventuellement la case “is Task?” et cliquez sur ”Add”

→ Faire de même pour "ContactSyncsource" : double-cliquer sur "zimbra" puis "FunambolZimbraConnector" puis faire un clic droit sur "ContactSyncSource" et choisir "Add sync source" et entrer les données suivantes pour Source URI et Name :

→ card, scard

→ Terminer en faisant de même pour "GALContactSyncSource" : double-cliquer sur "zimbra" puis "FunambolZimbraConnector" puis faire un clic droit sur "GALContactSyncSource" et choisir "Add sync source" et entrer Source URI et Name :"zimbraGalContacts" (avec un z minuscule !)

Le serveur est maintenant configuré, intéressons-nous maintenant aux utilisateurs pour le sécuriser :

→ Double cliquer sur "Users" puis, dans le formulaire de droite, sur "Search" : pour une installation vierge, deux utilisateurs apparaissent : admin et guest. Nous commençons pas supprimer le compte invité :

→ cliquer sur la ligne de "guest" puis cliquer sur "Delete" tout à droite.

→ nous allons changer le mot de passe et l'adresse email du compte administrateur :

→ cliquer sur la ligne du compte "admin"

→ cliquer sur "Edit" à droite, remplissez les champs (ne pas changer le role !!!)

→ cliquer sur "Save" et attendre que "User correctly updated" soit inscrit dans la zone "Output - Messages"

Si vous souhaitez effectuer des vérifications, il vous faudra vous reconnecter avec votre nouveau mot de passe.

Le serveur est maintenant opérationel et sécurisé... il reste encore la question du certificat auto-signé de Zimbra...

6. Utilisation du serveur Funambol avec un certificat Zimbra auto-signé

Si vous n'utilisez pas un certificat émanant d'une "Autorité de Certification" avec votre Zimbra, le serveur Funambol refusera de dialoguer avec ce dernier... et ne synchronisera jamais...

Pour permettre à Funambol de dialoguer avec le serveur Zimbra utilisant un certificat auto-signé, il "suffit" de remplacer la liste de certificats du serveur Funambol par cellle du serveur Zimbra : (remplacer [zimbra] par le chemin d'installation du serveur zimbra, soit, traditionnellemnt /opt/zimbra)

sudo cp [zimbra]/java/jre/lib/security/cacerts [funambol]/ds-server/lib/security

sudo [funambol]/bin/funambol stop ; sudo [funambol]/bin/funambol start

Ainsi, le certificat auto-signé utilisé par le Zimbra sera accepté par le serveur Funambol et la synchronisation pourra se faire en mode sécurisé.

7. Activation du mode HTTPS pour les connexions au serveur Funambol

Envoyer ses logins et mot de passe, en clair, sur un réseau local, passe encore, mais pas sur l'internet. Par défaut, seule la connexion en mode non sécurisé est proposé et le serveur refusera toute connexion tant que le mode https ne sera pas activé.

Pour activer ce mode, Funambol a besoin d'un certificat (faisons-le nous meme), saisir (et remplacer [xxx] par la version de java utilisée... utilisez [Tab] pendant la frappe) :

sudo rm /root/.keystore ; sudo [funambol]/tools/jre-[xxx]/jre/bin/keytool -genkey -alias tomcat -keyalg RSA

et répondez aux questions :

→ Tapez le mot de passe du Keystore : saisissez «changeit» (sans les «»)
→ question 1 : Quels sont vos prénom et nom ? : saisissez ici le nom d'hôte de votre machine (ça correspondra au champ CN du certificat)
→ question 2 à 6 : Quel est le nom de votre unité organisationnelle ? Quelle est le nom de votre organisation ? Quel est le nom de votre ville de résidence ? Quel est le nom de votre état ou province ? Quel est le code de pays à deux lettres pour cette unité ? : répondez ce que vous voulez
→ question 7 : Est-ce CN=[réponse à la question1], OU=[réponse à laquestion2], O=[réponse à la question3], L=[réponse à la question4], ST=[réponse à la question5], C=[réponse à la question6] ? : répondez "oui" en toutes lettres
→ question8 : Spécifiez le mot de passe de la clé pour <tomcat> : pressez la touche [Entrée]

Avant de modifier le fichier de configuration, il convient d'arrêter le serveur via

sudo [funambol]/bin/funambol stop

En suite, décommentez le bloc activant l'https et le port 8443 dans le fichier [funambol]/tools/tomcat/conf/server.xml, c'est à dire, remplacer (vers la ligne 83) :

    <!-- Define a SSL HTTP/1.1 Connector on port 8443
         This connector uses the JSSE configuration, when using APR, the
         connector should be using the OpenSSL style configuration
         described in the APR documentation -->
    <!--
    <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
               maxThreads="150" scheme="https" secure="true"
               clientAuth="false" sslProtocol="TLS" />
    -->

par :

    <!-- Define a SSL HTTP/1.1 Connector on port 8443
         This connector uses the JSSE configuration, when using APR, the
         connector should be using the OpenSSL style configuration
         described in the APR documentation -->
    <!-- uncommented by [votre nom ici] at [date-heure] -->
    <connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
               maxThreads="150" scheme="https" secure="true"
               clientAuth="false" sslProtocol="TLS" />
    <!-- /uncommented by [votre nom ici] at [date-heure] -->

N'oubliez pas de démarrer le serveur Funambol par la suite avec

sudo [funambol]/bin/funambol start

Désormais, vous pourrez vous synchroniser avec Funambol en mode SSL via l'adresse https://[nom d'hôte]:8443/funambol/ds

8. Synchroniser son client

Ici, quel que soit votre client (mobile ou non) il vous faudra utiliser vos informations de connexion à Zimbra, soit votre login complet (utilisateur@domaine) et votre mot de passe.

L'adresse qui vous servira pour vous connecter à votre serveur funambol pour synchroniser est : http://[hôte ou ip]:8080/funambol/ds ou https://[hôte ou ip]:8443/funambol/ds (si vous utilisez une connexion chiffrée).

Si votre client demande qul protocole utiliser, choisissez «HTTP».

Concernant les données, en général, tout est configuré de base, mais dans le doute :

→ cal, event, task et card, servent respectivement de source au calendrier, évènnements, tâches et contacts.

→ scal, stask, et scard servent pour les "slow sync", qui sont des synchronisation complètes (et forcément lentes) et pas simplement la synchronisation des dernières actions depuis la dernière synchro.

→ zimbraGalContacts permet de synchroniser (dans le sens serveur → client seulement) les contacts de la GAL

Pour toute autre question concernant le paramètrage de votre client, veuillez vous reporter à la documentation de ce dernier, puisque ça n'est pas l'objet de ce tuto.

9. Tests et logs

Dans une console, saisissez la commande suivante :

sudo tail -f [funambol]/logs/ds-server/ds-server.log

qui vous permettra de lire les logs en temps réel...

Il est possible de saisir les adresses servant à la synchronisation des clients dans un navigateur web pour vérifier l'état du serveur, le serveur renvoie alors quelque chose du goût de :

Lors d'une synchronisation, vous verrez apparaître, dans les logs, le numéro IMEI du smartphone client ou un identifiant de session, le nom d'utilisateur qu'il utilise, l'adresse qu'il a utilisé pour accéder au serveur Funambol, quel est le script utilisé concernant son terminal, ce qui se passe... en cas de souci : tout s'arrêtera brutalement avec, bien souvent, un (très) long message d'erreur dont Java a le secret.

Vous possédez désormais une suite collaborative performante et pouvant dialoguer avec (presque) n'importe quoi et depuis n'importe où.

10. Lancer - arrêter le serveur funambol

Simplissime :

sudo [funambol]/bin/funambol [start|stop]

Sources

Ce tutoriel a été librement inspiré du tutoriel présent sur le wiki du connecteur zimbra-funambol disponible, en anglais, ici : http://zimbrafunambol.wiki.sourceforge.net/installation-guide.

La documentation de Tomcat 6 http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html

Dernières modifications

Dernière modification majeure : Lundi 21 septembre 2009 : modification suite à la publication de la version 8.0.0 du serveur Funambol et de l'outil d'administration.

Derniers ajouts : ajout de la partie concernant l'outil d'administration pour Mac OS X 10.5 (Leopard), la procédure reste sensiblement la même, le tuto a été raffraîchi pour être plus facilement mis à jour par la suite.

Articles apparentés

• Créer un fichier PID pour Funambol sous GNU/Linux
• Optimiser Apache – Partie 1
• Envoyer les spams aux oubliettes avec Zimbra
• Quelques scripts pour profiter de son scanner sous GNU/Linux
• Configurer vsftpd pour mettre à jour automatiquement Wordpress
• Inclure ses machines virtuelles à son réseau avec VirtualBox
• Pour des sessions SSH qui durent

À ce fléau qu'est la déconnexion intempestive, une solution existe, et elle est très simple : il suffisait de lire le man...

Le client SSH, peut envoyer des paquets "keep-alive" à intervalles réguliers lors de la session. Lorsque le serveur reçoit ces paquets, il sait que, bien que le client ne génère pas d'activité, il faut garder la connexion active. De même, le serveur SSH, peut lui aussi envoyer ces paquets... sauf que, par défaut, ils ne le font pas. Pour les forcer à le faire, il suffit d'éditer les fichiers de configuration du client et/ou du serveur, selon à quoi on a accès et selon ce qu'on veut faire. Le mieux est de se contenter du client lorsque c'est possible, évidement.

Pour activer la fonction coté client, écrire :

Host *
    ServerAliveInterval 60

dans "~/.ssh/config" (créer le fichier au besoin) pour appliquer à son propre utilisateur ou dans "/etc/ssh/ssh_config" pour l'activer sur tout le système, ou alors en en argument de l'option "-o" lors de l'appel à "ssh".

Coté serveur, même chose, mais l'option s'appelle "ClientAliveInterval".

"Host *" activera l'option sur tous les hôtes, mais vous pourriez utiliser un hote spécifique et créer ainsi une règle pour chaque hôte... le "60" indiquant "60 secondes", mais vous pourriez indiquer plus ou moins selon vos besoins.

Articles apparentés

• Configurer vsftpd pour mettre à jour automatiquement Wordpress
• Optimiser Apache – Partie 1
• Créer un fichier PID pour Funambol sous GNU/Linux
• Quelques scripts pour profiter de son scanner sous GNU/Linux
• Inclure ses machines virtuelles à son réseau avec VirtualBox
• Installation de Funambol couplé à Zimbra sur un serveur GNU/Linux