This is an old revision of the document!


Les pré-requis

  • Serveur apache (avec le mod rewrite) + php
  • Qt en version 4.3 minimum (avec les librairies de développement)
  • un nabaztag/tag (ou plusieurs)
  • git (afin de récupérer votre copie du code source)
  • cron (pour tout ce qui est 'périodique': heures, surprises)
  • screen (pour pouvoir surveiller facilement le serveur)

Récupérer les sources

Les sources les plus à jour sont sur GitHub : https://github.com/OpenJabNab/OpenJabNab

git clone https://github.com/OpenJabNab/OpenJabNab.git

Cette commande va récupérer les sources, et créer notamment deux répertoires :

  • server (Il s'agit de tous les fichiers pour le serveur)
  • http-wrapper (Il s'agit des fichiers pour la partie HTTP)

Mettre en place la partie HTTP

Le serveur apache doit être configuré de manière à ce que le répertoire http-wrapper soit la racine du domaine (ou sous-domaine).

Pour cela modifier le /etc/apache2/sites-enabled/000-default de façon à ce que /var/www soit remplacé partout par /var/www/http-wrapper.

Cela doit être fait à 2 lignes normalement :

  • DocumentRoot /var/www/http-wrapper
  • <Directory /var/www/http-wrapper/>

Il faut aussi retirer les AllowOverride none qui se trouvent dans le fichier de config. Ces derniers bloqueraient l'.htaccess nécessaire au bon fonctionnement de l'url rewriting

Attention à la gestion des droits des fichiers sur certains systèmes d'exploitation.
  • Il faut que l'utilisateur système qui lance le serveur web (le plus souvent www-data) puisse lire et écrire des fichiers dans le répertoire http-wrapper
  • L'utilisateur qui lance le openjabnab doit pouvoir écrire dans le dossier http-wrapper/ojn_local/

Compiler le serveur openJabNab

Se déplacer dans le répertoire “server”.

cd <path to sources>/OpenJabNab/server

Générer les fichiers Makefile avec la commande “qmake -r” Lancer la compilation (make)

qmake -r
make

Pour les utilisateurs sous Windows, il sera peut-être nécessaire de modifier les fichiers .pro créés, en remplaçant

win32{
QMAKE_CXXFLAGS_WARN_ON += -WX
}

par

win32{
QMAKE_CXXFLAGS_WARN_ON += -Wextra
}

Copier le fichier openjabnab.ini-dist dans le répertoire bin, et le renommer en openjabnab.ini

cp openjabnab.ini-dist bin/openjabnab.ini

Editer ce fichier, et remplacer les 3 lignes comportant “my.domain.com” avec votre domaine/IP

Choisir le mode d'authentification voulue (en fonction du mode standalone ou proxy) dans le fichier bin/plugins/plugin_auth.ini

Mode proxy
  • proxy
Mode standalone
  • full
  • patched

Lancer l'exécutable “openjabnab” créé dans le répertoire bin

./bin/openjabnab

Utilisation du serveur

Configurer le nabaztag/tag 1) pour qu'il utilise le domaine/IP que vous avez défini plus haut : “my.domain.com/vl” à la place de r.nabaztag.com/vl (dans les paramètres avancés - Advanced settings (tout en bas de la page de configuration))

Enregistrer la configuration pour relancer le lapin.

1)
le brancher en appuyant sur le bouton au dessus de la tête jusqu'à ce que les lumières soient bleues