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
- 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.