ezPAARSE se présente sous la forme d'un Web service dans lequel vous pouvez injecter vos logs et récupérer les évènements de consultation correspondants. Cette procédure décrit comment installer ezPAARSE sur votre serveur.
Voici les outils dont vous avez besoin pour faire fonctionner ezPAARSE :
- Système d'exploitation Linux : voir les pré-requis par systèmes
- Outils standards Linux : bash, make, grep, sed ...
- curl (utilisé par nvm)
- git >= 1.7.10 (pour être compatible avec github)
ezPAARSE embarque tous les éléments nécessaires à son fonctionnement. Lorsque les pré-requis sont remplis, le lancement de la commande make (voir ci-dessous) réalise toutes les opérations d'installation.
Remarque : nous préconiserons prochainement un dimensionnement pour le serveur au niveau du CPU et de la RAM. Pour cela, nous attendons de pouvoir disposer d'un panel de parseurs plus complet pour pouvoir lancer des benchmarks et en déduire des préconisations matérielles.
Si vous souhaitez installer une version stable téléchargez une archives zip ou tar.gz puis ouvrez un terminal et tapez :
unzip ezpaarse-X.X.X.zip
cd ezpaarse-X.X.X
make
Si vous souhaitez installer la version de développement, ouvrez un terminal et tapez :
git clone http://github.com/ezpaarse-project/ezpaarse.git
cd ezpaarse
make
Vous avez également la possibilité de télécharger une archives deb et de l'installer sur votre système de cette façon :
sudo -E dpkg -i ezpaarse-X.X.X.deb
sudo /etc/init.d/ezpaarse start
Cette étape vous permettra de valider que votre installation est fonctionnelle.
make start
make test
Des fichiers de logs exemple et anonymisés sont disponibles dans les répertoires d'ezPAARSE.
Vous devez tout d'abord vous assurer qu'ezPAARSE est démarré en lançant la commande suivante :
make start
Un client HTTP (ici curl) peut envoyer un fichier de données de log (ici ./test/dataset/sd.2012-11-30.300.log) sur le Web service d'ezPAARSE et obtenir en réponse un flux CSV d'événements de consultation.
curl -X POST http://127.0.0.1:59599 \
-v --proxy "" --no-buffer \
--data-binary @./test/dataset/sd.2012-11-30.300.log
Alternativement, vous pouvez également utiliser la commande ./bin/loginjector
fournie par ezPAARSE
pour injecter encore plus simplement le fichier de log dans ezPAARSE :
cat ./test/dataset/sd.2012-11-30.300.log | ./bin/loginjector
Et enchainer en utilisant la commande ./bin/csvtotalizer
fournie par ezPAARSE
pour avoir un aperçu des événements de consultation reconnus par ezPAARSE :
cat ./test/dataset/sd.2012-11-30.300.log | ./bin/loginjector | ./bin/csvtotalizer
- Le port d'écoute du Web service d'ezPAARSE peut être réglé en modifiant la variable
EZPAARSE_NODEJS_PORT
dans le fichierconfig.json
(par défaut 59599)